NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3884 most downloaded on PyPI
CLI tools used in Codemagic builds
Latest stable
0.70.2
Last release 24 days ago
29 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
89 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Do not fail to load provisioning profiles from App Store Connect API that have no profileContent attribute. Apple omits it for some old expired profil
Bugfixes
profileContent attribute. Apple omits it for some old expired profiles, which crashed for example app-store-connect bundle-ids profiles with TypeError.
app-store-connect profiles list, app-store-connect profiles get and app-store-connect bundle-ids profiles skip saving such profiles with a warning when --save is given.app-store-connect fetch-signing-files does not consider such profiles usable, so a new profile is created if --create is given and otherwise the action fails.Development
profileContent optional on Profile resource. Property Profile.profile_content raises ValueError if the profile has no content.has_profile_content to Profile resource.profileVersion to Profile resource.Fix successful App Store Connect uploads being reported as failed when altool also logs an ERROR: line, as Xcode 27 does with Failed to create URL for
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Bugfixes
altool also logs an ERROR: line, as Xcode 27 does with Failed to create URL for 'CDUploaderStateInfoResumeFilePath'. The UPLOAD SUCCEEDED check only looked at the start of the output, so it missed the message on a later line. Affects app-store-connect publish.Some of the changes to Python API are backwards incompatible.
This release drops support for parsing XcResult bundles with xcresulttool from Xcode versions older than 16.0. Some of the changes to Python API are backwards incompatible.
Xcode 16.0 or newer is required to convert XcResult bundles to JUnit test reports. This affects xcode-project actions run-tests, test-summary and junit-test-results.
Development
LegacyXcResultConverter from codemagic.models.xctests.converter.codemagic.models.xctests.xcresult.legacy_xcresult along with all of its definitions (ActionsInvocationRecord etc.) that were also exported from packages codemagic.models.xctests.xcresult and codemagic.models.xctests.is_legacy, get_bundle and get_object from XcResultTool.Xcode16XcResultConverter into XcResultConverter.Support Expected Failure and Skip Message test node types for XCTest results which were added in xcresulttool test-results schema 0.2.0 (default on Xc
Bugfixes
Expected Failure and Skip Message test node types for XCTest results which were added in xcresulttool test-results schema 0.2.0 (default on Xcode 27). Fixes actions
xcode-project run-tests,xcode-project test-summary,xcode-project junit-test-results.
Also restore skip messages in JUnit output when Apple emits Skip Message children instead of Failure Message with result Skipped.XCTExpectFailure reason text in JUnit <system-out> for test cases with expected failures, including failed test cases that also have expected failures.Fix firebase-app-distribution actions get-latest-build-version and releases list. The Firebase App Distribution API changed orderBy query parameter va
Bugfixes
firebase-app-distribution actions get-latest-build-version and releases list. The Firebase App Distribution API changed orderBy query parameter validation and rejects the previously tolerated createTimeDesc, requiring the documented space-separated grammar createTime desc instead.Apple documents it as a valid certificate type again after it had been temporarily deprecated in version 0.59.0. This re-enables app-store-connect cer…
Features
DEVELOPER_ID_APPLICATION_G2 in codemagic.apple.resources.CertificateType. Apple documents it as a valid certificate type again after it had been temporarily deprecated in version 0.59.0. This re-enables app-store-connect certificates create and app-store-connect certificates list invoked with --type=DEVELOPER_ID_APPLICATION_G2, as well as macOS direct distribution signing flows invoked with --profile-type=MAC_APP_DIRECT or --profile-type=MAC_CATALYST_APP_DIRECT.Docs
app-store-connect certificates create.app-store-connect certificates list.Add --all-versions flag to app-store-connect get-latest-build-number, get-latest-app-store-build-number, and get-latest-testflight-build-number. When
Features
--all-versions flag to app-store-connect get-latest-build-number, get-latest-app-store-build-number, and get-latest-testflight-build-number. When set, scans across every version and returns the globally highest build number found, instead of returning the build of the highest version. Useful for hot-fix flows where a lower marketing version may carry a higher build number. Resolves issue #320.Docs
app-store-connect get-latest-build-number.app-store-connect get-latest-app-store-build-number.app-store-connect get-latest-testflight-build-number.Add --version-string argument to app-store-connect get-latest-build-number to pin the build number lookup to a specific version string across both App
Features
--version-string argument to app-store-connect get-latest-build-number to pin the build number lookup to a specific version string across both App Store and TestFlight. Resolves part of issue #320.--pre-release-version argument can now also be specified using --version-string for consistency with --app-store-version.app-store-connect get-latest-build-number to compare build numbers when App Store and TestFlight expose the same version string, instead of always preferring TestFlight.Docs
app-store-connect get-latest-build-number.app-store-connect get-latest-testflight-build-number.app-store-connect builds list.app-store-connect apps builds.Add 11 new App Store Connect locales from Apple's March 2026 expansion: Bangla (bn-BD), Gujarati (gu-IN), Kannada (kn-IN), Malayalam (ml-IN), Marathi
Features
bn-BD), Gujarati (gu-IN), Kannada (kn-IN), Malayalam (ml-IN), Marathi (mr-IN), Odia (or-IN), Punjabi (pa-IN), Slovenian (sl-SI), Tamil (ta-IN), Telugu (te-IN), Urdu (ur-PK). Total supported locales: 50.Docs
--locale argument options for app-store-connect app-store-versions localizations.--locale argument options for app-store-connect beta-build-localizations create.--locale argument options for app-store-connect beta-build-localizations list.--locale argument options for app-store-connect builds add-beta-test-info.--locale argument options for app-store-connect builds submit-to-app-store.--locale argument options for app-store-connect publish.This release contains changes from PR #489.
This release contains changes from PR #489.
Features
app-store-connect to be consistent with Xcode 16.0+. This changes where downloaded signing files are saved by default.
--certificates-dir defaults now to ~/Library/Developer/Xcode/UserData/Certificates.--profiles-dir defaults now to ~/Library/Developer/Xcode/UserData/Provisioning Profiles.keychain add-certificates argument --certificate to look up certificates from ~/Library/Developer/Xcode/UserData/Certificates. Old certificates location remains also included in the default glob patterns.xcode-project use-profiles argument --profile to look up provisioning profiles from ~/Library/Developer/Xcode/UserData/Provisioning Profiles. by default. Old certificates location remains also included in the default glob patterns.Docs
app-store-connect.keychain add-certificates.xcode-project use-profiles.This is a development release that contains changes from PR #486 and PR #487. There are no functional changes for the package end-users.
This is a development release that contains changes from PR #486 and PR #487. There are no functional changes for the package end-users.
Development
uv instead of poetry.Dependencies
black from dev dependencies.Do not require deprecated `ageRatingDeclaration` relationship for codemagic.apple.resources.AppStoreVersion.
This release contains changes from PR #481.
Bugfixes
ageRatingDeclaration relationship for codemagic.apple.resources.AppStoreVersion.Development
AppVersionState] enumeration for App Store Connect resources and use it on AppStoreVersion resource.usesIdfa and appStoreState optional on AppStoreVersion resource.This release contains changes from PR #478.
This release contains changes from PR #478.
Bugfixes
app-store-connect publish action when altool fails with errors but successful returncode.altool result from command output if the JSON-encoded result spans multiple lines.Development
codemagic.models.altool.AltoolResult to match recent output from recent altool versions.This release contains changes from PR #477.
This release contains changes from PR #477.
Bugfixes
Runtime Warning test node type for XCTest results which was added by Xcode 26. Fixes actions
xcode-project run-tests,xcode-project test-summary,xcode-project junit-test-results.Development
xcode_16_xcresult to xcresult in package codemagic.models.xctest.xcresult.This release contains changes from PR #476.
This release contains changes from PR #476.
Features
--altool-additional-arguments option to the app-store-connect publish action. This allows passing extra CLI arguments directly to altool during the app upload process.Docs
app-store-connect publish.Fix TypeError in firebase-app-distribution actions if Firebase release response is missing displayVersion attribute. PR #474
Bugfixes
TypeError in firebase-app-distribution actions if Firebase release response is missing displayVersion attribute. PR #474Fix action firebase-app-distribution get-latest-build-version by supporting new updateTime and expireTime timestamps for releases. PR #473
Bugfixes
firebase-app-distribution get-latest-build-version by supporting new updateTime and expireTime timestamps for releases. PR #473This release contains changes from PR #469.
This release contains changes from PR #469.
Features
--delete-stale-profiles to action app-store-connect fetch-signing-files to delete encountered stale provisioning profiles. Those profiles are not shown in Apple Developer Portal and cannot be queried using normal App Store Connect API profiles read and listing endpoints.Docs
app-store-connect fetch-signing-files.Fix --type argument for google-play deobfuscation-files upload. PR #470
Bugfix
--type argument for google-play deobfuscation-files upload. PR #470This release contains changes from PR #467.
This release contains changes from PR #467.
Breaking
DEVELOPER_ID_APPLICATION_G2 is removed from codemagic.apple.resources.CertificateType.Bugfixes
app-store-connect fetch-signing-files when fetching signing files for macOS apps that use direct distribution provisioning profiles (invoked with either option --type=MAC_APP_DIRECT or --type=MAC_CATALYST_APP_DIRECT).app-store-connect certificates list when listing certificates for macOS direct distribution provisioning profiles or explicitly with type DEVELOPER_ID_APPLICATION_G2 (either invoked with --profile-type=MAC_APP_DIRECT, --profile-type=MAC_CATALYST_APP_DIRECT or --type=DEVELOPER_ID_APPLICATION_G2).app-store-connect certificates create when invoked with --type=DEVELOPER_ID_APPLICATION_G2.Docs
app-store-connect certificates create.app-store-connect certificates list.Fix parsing datetime in Apple API response that contains nanoseconds. PR #465.
Add missing App Store Connect locale definition for Vietnamese language. PR #466
Fix google-play apks publish and google-play apks upload actions on Windows. PR #463.
google-play apks publish and google-play apks upload actions on Windows. PR #463.Action android-app-bundle bundletool-version was deprecated and shows a warning message when invoked. It is replaced by android-app-bundle bundletool…
This release contains changes from PR #461.
Features
android-app-bundle via --bundletool argument.android-app-bundle bundletool info to show information about used Bundletool (Java runtime, Bundletool path and Bundletool version).Deprecations
android-app-bundle bundletool-version was deprecated and shows a warning message when invoked. It is replaced by android-app-bundle bundletool version.Development
codemagic.shell_tools.Bundletool now accepts optional keyword argument jar to specify bundletool jar path that should be used.Bugfixes
Docs
android-app-bundle.Fix empty release notes text usage for Google Play release tracks. PR #462
Fix socket timeouts on google-play actions. PR #460
Bugfixes
google-play actions. PR #460Use retrying for Google API requests to avoid intermittent timeout errors. PR #456
Bugfixes
AabPackage.get_summary and ApkPackage.get_summary methods for cases when certificate contained unexpected issuer and subject attributes. PR #457Fix available commands listings in terminal help messages for tools with hidden deprecated actions.
This release contains changes from PR #455
Features
codemagic-cli-tools ensure-androguard to pre-install androguard dependency that is required for working with APK files.Bugfixes
ValueError when initializing more than one ApkPackage instances using Python APIs.Development
Fix Python API for AppStoreConnect.submit_to_app_store for macOS applications when platform was specified only via version info and not directly as me
Bugfixes
AppStoreConnect.submit_to_app_store for macOS applications when platform was specified only via version info and not directly as method argument. PR #453Fix submitting uploaded application to App Store when running action app-store-connect publish using --app-store flag. PR #452
Bugfixes
app-store-connect publish using --app-store flag. PR #452Fix action android-app-bundle sign when invoked with keystore arguments. PR #449
Bugfixes
android-app-bundle sign when invoked with keystore arguments. PR #449Make `androguard` Python dependency optional and install it during runtime when it is needed. PR #448
Dependencies
androguard Python dependency optional and install it during runtime when it is needed. PR #448Fix actions android-app-bundle build-apks and android-app-bundle build-universal-apk when invoked with keystore arguments. PR #447
Bugfixes
android-app-bundle build-apks and android-app-bundle build-universal-apk when invoked with keystore arguments. PR #447This release contains changes from PR #446 and adds new features to tool google-play to manage Google Play releases and application uploads.
This release contains changes from PR #446 and adds new features to tool google-play to manage Google Play releases and application uploads.
Features
android-app-bundle dump to be fully compatible with Bundletool dump options.google-play:
google-play apks list to list uploaded APKs,google-play apks upload to upload new APK,google-play bundles list to list uploaded App Bundles,google-play bundles publish to publish App Bundle as a new release,google-play bundles upload to upload new App Bundle,google-play deobfuscation-files upload to upload new deobfuscation file for an APK,google-play expansion-files reference to reference existing expansion file for an APK,google-play expansion-files upload to upload new expansion file for an APK,google-play internal-app-sharing upload-apk to upload an APK for internal app sharing,google-play internal-app-sharing upload-bundle to upload an App Bundle for internal app sharing,google-play internal-app-sharing upload to upload either an APK or App Bundle for internal app sharing,google-play tracks set-release to set latest release for a track.Dependencies
androguard to work with APK files.Development
AabPackage and ApkPackage classes to codemagic.models.application_package to gather meta information from Android App Bundles and APKs.codemagic.google.services.google_play along with relevant resource definitions:
ApksService to interact with edits.apks in Google Play Developer API.BundlesService to interact with edits.bundles in Google Play Developer API.DeobfuscationFilesService to interact with edits.deobfuscationfiles in Google Play Developer API.ExpansionFilesService to interact with edits.expansionfiles in Google Play Developer API.InternalAppSharingArtifactsService to interact with internalappsharingartifacts in Google Play Developer API.jarsigner and bundletool calls from AndroidAppBundle class into standalone shell tool implementations in codemagic.shell_tools.Documentation
android-app-bundle dump,google-play tracks promote-release.google-play apks,google-play bundles,google-play deobfuscation-files,google-play expansion-files,google-play internal-app-sharing.google-play apks list,google-play apks publish,google-play apks upload,google-play bundles list,google-play bundles publish,google-play bundles upload,google-play deobfuscation-files upload,google-play expansion-files reference,google-play expansion-files upload,google-play internal-app-sharing upload-apk,google-play internal-app-sharing upload-bundle,google-play internal-app-sharing upload,google-play tracks set-release.Some of the changes to Python API are backwards incompatible.
This release contains changes from PR #442, PR #443 and PR #444. The aim of this release is to unify Firebase and Google Play API clients to use the same modular resource management architecture with shared authentication backend.
Some of the changes to Python API are backwards incompatible.
Deprecations
GCLOUD_SERVICE_ACCOUNT_CREDENTIALS is deprecated in favor of GOOGLE_PLAY_SERVICE_ACCOUNT_CREDENTIALS to specify Google Play service account key for google-play instead of explicitly passing --credentials. A warning message is shown if deprecated environment variable is used.Documentation
README.md.Development
GooglePlayDeveloperAPIClient and whole codemagic.google_play package.codemagic.google.GooglePlayClient.codemagic.google.resource_managers to codemagic.google.services.codemagic.apple.resources.DictSerializable and codemagic.google_play.resources.resource.DictSerializable into reusable codemagic.models.DictSerializable.black, mypy and ruff development dependencies.black and ruff versions.psutil package and re module.types-psutil.Breaking: Deprecate Python 3.7, and Python 3.8 is now the minimum version of Python required.
Changes in this release are from PR #441.
Development
cffi version to be compatible with latest version.Fix team_identifier property on codemagic.models.ProvisioningProfile to always return a string as the type hint suggests. PR #440
Bugfixes
team_identifier property on codemagic.models.ProvisioningProfile to always return a string as the type hint suggests. PR #440Make undocumented preOrder and deprecated inAppPurchases relationships on App Store connect App model optional . PR #439
Bugfixes
APPLE_SILICON_MAC on App Store Connect API Device responses. PR #437preOrder and deprecated inAppPurchases relationships on App Store connect App model optional . PR #439Improvements
app-store-connect fetch-signing-files early with descriptive error message if bundle ID identifier is not given. PR #438Fix action keychain add-certificates for macOS 15.1 when adding certificates with empty password. PR #436
Fix testcase duration parsing from XCResult bundle when using Xcode 16.0+. PR #433
Bugfixes
XCResult bundle when using Xcode 16.0+. PR #433This release contains changes from PR #431
This release contains changes from PR #431
Features
xcresulttool APIs for XcResult parsing when Xcode 16+ is selected. Applies to xcode-project actions run-tests, test-summary and junit-test-results.Bugfixes
failures and errors attributes from JUnit <testsuites> in case none of the child <testsuite> elements specify those values instead of setting them to 0.Development
Xcode16XcResultConverter.XcResultConverter to LegacyXcResultConverter.XcResultConverter which automatically chooses correct implementation.codemagic.models.xctest.xcresult to a package and move its contents to submodule legacy_xcresult. All public definitions remain accessible using the old namespace.xcode_16_xcresult to package codemagic.models.xctest.xcresult.get_tool_version from XcResultTool.is_legacy, get_test_report_summary and get_test_report_tests to XcResultTool.XcResultTool methods get_object and get_bundle when Xcode 16 or newer is selected.Change release pipeline not to include source distributions in PyPI releases. Those are still available from GitHub. PR #429
Development
Fix saving Apple code signing certificates to disk when using LibreSSL 3.0.0+. PR #427
Bugfixes
Update tool app-store-connect to support all Apple's locales. PR #425
Features
Bugfixes
Docs
app-store-connect app-store-versions localizations,app-store-connect beta-build-localizations create,app-store-connect beta-build-localizations list,app-store-connect builds add-beta-test-info,app-store-connect builds submit-to-app-store,app-store-connect publish.The argument --project-id has been deprecated in favor of --project-number on all actions of the tool firebase-app-distribution to be compliant with t…
This release contains changes from PR #421 and PR #422
Development
Deprecations
The argument --project-id has been deprecated in favor of --project-number on all actions
of the tool firebase-app-distribution to be compliant with the Firebase documentation.
A warning message is shown if commands are invoked with the deprecated argument.
This is a bugfix version containing changes from PR #424 to fix test result parsing with Xcode 16.0 beta 3+.
This is a bugfix version containing changes from PR #424 to fix test result parsing with Xcode 16.0 beta 3+.
Bugfixes
xcode-project run-tests,xcode-project test-summary,xcode-project junit-test-results.Development
get_tool_version method to codemagic.models.xctests.XcResultTool which can be used to detect xcresulttool version from currently active Xcode developer directory.This release contains changes from PR #415.
This release contains changes from PR #415.
Bugfixes
DEVELOPER_ID_APPLICATION_G2 for app-store-connect.Development
ruff settings to be compatible with latest version.pre-commit hook versions.This is a bugfix release to resolve a regression that was introduced in version 0.53.1. PR #413
This is a bugfix release to resolve a regression that was introduced in version 0.53.1. PR #413
Bugfixes
This bugfix release contains changes from PR #411.
This bugfix release contains changes from PR #411.
Bugfixes
Dependencies:
>= 38.0.0 to cryptography dependency.Update action app-store-connect publish to allow adding builds to beta groups without submitting to TestFlight. PR #410
Feature
app-store-connect publish to allow adding builds to beta groups without submitting to TestFlight. PR #410Add optional argument --platform to action app-store-connect apps builds to list builds only for selected platform. PR #407
Feature
--platform to action app-store-connect apps builds to list builds only for selected platform. PR #407--platform to action app-store-connect builds list to list builds only for selected platform. PR #407--platform to action app-store-connect apps expire-build-submitted-for-review to expire builds only for specified platform. PR #407Bugfixes
app-store-connect publish will only expire builds for the same platform that is being published when invoked with option --expire-build-submitted-for-review. PR #407--credentials validation for tool google-play. PR #406Documentation
app-store-connect apps builds,app-store-connect apps expire-build-submitted-for-review,app-store-connect builds list.This is a bugfix release containing changes from PR #405. Apple removed idfaDeclaration key from the data structure that represents App Store Version
This is a bugfix release containing changes from PR #405. Apple removed idfaDeclaration key from the data structure that represents App Store Version resources, which caused failures in App Store Connect client methods. Consequently, CLI actions started to fail.
Bugfixes
app-store-connect app-store-versions create,app-store-connect app-store-versions update,app-store-connect apps app-store-versions,app-store-connect builds app-store-version,app-store-connect builds submit-to-app-store,app-store-connect publish when executed with --app-store option.Development
idfaDeclaration from AppStoreVersion.Relationships.The highlight of this release is added support for phased releases when publishing application to App Store Connect, which was added in PR #402.
The highlight of this release is added support for phased releases when publishing application to App Store Connect, which was added in PR #402.
Features
app-store-connect app-store-version-phased-releases enableapp-store-connect app-store-version-phased-releases set-stateapp-store-connect app-store-version-phased-releases cancelapp-store-connect app-store-versions phased-releaseapp-store-connect builds submit-to-app-store and app-store-connect publish support enabling and disabling releasing App Store version in phases. PR #402Documentation
app-store-connect app-store-version-phased-releasesapp-store-connect builds submit-to-app-storeapp-store-connect publishapp-store-connect app-store-version-phased-releases enableapp-store-connect app-store-version-phased-releases set-stateapp-store-connect app-store-version-phased-releases cancelapp-store-connect app-store-versions phased-releaseBugfixes
Development
codemagic.apple.resources.App and codemagic.apple.resources.Build. PR #383codemagic.apple.resources.enums.BuildAudienceType and codemagic.apple.resources.enums.SubscriptionStatusUrlVersion. PR #383codemagic.apple.resources.AppStoreVersionPhasedRelease. PR #402AppStoreVersionPhasedReleases that implements HTTP client methods to work with App Store version phased releases. PR #402read_app_store_version_phased_release and read_app_store_version_phased_release_data to App Store Connect API resource manager AppStoreVersions. PR #402BuildsActionGroup of AppStoreConnect by moving methods submit_to_testflight and submit_to_app_store along used private methods to dedicated action classes SubmitToTestFlightAction and SubmitToAppStoreAction respectively. Python API via parent AppStoreConnect class remains identical to what it was. PR #402ResourceManagerMixin to take both ResourceId and Resource instances as methods arguments where only IDs were allowed before. PR #402Remove usages of deprecated datetime properties on x509.Certificate instances. PR #399
Improvements
x509.Certificate instances. PR #399This version reverts changes that were introduced in 0.50.4 as they did not have intended effect. PR #395
This version reverts changes that were introduced in 0.50.4 as they did not have intended effect. PR #395
Fix app-store-connect publish action getting stuck while binary is being uploaded using altool. PR #394
Bugfixes
app-store-connect publish action getting stuck while binary is being uploaded using altool. PR #394Remove deprecated attributes and relationships for App Store Connect App data structure. PR #392
Allow custom export options in export options properly list for xcode-project build-ipa actions. PR #391
Features
xcode-project build-ipa actions. PR #391Fix error handling for corrupt Xcresult parsing in xcode-project actions. PR #390
Bugfixes
xcode-project actions. PR #390Add new actions to work with bundle identifier capabilities PR #388:
Features
app-store-connect bundle-ids capabilities to list the capabilities that are enabled for identifier,app-store-connect bundle-ids enable-capabilities to enable capabilities for identifier,app-store-connect bundle-ids disable-capabilities to disable capabilities for identifier.One column per quarter.