{"id":20187440,"url":"https://github.com/bitrise-steplib/steps-set-xcode-build-number","last_synced_at":"2025-08-20T07:12:30.058Z","repository":{"id":46570777,"uuid":"42999149","full_name":"bitrise-steplib/steps-set-xcode-build-number","owner":"bitrise-steplib","description":"Sets the Build Number to the specified value in the Info.plist file for the next build","archived":false,"fork":false,"pushed_at":"2024-12-16T13:05:59.000Z","size":1187,"stargazers_count":7,"open_issues_count":3,"forks_count":10,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-10T06:46:40.464Z","etag":null,"topics":["bitrise","bitrise-step","ci","hacktoberfest","production-code"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitrise-steplib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-23T12:22:03.000Z","updated_at":"2024-08-28T11:44:28.000Z","dependencies_parsed_at":"2024-01-08T14:55:22.854Z","dependency_job_id":"ecf66556-a0e0-4f76-b761-6332fef38694","html_url":"https://github.com/bitrise-steplib/steps-set-xcode-build-number","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/bitrise-steplib/steps-set-xcode-build-number","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-set-xcode-build-number","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-set-xcode-build-number/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-set-xcode-build-number/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-set-xcode-build-number/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitrise-steplib","download_url":"https://codeload.github.com/bitrise-steplib/steps-set-xcode-build-number/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-set-xcode-build-number/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271280834,"owners_count":24732082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitrise","bitrise-step","ci","hacktoberfest","production-code"],"created_at":"2024-11-14T03:23:48.866Z","updated_at":"2025-08-20T07:12:30.034Z","avatar_url":"https://github.com/bitrise-steplib.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Set Xcode Project Build Number\n\n[![Step changelog](https://shields.io/github/v/release/bitrise-io/set-xcode-build-number?include_prereleases\u0026label=changelog\u0026color=blueviolet)](https://github.com/bitrise-io/set-xcode-build-number/releases)\n\nSet the value of your iOS app's build number to the specified version number.\n\n\u003cdetails\u003e\n\u003csummary\u003eDescription\u003c/summary\u003e\n\nSet the value of your iOS app's build number to the specified version number. A great way to keep track of versions \nwhen submitting bug reports.\n\nIf your IPA contains multiple build targets, they need to have the same version number as your app's main target has.\nIn that case, you need to add this Step to your Workflow for each build target: if you have, say, three targets, you need to have three instances of this Step in your Workflow.\nIf there are targets with different version numbers the app cannot be submitted for App Review or Beta App Review.\n\n### Configuring the Step \n\nThe step can handle if versions numbers are specified in the project file (default configuration since Xcode 13) and the old style\nwhere the version numbers appear in the **Info.plist** file. It can automatically detect which style is used and act accordingly.\n\nFor the simple projects you do not need to do anything because the step uses the previously defined $BITRISE_PROJECT_PATH\nand $BITRISE_SCHEME env vars to detect the target settings.\n\nFor better customisation the step can be also instructed to look for a specific target and even for specific target configurations\nto update the version numbers.\n\n### Useful links \n\n- [Build numbering and app versioning](https://devcenter.bitrise.io/builds/build-numbering-and-app-versioning/#setting-the-cfbundleversion-and-cfbundleshortversionstring-of-an-ios-app)\n- [Current Project Version in Apple documentation](https://developer.apple.com/documentation/xcode/build-settings-reference#Current-Project-Version)\n- [Marketing Version in Apple documentation](https://developer.apple.com/documentation/xcode/build-settings-reference#Marketing-Version)\n- [CFBundleversion in Apple documentation](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleversion)\n\n### Related Steps \n\n- [Xcode Archive \u0026 Export for iOS](https://www.bitrise.io/integrations/steps/xcode-archive)\n- [Set Android Manifest Version Code and Name](https://www.bitrise.io/integrations/steps/set-android-manifest-versions)\n\u003c/details\u003e\n\n## 🧩 Get started\n\nAdd this step directly to your workflow in the [Bitrise Workflow Editor](https://devcenter.bitrise.io/steps-and-workflows/steps-and-workflows-index/).\n\nYou can also run this step directly with [Bitrise CLI](https://github.com/bitrise-io/bitrise).\n\n## ⚙️ Configuration\n\n\u003cdetails\u003e\n\u003csummary\u003eInputs\u003c/summary\u003e\n\n| Key | Description | Flags | Default |\n| --- | --- | --- | --- |\n| `project_path` | Xcode Project (`.xcodeproj`) or Workspace (`.xcworkspace`) path. | required | `$BITRISE_PROJECT_PATH` |\n| `scheme` | Xcode Scheme name. | required | `$BITRISE_SCHEME` |\n| `target` | Xcode Target name.  It is optional and if specified then the step will find the given target and update the version numbers for it.   If it is left empty then the step will use the scheme's default target to update the version numbers. |  |  |\n| `configuration` | Xcode Configuration name.  It is optional and if specified then the step will only update the configuration with the given name.   If it is left empty then the step will update all of the target's configurations with the build and version number. |  |  |\n| `build_version` | This will be either the CFBundleVersion in the Info.plist file or the CURRENT_PROJECT_VERSION in the project file. | required | `$BITRISE_BUILD_NUMBER` |\n| `build_version_offset` | This offset will be added to `build_version` input's value. It must be a positive number. |  |  |\n| `build_short_version_string` | This will be either the CFBundleShortVersionString in the Info.plist file or the MARKETING_VERSION in the project file.  If it is empty then the step will not modify the existing value. |  |  |\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOutputs\u003c/summary\u003e\n\n| Environment Variable | Description |\n| --- | --- |\n| `XCODE_BUNDLE_VERSION` | The bundle version used in either in Info.plist or project file |\n\u003c/details\u003e\n\n## 🙋 Contributing\n\nWe welcome [pull requests](https://github.com/bitrise-io/set-xcode-build-number/pulls) and [issues](https://github.com/bitrise-io/set-xcode-build-number/issues) against this repository.\n\nFor pull requests, work on your changes in a forked repository and use the Bitrise CLI to [run step tests locally](https://devcenter.bitrise.io/bitrise-cli/run-your-first-build/).\n\nLearn more about developing steps:\n\n- [Create your own step](https://devcenter.bitrise.io/contributors/create-your-own-step/)\n- [Testing your Step](https://devcenter.bitrise.io/contributors/testing-and-versioning-your-steps/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrise-steplib%2Fsteps-set-xcode-build-number","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitrise-steplib%2Fsteps-set-xcode-build-number","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrise-steplib%2Fsteps-set-xcode-build-number/lists"}