App Center iOS Distrubiton
With this step, you can send your IPA and dSYM files to the App Center. For this, the step needs to be configured according to your App Center account.
Prerequisites
- First, you need to use this step after the Xcodebuild for Devices. This is because the project is compiled and archived in the Xcodebuild for Devices step.
| Prerequisite Workflow Step | Description |
|---|---|
| Xcodebuild for Devices | This step will build your application in ARM architecture and generate an IPA and dSYM file. |
caution
Note that if you do not use this step after the Xcodebuild for Devices, Appcircle will not find IPA and dSYM files to distribute to the App Center.
Input Variables
- Inside the step, there will be some parameters that you need to configure according to your App Center account. You can find the list and detailed descriptions of all parameters of the step in the table below.
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 Name | Description | Status |
|---|---|---|
$AC_APPCENTER_TOKEN | You need to enter your App Center Access Token in this parameter. The CLI tool will be authenticated with this token. | Required |
$AC_APPCENTER_IPA_PATH | Full path of the build. The path will be generated after the Xcodebuild for Devices step. You may enter the exact path of the IPA or the parent folder. | Required |
$AC_APPCENTER_OWNER | Owner of the app. 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_APPNAME | The name of the app. 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_GROUPS | The group name parameter is the distribution of Group Names you opened in your App Center account. You can type in which group you want to send it to. | Optional |
$AC_APPCENTER_STORE | Name of the store (App Store, Google Play, Intune). You can submit directly to this variable by giving one of the store names in your App Center account. | Optional |
AC_APPCENTER_RELEASE_NOTES_PATH | If you use the Publish Release Notes component before this step, release-notes.txt will be used as release notes. | Optional |
$AC_APPCENTER_UPLOAD_DSYM | The user can decide whether to upload your dSYM file. This parameter uploads the dSYM file automatically. The default value is true. | Optional |
$AC_APPCENTER_MANDATORY | This parameter specifies whether the update should be considered mandatory or not. The default value is false. | Optional |
$AC_APPCENTER_NOTIFY | This parameter sends notifications to testers. The default value is true. | Optional |
AC_APPCENTER_VERSION | The latest version will be used if no version is set. | Optional |
AC_APPCENTER_EXTRA | Extra 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:
GitHub - appcircleio/appcircle-ios-appcenter-distribute-componentContribute to appcircleio/appcircle-ios-appcenter-distribute-component development by creating an account on GitHub.github.com