Awesome Xcode Scripts

A curated list of useful Xcode scripts 📝.

Content

• How to Setup
• Scripts
  • Build Number Auto-Increment Script
  • Build Number Auto-Increment Script on Git Commit
  • Semantic Version Auto-Increment Script
  • AppIcon Versioning Auto-Increment Script
  • Detect FixMe ToDo Error Tag on Swift Script
• Installation
• Contributing
• Credits
• License

How to Setup

• Open Xcode project. Select your target
• Build Phases -> Add Build Phase -> Add Run Script Build Phase
• Open "Run Script" section that was created and .
• Copy & Paste your script there.
• (Optional) Rename your Run Scripts to identify them easily.

Scripts

Build Number Auto-Increment Script

• BuildVersion.sh - A script that runs each time you build your app in Xcode to read the Build number, increment it, and write it back to the app's {App}-Info.plist file.

Build Number Auto-Increment Script on Git Commit

• BuildNumberOnGitCommit.sh - A script that runs each time you commit your app to git, the Build number gets incremented.

CAUTION

Use this only if you are pushing you code to git.

Semantic Version Auto-Increment Script

• VersionNumberIncrement.sh - Auto-increment the version number (only) when a project is archived for export.

CAUTION

Insure your starting version number is in SemVer format (e.g. 1.0.0)

AppIcon Versioning Auto-Increment Script

• IconVersioning.sh - Overlay the iOS application version on top of the icon.

Detect FixMe ToDo Error Tag On Swift Script

• DetectFixMeToDoSwift.sh

Installation

1. Download the zip or clone the repo to your desired directory.

$ git clone https://github.com/aashishtamsya/awesome-xcode-scripts.git

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request 😉 😊

Credits

• Build Number Auto-Increment Script

  • Jason Horwitz

• Build Number Auto-Increment Script on Git Commit

  • Jared Sinclair

• Semantic Version Auto-Increment Script

  • Jason Horwitz

• AppIcon Versioning Auto-Increment Script

  • Inspired by @merowing and @bejo script, who were inspired initially by Evan Doll's talk

Aashish Tamsya @ChiefAashish, [email protected]

License

The content of Awesome Xcode Scripts itself is licensed under the Creative Commons Attribution 3.0 license, and the underlying source code used to format and display that content is licensed under the MIT license.

See the LICENSE file for more info.