Capawesome Cloud integration

How to integrate your workflows with Capawesome Cloud using codemagic.yaml

Capawesome Cloud is a powerful platform that provides a suite of tools to help you deploy Live Updates to your Capacitor apps after they have been published to the App Store or Google Play.

Configure access to Capawesome Cloud

Follow these steps to configure access to Capawesome Cloud:

1. Sign up with Capawesome Cloud and generate a new token via the Settings page
2. Open your Codemagic app settings, and go to the Environment variables tab.
3. Enter the desired Variable name, e.g. CAPAWESOME_TOKEN.
4. Copy and paste the Capawesome Cloud token string as Variable value.
5. Enter the variable group name, e.g. capawesome_credentials. Click the button to create the group.
6. Make sure the Secure option is selected.
7. Click the Add button to add the variable.
8. Add the variable group to your codemagic.yaml file

  environment:
    groups:
      - capawesome_credentials

Install the Capawesome Cloud CLI

In order to deploy live updates to Capawesome Cloud, you need to install the Capawesome Cloud CLI:

  scripts:
    - name: Install Capawesome Cloud CLI
      script: | 
        npm install @capawesome/cli

After that, you need to log in to Capawesome Cloud using the token you generated:

  scripts:
    - name: Log in to Capawesome Cloud
      script: | 
        npx capawesome login --token $CAPAWESOME_TOKEN

Deploy a Live Update to Capawesome Cloud

Now you can deploy a live update to Capawesome Cloud:

  scripts:
    - name: Deploy to Capawesome Cloud
      script: | 
        npx capawesome apps:bundles:create --appId <app-id> --path <path-to-bundle>

Make sure to replace <app-id> with the ID of your app on Capawesome Cloud and <path-to-bundle> with the path to the bundle you want to upload (e.g. www).

We recommend that you also specify a Channel when uploading the bundle:

  scripts:
    - name: Deploy to Capawesome Cloud
      script: | 
        npx capawesome apps:bundles:create --appId <app-id> --path <path-to-bundle> --channel <channel-name>

This way you can easily restrict live updates to specific versions of your app and prevent incompatible updates.

The Capawesome Cloud CLI then automatically creates a zip archive of the bundle and uploads it to the Capawesome Cloud where it becomes immediately available for download.