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

  • 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 StepDescription
Xcodebuild for DevicesThis 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 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