Skip to main content

Setting Up Appcircle Distribute Task in Azure DevOps Pipeline

The Appcircle distribute extension allows users to upload their apps and start distribution to test groups or individuals.

Discover Extension​

You can discover more about this extension and install it by:

Testing Distribution - Visual Studio Marketplace
Extension for Azure DevOps - Appcircle Test Distribution allows you to distribute your mobile apps to your test groups
marketplace.visualstudio.com
Preview of Testing Distribution - Visual Studio Marketplace

How to Add the Appcircle Distribute Action to Your Pipeline​

To install the Appcircle Distribute Task Extension, follow these steps:

  1. Go to your pipeline, click "Edit" button on the top right corner

  2. Search for the “Appcircle distribute” task extension within your YAML file.

  3. Fill out the necessary input fields and click the Add button.

    3.1. You can learn more about getting your personal api token here.

    3.2. Find out how to create a distribution profile here

After filling out the required fields, the AppcircleTestingDistribution@0 task will appear in your pipeline steps as shown below:

- task: AppcircleTestingDistribution@0
  inputs:
    accessToken: "APPCIRCLE_ACCESS_TOKEN" # Your Appcircle Personal API Token
    profileId: "APPCIRCLE_PROFILE_ID" # ID of your Appcircle Distribution Profile
    appPath: "BUILD_PATH" # Path to your iOS .ipa or .xcarchive, or Android APK or App Bundle
    message: "Sample Message" # Custom message for your testers
Build Steps Order

Ensure that this action is added after build steps have been completed.

Leveraging Environment Variables​

Utilize environment variables seamlessly by substituting the parameters with $(VARIABLE_NAME) in your task inputs. The extension automatically retrieves values from the specified environment variables within your pipeline.

References​