1 min read

Debug Bitrise Workflow Locally

  1. Install Bitrise CLI: brew update && brew install bitrise
  2. Open your local repo folder.
  3. Add the Bitrise Workflow file (bitrise.yml) you want to debug.
  4. Create a bitrise folder and put into the Android Keystore file android.jks.
  5. Create file .bitrise.secrets.yml, put in info for “Secrets” and “Code Signing” tabs on Bitrise web workflow editor, for example:
envs:
  - SLACK_WEBHOOK_URL: https://hooks.slack.com/services/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
    opts:
      meta:
        bitrise.io:
          is_expose: true

  - BITRISEIO_ANDROID_KEYSTORE_URL: file:///Users/USERNAME/YOUR-REPO/bitrise/android.jks
  - BITRISEIO_ANDROID_KEYSTORE_PASSWORD: KEYSTORE_PASSWORD
  - BITRISEIO_ANDROID_KEYSTORE_ALIAS: KEYSTORE_ALIAS
  - BITRISEIO_ANDROID_KEYSTORE_PRIVATE_KEY_PASSWORD: KEYSTORE_PASSWORD

To check the required inputs for a workflow step, check the bitrise.yml in its Github repo, for example: steps-sign-apk.
6. Now run bitrise run WORKFLOW_NAME and see how it goes.
7. Not all steps run by default when debugging locally, for example: ios-auto-provision-appstoreconnect only run if it’s on bitrise.io, check run_if expression in the step.yml.