Skip to main content

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

Before running the App Center iOS Distrubiton step, you must complete certain prerequisites, as detailed in the table below:

Prerequisite Workflow StepDescription
Xcodebuild for DevicesThis step will build your application in ARM architecture and generate an IPA and dSYM file.
Screenshot
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

This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s).

Screenshot
Sensitive Variables

Please do not use sensitive variables such as Username, Password, API Key, or Personal Access Key directly within the step.

We recommend using Environment Variables groups for such sensitive variables.

Variable NameDescriptionStatus
$AC_APPCENTER_TOKENYou need to enter your App Center Access Token in this parameter. The CLI tool will be authenticated with this token.Required
$AC_APPCENTER_IPA_PATHFull 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_OWNEROwner 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_APPNAMEThe 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_GROUPSThe 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_STOREName 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_PATHIf you use the Publish Release Notes component before this step, release-notes.txt will be used as release notes.Optional
$AC_APPCENTER_UPLOAD_DSYMThe user can decide whether to upload your dSYM file. This parameter uploads the dSYM file automatically. The default value is true.Optional
$AC_APPCENTER_MANDATORYThis parameter specifies whether the update should be considered mandatory or not. The default value is false.Optional
$AC_APPCENTER_NOTIFYThis parameter sends notifications to testers. The default value is true.Optional
$AC_APPCENTER_VERSIONThe 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-ios-appcenter-distribute-component