Question 1

How to automatically increment build number in Xcode?

Accepted Answer

Use the BuildVersion.sh script by adding it as a run script build phase in Xcode. It reads the current build number from Info.plist, increments it on each build, and writes it back. Always backup your plist files first to avoid data loss.

Question 2

Awesome Xcode scripts vs Fastlane for versioning?

Accepted Answer

Awesome Xcode scripts are lightweight, shell-based solutions integrated directly into Xcode, ideal for simple, quick automation. Fastlane is a more comprehensive toolchain with broader CI/CD features, better suited for complex workflows and team collaboration across platforms.

Question 3

Can I use these scripts with Swift Package Manager?

Accepted Answer

These scripts are designed for Xcode projects and may not directly integrate with Swift Package Manager's build system. You might need to adapt them manually or use SPM's own scripting hooks, which could require additional setup.

Question 4

How to add version overlay to app icon in Xcode?

Accepted Answer

Use the IconVersioning.sh script in a run script build phase. It overlays the app version onto icon assets during the build process, which is useful for beta testing to visually distinguish between versions without manual editing.

Question 5

Are these scripts safe for production use?

Accepted Answer

Yes, they are curated from community contributions and have been tested in various projects. However, always test in a staging environment first, especially scripts like the Git commit trigger, to prevent unexpected build number increments in production builds.

Question 6

How to detect TODO tags in Swift code automatically?

Accepted Answer

Use the DetectFixMeToDoSwift.sh script in a build phase—it scans Swift files for TODO and FIXME tags and outputs warnings during compilation, helping teams enforce code quality by highlighting pending tasks without manual reviews.

awesome-xcode-scripts

What is awesome-xcode-scripts?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions