Setup asc CLI (Bitrise Step)

GitHub-released source preview Bitrise Step for installing and running asc, the App Store Connect CLI.

Step ID

• Planned StepLib ID: setup-asc
• GitHub release tag: v1.0.1

Publication status

This repository has a GitHub source release, but it is not published to the public Bitrise StepLib yet. The setup-asc snippets below show the planned StepLib usage after publication; they are not an install path that works from the registry today.

Why use this step

• Install asc from GitHub Releases (latest or pinned versions)
• Verify release checksum before installing
• Run asc commands in the same step when needed
• Export common ASC_* auth variables for CI execution
• Works in Linux and macOS Bitrise environments

Modes

• mode=install
  • installs asc only
  • exports ASC_CLI_PATH and ASC_CLI_VERSION
• mode=run
  • installs asc, optionally exports auth/runtime ASC_* environment variables, and runs the provided command
  • exports ASC_COMMAND_EXIT_CODE

Pending StepLib examples

These examples show the intended shape after the step is published and tagged. For now, clone this repository and use the local validation commands below.

Install only:

workflows:
  primary:
    steps:
      - setup-asc:
          inputs:
            - mode: install
            - version: latest
      - script:
          inputs:
            - content: |-
                #!/usr/bin/env bash
                set -euo pipefail
                "${ASC_CLI_PATH}" --help

Install and run:

workflows:
  primary:
    steps:
      - setup-asc:
          inputs:
            - mode: run
            - version: latest
            - command: asc --help

Run with App Store Connect auth:

workflows:
  primary:
    steps:
      - setup-asc:
          inputs:
            - mode: run
            - version: latest
            - key_id: $ASC_KEY_ID
            - issuer_id: $ASC_ISSUER_ID
            - private_key_b64: $ASC_PRIVATE_KEY_B64
            - bypass_keychain: "yes"
            - command: asc apps list --output json

Security notes

• Store credentials in Bitrise Secret Env Vars
• Sensitive inputs are marked as is_sensitive in step.yml
• Prefer private_key_path or private_key_b64 over inline private key content

Useful links

• asc CLI repository: https://github.com/rudrankriyam/App-Store-Connect-CLI
• asc docs: https://asccli.sh/
• Bitrise Step docs: https://docs.bitrise.io/en/steps-and-workflows/introduction-to-steps.html

Publishing

• GitHub source release: v1.0.1
• StepLib publication is still pending
• Keep the step version separate from the asc CLI version selected by the version input

Local validation

stepman audit --step-yml ./step.yml
bitrise run audit-this-step
bitrise run test-install
bitrise run test-run-help