Understanding Version and Build Fields in Xcode

Understanding Version and Build Fields in Xcode

28 February 2025 Stephan Petzl Leave a comment Xcode

When working with Xcode, particularly when transitioning from older versions, developers often encounter confusion regarding the Version and Build fields. This guide aims to clarify the differences and provide practical steps for managing these fields effectively.

Version vs. Build: Key Differences

  • Version (CFBundleShortVersionString): This is the user-facing number, typically following a Major.Minor version scheme. It communicates the release of new features or significant updates to users.
  • Build (CFBundleVersion): An internal number indicating the current state of the app. It is primarily used for internal tracking and version control, often incremented with each build.

Why Is the Version Field Blank?

Upon upgrading to a newer version of Xcode, such as from Xcode 3 to Xcode 4, you might notice the Version field being blank. This is due to changes in how Xcode manages these fields. You can manually set these fields in the Info tab of your Application Target by adding CFBundleShortVersionString for Version and CFBundleVersion for Build.

Managing Build Numbers

Maintaining accurate build numbers is crucial for version control and debugging. Here’s a simple script to auto-increment the build number each time you build your app:

#!/bin/bash
buildNumber=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "$INFOPLIST_FILE")
buildNumber=$(($buildNumber + 1))
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$INFOPLIST_FILE"

Place this script in the Run Script phase of your project settings to ensure the build number updates with each build.

Using Apple Generic Versioning Tool (agvtool)

For more advanced versioning, Apple provides agvtool, which allows you to manage build numbers and marketing versions efficiently. This tool is especially useful for automated builds and continuous integration processes.

Integrating Repeato for Automated Testing

Managing version and build numbers is just one aspect of app development. To ensure your app maintains high quality across versions, consider integrating automated testing into your workflow. Repeato offers a no-code test automation tool that simplifies creating and maintaining tests for iOS, Android, and web applications. With features like data-driven testing and the ability to run command line scripts, Repeato complements your development process by ensuring that each build meets quality standards before release.

For more on how Repeato can enhance your testing process, visit our getting started guide.

Check it out!

Like this article? there’s more where that came from!

Repeato

Documentation

Support

Legal

Repeato Reviews