codemagic-cli-tools

Bugfixes

• Fix actions firebase-app-distribution get-latest-build-version and firebase-app-distribution releases list for cases when specified application does not have any releases available. PR #373

Bugfixes

• Update action xcode-project use-profiles. Fix assigning provisioning profiles to Xcode targets that have SDK specific provisioning profile specifiers. PR #371
• Do not crash xcode-project actions clean, build-ipa and run-tests if xcpretty is not installed. PR #372

Changes in this release are from PR #370 and add Python 3.12 compatibility.

PEP-632 deprecated distutils module, and it was removed entirely in Python 3.12. This release ensures that distutils module is not used any more.

None of the breaking changes have an effect on command line usage, only the Python API is affected.

Development

• Breaking: Type of codemagic.models.Xcode.version property was changed. Instead of distutils.version.LooseVersion it is now packaging.version.Version.
• Breaking: Type of codemagic.models.simulator.Runtime.runtime_version property was changed. Instead of distutils.version.LooseVersion it is now packaging.version.Version.

Features

• Show full executed command in error output if action execution fails unexpectedly. PR #364
• Show full exception tracktrace in STDOUT logs if --verbose option is set. PR #364

Bugfixes

• Fix handing of required arguments to google-play if they are defined as empty strings (--track, -tracks, --package-name, --source-track and --target-track). PR #363
• Fix looking for errors from Xcode build logs as part of xcode-project build-ipa if the logs contain byte sequences that cannot be decoded. PR #365

Development

• Support iterating over binary file descriptors with codemagic.utilities.backwards_file_reader.iter_backwards. PR #365

Bugfixes

• Fix Google Play release promotion with action google-play tracks promote-release for releases that have release notes. PR #361

Development

• Add GitHub Actions job to run tests with Python 3.12. PR #362

Features

• Add new option --max-find-build-wait to action app-store-connect publish to configure maximum waiting time to discover uploaded build from App Store Connect before failing publishing. Defaults to 10 minutes. PR #355

Docs

• Add option --max-find-build-wait documentation for action app-store-connect publish. PR #355
• Update option --cancel-previous-submissions documentation for actions app-store-connect builds submit-to-app-store and app-store-connect publish. PR #353

Bugfixes

• Support Apple Vision Pro devices in App Store Connect API read device information and list devices endpoints. This is done by declaring APPLE_VISION_PRO definition in enumeration codemagic.apple.resources.enums.DeviceClass. PR #357

Bugfixes

• Fix initializing codemagic.models.application_package.Ipa objects for big binaries (exceeding 4GB in size). PR #356

Bugfixes

• Ensure that build for correct platform is looked up from App Store Connect after initial upload completes using app-store-connect publish. PR #352

Additions and changes from pull request #349. Resolves issue #344.

Features

• Add new option --include-version to app-store-connect actions get-latest-build-number, get-latest-app-store-build-number and get-latest-testflight-build-number. If specified, the action outputs matched build's version string in addition to build number.

Bugfixes

• Output valid JSON string with app-store-connect actions get-latest-build-number, get-latest-app-store-build-number and get-latest-testflight-build-number if --json option is specified.

Docs

• Documentation was updated for actions:
  • app-store-connect get-latest-build-number,
  • app-store-connect get-latest-app-store-build-number,
  • app-store-connect get-latest-testflight-build-number.

Features

• Log out processed build and its beta detail information before submitting it to App Store or TestFlight. PR #347

Additions and changes from pull request #345.

Features

• Add a new action google-play tracks promote-release to promote a release from one Google Play release track to another.

Development

• Define a new common argument type bounded_number for CLI usage that can be used to load floats and integers from CLI inputs within specified ranges.
• Add a new client method update_track to update release track in Google Play API client codemagic.google_play.api_client.GooglePlayDeveloperAPIClient.

Documentation

• Update documentation for action group google-play tracks.
• Add documentation for action google-play tracks promote-release.

Additions and changes from pull request #340. Resolves issue #339.

Features

• Support submitting macOS packages to TestFlight using app-store-connect publish --testflight.
• Add new action app-store-connect builds beta-details to show beta detail information for specific build.
• Waiting for App Store Connect build processing also waits for beta builds details to be processed before returning.

Development

• Add new client method read_beta_detail to builds resource manager in src/codemagic/apple/app_store_connect/builds/builds.py.
• Add new definitions for App Store Connect models:
  • BuildBetaDetail for https://developer.apple.com/documentation/appstoreconnectapi/buildbetadetail,
  • ExternalBetaState enumeration for https://developer.apple.com/documentation/appstoreconnectapi/externalbetastate,
  • InternalBetaState for https://developer.apple.com/documentation/appstoreconnectapi/internalbetastate.

Documentation

• Add documentation for action app-store-connect builds betat-details.

Special thanks for contribution to @nilsreichardt.

Bugfixes

• Fix iOS application package abstraction layer in codemagic.models.application_package.Ipa to support large archives (exceeding 4GB in size). PR #342

Bugfixes

• Do not require certificate private key to show certificate information using app-store-connect get-certificate if certificate is not saved to disk. PR #337

Features

• Add --omit-sdk option to action xcode-project run-tests to exclude -sdk flag from being passed to underlying xcodebuild test command. PR #335

Changes in this release improve app-store-connect register-device action by allowing to pass multiple UDIDs from different sources.

None of the breaking changes have an effect on command line usage, only the Python API of is affected.

Features

• Update app-store-connect register-device action:
  • The --udid argument now accepts multiple UDIDs.
  • The --udid argument now accepts a file or an environment variable as a source for UDIDs.
  • Introduce --ignore-registration-errors flag to continue registering devices despite errors
  • Introduce short flags:
    • -n flag for the device name,
    • -u flag for the UDIDs.

Development

• AppStoreConnect.register_device action method update:
  • It now accepts a list of UDIDs for registration at the keyword argument device_udids.
  • Breaking: AppStoreConnect.register_device now returns a list of registered devices.
• Add ignore_registration_errors keyword argument to continue registering devices despite errors.

Documentation

• Update documentation for app-store-connect register-device action:
  • Add new short flags: -n and -u.
  • Add the description for the new --ignore-registration-errors option.
  • Update the action description.

Development

• Format Python source code with Black. PR #322
• Check Python linting rules with Ruff. This replaces Flake8 and isort checks. PR #322

Deprecations

• Method list_capabilility_ids of codemagic.apple.app_store_connect.provisioning.BundleIds is deprecated and shows a deprecation warning on calls. Use list_capability_ids of the same class instead. PR #326

Development

• Define deprecated decorator in codemagic.utilities.decorators to mark functions and methods as obsolete. PR #326

Features

• Add support for visionOS runtime. PR #325

Bugfixes

• Do not require releaseNotes from Firebase App Distribution release responses. PR #323

Dependencies

• Set lower bound version limit >= 2.84.0 to google-api-python-client Python dependency in order to comply with Firebase App Distribution APIs. PR #322

Development

• Add interface to declare aliases for deprecated actions. PR #187

Features

• Introduce firebase-app-distribution tool with the actions:
  • firebase-app-distribution releases list action to list releases
  • firebase-app-distribution get-latest-build-version to get a version number for the latest release build

Development

• Introduce action methods:
  • FirebaseAppDistribution.list_releases
  • FirebaseAppDistribution.get_latest_build_version

Tests

• Coverage for Firebase client FirebaseClient
• Coverage for action methods: FirebaseAppDistribution.list_releases and FirebaseAppDistribution.get_latest_build_version

Documentation

• Document firebase-app-distribution tool
• Document actions:
  • firebase-app-distribution releases list
  • firebase-app-distribution get-latest-build-version