A fork of Microsoft’s CodePush CLI, customized for updatetheapp.com to ship React Native over-the-air (OTA) updates.
Installation
Getting Started
- Generate an API key in the updatetheapp.com Dashboard.
- Sign in:
- Verify authentication:
- Release an update:
Commands
Authentication
uta login --accessKey <KEY>
– Authenticate using an API key.uta whoami
– Display the current authenticated user.
App Updates
uta release-react <appName> <platform>
– Release a React Native OTA update.--deploymentName <name>
– Deployment channel (default:Staging
).--description <desc>
– Description of the changes.--mandatory
– Make the update mandatory.--targetBinaryVersion <version>
– Target specific binary versions.
Migrating from App Center CodePush
Already usingreact-native-code-push
? Migrating to updatetheapp.com is straightforward.
Since updatetheapp.com uses the same client protocol, you don’t need to change the react-native-code-push
SDK package itself.
The migration involves these main steps:
- Create new deployments in the updatetheapp.com dashboard. You’ll get new deployment keys.
- Update your native configuration to point to the updatetheapp.com server and use your new deployment keys.
- Rebuild and resubmit your app binaries to the stores (a one-time step).
Server URL
Point your app to the updatetheapp.com server instead of the old CodePush/App Center endpoint:Platform-specific configuration
You’ll need to update both the server URL and the deployment key in your native files.Android
Replace your old key and server URL (if present) with the new values:
⚠️ The attribute name is CodePushServerUrl
(lower-case l) on Android.
iOS
Update the deployment key and add/update the server URL:$(CODE_PUSH_DEPLOYMENT_KEY)
and $(CODE_PUSH_SERVER_URL)
).
Rebuild & Resubmit
After updating your native configuration with the new server URL and deployment keys:- Increment your app version/build number.
- Create a new production build (
gradlew assembleRelease
/ Xcode Archive). - Submit the new binary to the app stores.
uta release-react
.