The codemagic.yaml in the root of this project contains an example of how to run a Fastlane lane as part of your Codemagic CI/CD builds. Refer to the Fastfile for an exmaple Fastlane script that increments the project build number, builds the iOS app and then deploys to TestFlight. Please refer to the Fastlane documentation for further information about configuring Fastlane.

Documentation for YAML builds can be found at the following URL:

https://docs.codemagic.io/getting-started/yaml/

Six environment variables need to be added to your workflow for Fastlane integration:

• MATCH_PASSWORD - the password used to encrypt/decrypt the repository used to store your distrbution certificates and provisioning profiles.
• MATCH_KEYCHAIN - an arbitrary name to use for the keychain on the build server, e.g "codemagic_keychain"
• MATCH_SSH_KEY - an SSH private key used for cloning the Match repository that contains your distrbution certificates and provisioning profiles. The public key should be added to your Github account. See here for more information about accessing Git dependencies with SSH keys.
• APP_STORE_CONNECT_PRIVATE_KEY - the App Store Connect API key. Copy the entire contents of the .p8 file and paste into the environment variable value field.
• APP_STORE_CONNECT_KEY_IDENTIFIER - the key identifier of your App Store Connect API key.
• APP_STORE_CONNECT_ISSUER_ID - the issuer of your App Store Connect API key.

Environment variables can be added in the Codemagic web app using the 'Environment variables' tab. You can then and import your variable groups into your codemagic.yaml. For example, if you named your variable group 'fastlane', you would import it as follows:

workflows:
  workflow-name:
    environment:
      groups:
        - fastlane

For further information about using variable groups please click here.

If you are using dependencies from Cocoapods it might be necessary to include the cocoapods gem in your Gemfile to prevent scope conflict issues.

gem "fastlane"
gem "cocoapods"

In the codemagic.yaml you should install your depenpendencies with bundle install and then execute the Fastlane lane with bundle exec fastlane <lane_name> as follows:

      scripts:
        - bundle install
        - bundle exec fastlane beta

If you need to use a specific version of bundler as defined in the Gemfile.lock file, you should install it with gem install bundler:<version> as follows:

      scripts:
        - gem install bundler:2.2.27
        - bundle install
        - bundle exec fastlane beta
       

To gather the .ipa and debug symbols from your build, add an the artifacts section to your codemagic.yaml as follows:

      artifacts:
        - ./*.ipa
        - ./*.dSYM.zip