Skip to main content

App Center Android Distribute

App Center Distribute for Android enables developers to distribute their Android applications to testers and stakeholders for testing purposes. It provides a centralised dashboard where developers can upload their app packages, manage distribution to specific groups of testers, collect feedback, and monitor installation and usage metrics. With App Center Distribute, developers can streamline the testing process, gather valuable insights, and iterate on their apps before releasing them to the public.

The Appcircle App Center Android Distribute step allows you to seamlessly distribute your Android applications and mapping files to App Center.

caution

Please note that you can also distribute your app via Appcircle. Utilizing Appcircle's distribution modules enhances manageability within the platform.

For more details, please refer to the following links:

Prerequisites

The workflow steps that need to be executed before running the App Center Android Distribute workflow step, along with their respective reasons, are listed in the table below.

Prerequisite Workflow StepDescription
Android BuildThe app required for this step is generated by the Android Build (or alternative build steps).
Android SignIf you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step.
danger

If a step other than the Android Build or Android Sign step is used to build or sign the app, then the App Center Android Distribute step depends on this step.

Input Variables

For each component, specific input variables are required for its operation on your system. The input variables necessary for App Center Android Distribute are as follows:

danger

Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.

We recommend using Environment Variables groups for such sensitive variables.

Variable NameDescriptionStatus
$AC_APPCENTER_TOKENSpecifies the Appcenter API token. For more detail, please refer to this App Center documentation.Required
$AC_APPCENTER_APK_PATHSpecifies the full path of the app build. Both APK ($AC_APK_PATH, $AC_SIGNED_APK_PATH) and AAB ($AC_AAB_PATH, $AC_SIGNED_AAB_PATH) files are supported.Required
$AC_APPCENTER_OWNERSpecifies the owner of the app on the App Center. The app's owner can be identified in its URL, such as https://appcenter.ms/users/JohnDoe/apps/myapp for a user-owned app (where JohnDoe is the owner) and https://appcenter.ms/orgs/Appcircle/apps/myapp for an org-owned app (the owner is Appcircle).Required
$AC_APPCENTER_APPNAMEThe name of the app is in the App Center. The app's name can be identified in its URL, such as https://appcenter.ms/users/JohnDoe/apps/myapp for a user-owned app (where myapp is the app name) and https://appcenter.ms/orgs/Appcircle/apps/myapp for an org-owned app (the owner is myapp).Required
$AC_APPCENTER_GROUPSSpecifies the group names in the App Center. For more than one group name to be distributed, you must separate them with a comma. For example: group0,group1,..,groupnOptional
$AC_APPCENTER_STORESpecifies the store name. For example: App Store, Google Play, and Intune.Optional
$AC_APPCENTER_RELEASE_NOTES_PATHSpecifies the release note path. If you use the Publishing Release Notes component before this step, release-notes.txt will be used as release notes. The default value is AC_OUTPUT_DIR/release-notes.txt.Optional
$AC_APPCENTER_MAPPING_PATHSpecifies the path of the mapping.txt file. Example: $AC_REPOSITORY_DIR/build/app/outputs/mapping/release/mapping.txtOptional
$AC_APPCENTER_MANDATORYSpecifies whether the update should be considered mandatory. The options are true and false. The default value is false.Optional
$AC_APPCENTER_NOTIFYNotify testers of this release. The options are true and false. The default value is false.Optional
$AC_APPCENTER_VERSIONApp Center CLI version. The latest version will be used if no version is set.Optional
$AC_APPCENTER_EXTRAExtra command-line arguments for App Center. For example, add --debug for verbose logs.Optional

To access the source code of this component, please use the following link:

Preview of GitHub - appcircleio/appcircle-android-appcenter-distribute-component