- Capgo is a service that helps development teams send live app to deployed apps.
- Capacitor JS apps written in jQuery Mobile, Framework 7, Sencha, KendoUI, Ionic or even your own custom solution can be migrated. An existing Ionic app is not required..
- Colt offers equivalent services for App Center Build (build Android/iOS apps). For Test, Diagnostics, and Analytics services.
If your app is still using Cordova, it’s necessary to migrate to Capacitor first before migrating to Capgo.
Built by the Ionic team as a spiritual successor to Cordova, Capacitor allows development to move close to the native tooling and capabilities with the goal of providing an even better user experience and performance.
Fortunately, the migration process is easy and the majority of Cordova plugins are backward compatible with Capacitor. Start migrating here.
Capgo, handles updating apps over time. Development teams can focus completely on the unique features of their app and outsource the complicated app delivery process to Capgo.
Capgo fills in the gaps between web delivery and mobile.
Like App Center, Capgo supports apps hosted in Git repositories on Azure DevOps, Bitbucket, GitHub, and GitLab.
Install Capgo CLI
If you do not have Node or NPM installed on your computer, you will need to do this before proceeding. If you need to install Node, please select the current LTS version.
package.json and Capacitor config files
Before you begin, I recommend making changes on a fresh Git branch.
Since Capgo was created to automate capacitor apps, it requires one file that your app may not have. First, create a
capacitor.config.json file. The easiest way to create it is to run in the root of your app:
Then, initialize Capacitor using the CLI questionnaire:
The CLI will ask you a few questions, starting with your app name, and the package ID you would like to use for your app.
Finally, commit the new files to your project:
Migrate the Code
If your built code is not in a
dist directory, change this value in the Capacitor config file.
Here is what the app’s directory structure should look like:
Once you’re logged into Capgo, navigate to the Account page then click on API key, then click on the ‘write’ key to copy it to your clipboard.
Install the Capgo SDK
From a command line, directly into the root of your Capacitor app folder, run the following command:
npm i @capgo/capacitor-updater && npx cap sync
To install the plugin into your Capacitor app.
And then add to your app this code as replacement of CodePush one:
This will tell the native plugin the installation as succeeded.
Deploying Live Updates (CodePush Alternative)
The Live Update feature works by using the installed Capgo SDK in your native application to listen to a particular Deploy Channel Destination. When a Web build is assigned to a Channel Destination, that update will be deployed to user devices running binaries that are configured to listen to the specified Channel Destination.
Login to Capgo CLOUD
First, use the
all apikey present in your account to log in with the CLI:
Add your first app
Let’s get started by first creating the app in Capgo Cloud with the CLI.
npx @capgo/cli@latest app add
This command will use all variables defined in the Capacitor config file to create the app.
Upload your first bundle
Run the command to build your code and send it to Capgo with:
By default, the version name will be the one in your
Check in Capgo if the build is present.
You can even test it with my mobile sandbox app.
Make channel default
After you have sent your app to Capgo, you need to make your channel
default to let apps receive updates from Capgo.
Configure app to validate updates
Then do a
npm run build && npx cap copy to update your app.
Receive a Live Update on a Device
For your application to receive a live update from Deploy, you’ll need to run the app on a device or an emulator. The easiest way to do this is simply to use the following command to launch your local app in an emulator or a device connected to your computer.
Open the app, put it in the background and open it again, you should see in the logs the app did the update.
Congrats! 🎉 You have successfully deployed your first Live Update. This is just the start of what you can do with Live Updates. To learn more, view the complete Live Updates docs.
Remove App Center Dependencies
Now that we’ve integrated Capgo’s services, you should remove any references to App Center. Besides being a best practice to remove unused code/services, removing the SDK should reduce the size of your apps.
First, open a terminal then uninstall the App Center plugins:
config.xml and remove the following
preference values. They will look similar to:
If you were using App Center Analytics in your app, remove the following
Remove the following
<access /> elements:
Remove the reference to CodePush in the CSP
meta tag in the
index.html file (
Finally, within your app, remove any code references to App Center services, such as
You’ve migrated from App Center to Capgo, utilizing the Live Updates. This is just the beginning of what you can use Capgo for. Explore the rest of the service includes Channel (multiple environments) and override. Cloud CLI integration, use Capgo inside your CI/CD platform of choice (such as GitHub Action, GitLab, Jenkins, and more).
Automatic send app update
If your code is hosted on GitHub, you can set up automatic build and release in a few more steps, thanks to GitHub actions.
I have made a second article to allow you to so.