CodePush is an App Center cloud service that enables Cordova and React Native developers to deploy mobile app updates directly to their users’ devices. It works by acting as a central repository that developers can publish certain updates to (e.g. JS, HTML, CSS and image changes), and that apps can query for updates from (using the provided client SDKs). This allows you to have a more deterministic and direct engagement model with your end-users, while addressing bugs and/or adding small features that don’t require you to re-build a binary and/or re-distribute it through any public app stores. All React Native apps created on App Center are CodePush enabled by default, to start using CodePush you simply need to follow the following steps.
1. Install the App Center CLI
You manage most of CodePush's functionality using the App Center CLI. To install it, open a command prompt or terminal, and type
npm install -g appcenter-cli
On macOS and Linux, you may need to prefix this command with
After successfuly installing the App Center CLI, please run the
appcenter login command in order to use the CLI's functionaltiy.
2. CodePush-ify your app
Add the appropriate CodePush client SDKs to your app and configure them to query for updates against one of your app deployments. The following provide details on how to do this for each unique app type:
3. Release an app update
After making changes to your app’s code or assets, push the update to your staging environment by using the CLI command which corresponds to the app type you are building (React Native or Cordova) and specify the name of your CodePush app.
appcenter codepush release-react -a <ownerName>/MyApp.
appcenter codepush release-cordova -a <ownerName>/MyApp.
One important new functionality in the App Center CLI is the ability to set an app as the current app by using
appcenter apps set-current <ownerName>/<appName>. By setting an app as the current app you don't have to use the -a flag. For example, the command
appcenter codepush deployment list -a <ownerName>/<appName> can be typed as
appcenter codepush deployment list if current app is set. You can check which app is set as your account's current app by using
appcenter apps get-current. Utilizing this command make most of the CLI commands shorter.
4. Run your app
Once these steps are complete, all users running your app will receive the update using the experience you configured in step #2. For more details, refer to the CLI and client SDK documentation (Cordova, React Native).