From V2 to V3

This Documentation will explain how to Mise à niveau to the Version 3 of auto-Mise à jour.

First Migrer to the last tooling:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Retirer all your Précédent config:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

to only let this:

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ If you were using your server, with autoUpdateURL, I will upgrade this guide soon for you. Meanwhile, take a look at the new upload option external which allows you to send only the link of your zip, not the code in Capgo cloud. This has been made for companies with strict privacy policies. In external mode, the code will never land on Capgo server, we just store the URL and send it to the device, which will directly download it. In the standard way, the code is zipped and stored in our server, but we will never open it or use it either.

What change

All configurations become server-side for auto-Mise à jour, to give you more control on how you send an Mise à jour to Utilisateurs.

That allows us to revert, even Déployer just to one Utilisateur with Canaux! These Paramètres are added Retour to the web interface:

• disable revert under native
• disable update above major

⚠️ They will become true by default for all Canaux

This will also Retirer the need to Mise à jour often the plugin, most Mises à jour will be done server side, and you will get it without any change in your side.

⚠️ Réinitialiser when an Mise à jour becomes the default, so if you prefer not to Retirer all Télécharger versions when updating from the store, do this:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

Mise à jour your code

Lastly, Mise à jour all your imports in JS from:

import { CapacitorUpdater } from 'capacitor-updater'

to

import { CapacitorUpdater } from '@capgo/capacitor-updater'

Then build your code again npm run build and copy assets once more npx cap copy.

You should be able now to Test the last auto-Mise à jour system

Send your Version with:

npx @capgo/cli@latest bundle upload

instead of

npx capgo upload

Future evolution

For now only the first public Canal is in use, in the future, public will change for multi public Canaux, if more than one is set.

Common problems:

• Build problem after upgrade: if you have already opened the source code of the plugin in Android studio or Xcode, sometimes the sync doesn’t remove them, that the cause of the issue. Open the native IDE and remove capacitor-updater by hands and do npx cap sync this should solve.