Skip to main content

App Center CodePush

App Center CodePush is an App Center cloud service that enables React Native developers to deploy mobile app updates directly to their users’ devices. It works by acting as a central repository where developers can publish certain updates (for example, JS, HTML, CSS, and image changes), and apps can query for updates (using the provided client SDKs).

You can seamlessly integrate App Center CodePush into your workflow with Appcircle, facilitating easy setup and utilization within your existing development processes.

Prerequisites

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

Prerequisite Workflow StepDescription
Git CloneThe repository needs to be cloned to begin the CodePush process. After this step, the variable AC_REPOSITORY_DIR will be set.

Input Variables

Below is a list of input variables that can be used with this component with a description of each.

danger

Avoid hard-coding sensitive information, like tokens and API keys, directly into the step parameters.

We recommend using Environment Variables groups for such sensitive variables.

Variable NameDescriptionStatus
$AC_APPCENTER_TOKENApp Center API Token.Required
$AC_APPCENTER_PRIVATE_KEYApp Center Private Key to sign updates. Upload your private key (.pem) to environment variables as a file and set its name as AC_APPCENTER_PRIVATE_KEY.Optional
$AC_PROJECT_PATHRelative path of the React Native project. Leave it empty to use the parent repository path.Optional
$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 (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 (owner is myapp).Required
$AC_APPCENTER_DESCRIPTIONThis parameter provides an optional change log for the deployment.Required
$AC_APPCENTER_DEPLOYMENTThis parameter specifies which deployment you want to release the update to. It defaults to Staging.Optional
$AC_APPCENTER_ROLLOUTThis parameter specifies the percentage of users (as an integer between 1 and 100) that should be eligible to receive this update.Optional
$AC_APPCENTER_VERSIONThe latest version will be used if no version is set.Optional
$AC_APPCENTER_EXTRAExtra command line arguments for appcenter. For example, add --debug for verbose logs.Optional

Output Variables

The App Center CodePush step does not produce any output variables. The results are shown in the build log.

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

Preview of GitHub - appcircleio/appcenter-codepush-component