{"id":20187541,"url":"https://github.com/bitrise-steplib/steps-appcenter-deploy-android","last_synced_at":"2025-04-10T06:43:45.492Z","repository":{"id":44869544,"uuid":"222953812","full_name":"bitrise-steplib/steps-appcenter-deploy-android","owner":"bitrise-steplib","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-11T07:23:01.000Z","size":105,"stargazers_count":6,"open_issues_count":0,"forks_count":10,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-24T07:51:29.452Z","etag":null,"topics":["bitrise","bitrise-step","ci","production-code"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitrise-steplib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-20T14:18:23.000Z","updated_at":"2024-07-11T07:23:03.000Z","dependencies_parsed_at":"2024-06-21T16:37:29.841Z","dependency_job_id":"ad65f0fe-c21d-44a1-a818-f412d48bd8fb","html_url":"https://github.com/bitrise-steplib/steps-appcenter-deploy-android","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-appcenter-deploy-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-appcenter-deploy-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-appcenter-deploy-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitrise-steplib%2Fsteps-appcenter-deploy-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitrise-steplib","download_url":"https://codeload.github.com/bitrise-steplib/steps-appcenter-deploy-android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248173539,"owners_count":21059595,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitrise","bitrise-step","ci","production-code"],"created_at":"2024-11-14T03:24:32.835Z","updated_at":"2025-04-10T06:43:45.471Z","avatar_url":"https://github.com/bitrise-steplib.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AppCenter Android Deploy\n\n[![Step changelog](https://shields.io/github/v/release/bitrise-steplib/steps-appcenter-deploy-android?include_prereleases\u0026label=changelog\u0026color=blueviolet)](https://github.com/bitrise-steplib/steps-appcenter-deploy-android/releases)\n\nDistribute your Android app through [Microsoft App Center](https://appcenter.ms/).\n\n\u003cdetails\u003e\n\u003csummary\u003eDescription\u003c/summary\u003e\n\n[This Step](https://github.com/bitrise-steplib/steps-appcenter-deploy-android) integrates with the [App Center](https://appcenter.ms/)'s Distribution service and enables you to distribute your apps seamlessly to different stores, for example, App Store, MS Intune, user groups or even individual testers.\n\n ### Configuring the Step\n\n Before you start:\n\n The Step requires an active MS App Center account.\n\n 1. Add the **APP path** which points to a binary file.\n 2. Add the **mapping.txt file path**.\n 3. Add the App Center **API token**.\n 4. Add the **Owner name**, which means the owner of the App Center app. For an app owned by a user, the URL in App Center can look like this https://appcenter.ms/users/JoshuaWeber/apps/APIExample where the {ownername} is JoshuaWeber. For an app owned by an organization, the URL can be, for example, https://appcenter.ms/orgs/Microsoft/apps/APIExample where the {ownername} is Microsoft.\n 5. Add the **App name** which is the name of the App Center app. For an app owned by a user, the URL in App Center might look like this: https://appcenter.ms/users/JoshuaWeber/apps/APIExample where the {app_name} is APIExample.\n 6. Add the **Distribution groups** which means the user groups you wish to distribute the app to. Please add one group name per line.\n 7. Add the **Distribution stores** where you wish to distribute the app to. Please add one store name per line.\n 8. Add the **Testers** who you wish to send the app to via email. Please add one email address per line.\n 9. Add any **Release notes for the deployed artifact**.\n 10. Send notification emails to testers and distribution groups with the **Notify Testers** input.\n 11. You can enforce the installation of a distribution version with the **Mandatory** input set to `yes`.\n 12. If you set the **Debug** input to `yes`, you can enable verbose logs.\n\n### Useful links\n- [About Android deployment with Bitrise](https://devcenter.bitrise.io/deploy/android-deploy/android-deployment-index/)\n- [About Android code signing](https://devcenter.bitrise.io/code-signing/android-code-signing/android-code-signing-index/)\n\n### Related Steps\n- [Deploy to Huawei App Gallery](https://www.bitrise.io/integrations/steps/app-gallery-deploy)\n- [Google Play Deploy](https://www.bitrise.io/integrations/steps/google-play-deploy)\n\u003c/details\u003e\n\n## 🧩 Get started\n\nAdd this step directly to your workflow in the [Bitrise Workflow Editor](https://devcenter.bitrise.io/steps-and-workflows/steps-and-workflows-index/).\n\nYou can also run this step directly with [Bitrise CLI](https://github.com/bitrise-io/bitrise).\n\n## ⚙️ Configuration\n\n\u003cdetails\u003e\n\u003csummary\u003eInputs\u003c/summary\u003e\n\n| Key | Description | Flags | Default |\n| --- | --- | --- | --- |\n| `app_path` | Path to binary file  For APKs, only single or universal APKs are supported: https://docs.microsoft.com/en-us/appcenter/build/react-native/android/#63-building-multiple-apks | required | `$BITRISE_APP_PATH` |\n| `mapping_path` | Path to an Android mapping.txt file. |  |  |\n| `api_token` | App Center API token | required, sensitive |  |\n| `owner_name` | Owner of the App Center app.  For an app owned by a user, the URL in App Center might look like https://appcenter.ms/users/JoshuaWeber/apps/APIExample.  Here, the {owner_name} is JoshuaWeber. For an app owned by an org, the URL might be https://appcenter.ms/orgs/Microsoft/apps/APIExample and the {owner_name} would be Microsoft | required |  |\n| `app_name` | The name of the App Center app.  For an app owned by a user, the URL in App Center might look like https://appcenter.ms/users/JoshuaWeber/apps/APIExample.  Here, the {app_name} is ApiExample. | required |  |\n| `distribution_group` | User groups you wish to distribute the app. One group name per line.  Distribution of AAB is supported only for Google Play store deployment: https://docs.microsoft.com/en-us/appcenter/distribution/uploading#android |  |  |\n| `distribution_store` | Distribution stores you wish to distribute the app. One store name per line.  Distribution of AAB is supported only for Google Play store deployment: https://docs.microsoft.com/en-us/appcenter/distribution/uploading#android |  |  |\n| `distribution_tester` | List of individual testers. One email per line.  Distribution of AAB is supported only for Google Play store deployment: https://docs.microsoft.com/en-us/appcenter/distribution/uploading#android |  |  |\n| `release_notes` | Additional notes for the deployed artifact. |  | `Release notes` |\n| `notify_testers` | Send notification email to testers and distribution groups. | required | `yes` |\n| `mandatory` | Enforce installation of distribution version. Requires SDK integration. | required | `no` |\n| `debug` | Enable verbose logs | required | `no` |\n| `all_distribution_groups` | Distribute the app to all user groups on that app. Enabling this options makes it ignore distribution_group. |  | `no` |\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOutputs\u003c/summary\u003e\n\n| Environment Variable | Description |\n| --- | --- |\n| `APPCENTER_DEPLOY_STATUS` | Deployment status: 'success' or 'failed' |\n| `APPCENTER_DEPLOY_INSTALL_URL` | Install page URL of the newly deployed version. |\n| `APPCENTER_DEPLOY_DOWNLOAD_URL` | Download URL of the newly deployed version. |\n| `APPCENTER_DEPLOY_RELEASE_ID` | ID of the new release for later retrieval via App Center APIs. |\n| `APPCENTER_PUBLIC_INSTALL_PAGE_URL` | Public install page URL of the latest version. |\n| `APPCENTER_PUBLIC_INSTALL_PAGE_URLS` | When a group is public the step will AppCenter provides and the step exports a public install page URL. |\n| `APPCENTER_RELEASE_PAGE_URL` | URL to the release page containing release notes, easily share with business partners and QA for testing. |\n\u003c/details\u003e\n\n## 🙋 Contributing\n\nWe welcome [pull requests](https://github.com/bitrise-steplib/steps-appcenter-deploy-android/pulls) and [issues](https://github.com/bitrise-steplib/steps-appcenter-deploy-android/issues) against this repository.\n\nFor pull requests, work on your changes in a forked repository and use the Bitrise CLI to [run step tests locally](https://devcenter.bitrise.io/bitrise-cli/run-your-first-build/).\n\n**Note:** this step's end-to-end tests (defined in `e2e/bitrise.yml`) are working with secrets which are intentionally not stored in this repo. External contributors won't be able to run those tests. Don't worry, if you open a PR with your contribution, we will help with running tests and make sure that they pass.\n\nLearn more about developing steps:\n\n- [Create your own step](https://devcenter.bitrise.io/contributors/create-your-own-step/)\n- [Testing your Step](https://devcenter.bitrise.io/contributors/testing-and-versioning-your-steps/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrise-steplib%2Fsteps-appcenter-deploy-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitrise-steplib%2Fsteps-appcenter-deploy-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitrise-steplib%2Fsteps-appcenter-deploy-android/lists"}