Prise en main de Cordova Updater

Prêt à coller

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/cordova-updater`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/cordova-updater/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Ce guide vous guide à travers l'ajout de @capgo/cordova-updater to a Cordova app so you can receive Capgo live updates on iOS and Android.

ce plugin. Ionic WebView contourne les gestionnaires de schéma de Cordova, donc les ensembles téléchargés ne s'ouvriront pas.

Cordova CLI 12+
Android Cordova 13+ et/ou iOS Cordova 7+
Un compte Capgo (capgo.app/register)

Installation

Installez le plugin à partir de npm et passez votre ID d'application Capgo :
Fenêtre de terminal
```
cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID
```

Facultatif : surcharger les valeurs par défaut lors de l'installation (mêmes variables que l'Capacitor updater) :

cordova plugin add @capgo/cordova-updater \
  --variable APP_ID=YOUR_CAPGO_APP_ID \
  --variable DEFAULT_CHANNEL=production \
  --variable UPDATE_URL=https://plugin.capgo.app/updates \
  --variable AUTO_UPDATE=atBackground

Préparez les projets natifs après avoir modifié les variables du plugin :
Onglet Terminal
```
cordova prepare android ios
```

Utilisation de JavaScript

Après deviceready, le plugin est disponible sous la forme de cordova.plugins.Updater:

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const bundle = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: bundle.id });
  }
});

Les types TypeScript sont livrés avec le package npm :

import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };

Exige Cordova Android 13+ afin que la vue Web soit servie par défaut https://localhost/ schéma.
Le plugin enregistre un CordovaPluginPathHandler pour servir les actifs de bundle téléchargés.

Exige Cordova iOS 7+ avec le schéma par défaut app://localhost/ schéma.
Le plugin implémente CDVPluginSchemeHandler pour intercepter les demandes de bundle.

Section intitulée “Téléchargez votre premier bundle”

Build your web assets, then upload with the Capgo CLI (same workflow as Capacitor):

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Étapes suivantes

Comparer les paramètres avec la Capacitor configuration de mise à jour — la plupart des options correspondent à plugin.xml variables.
Lire Compatibilité de mise à jour en temps réel avant de livrer des modifications de plugin native.
Migrer vers Capacitor ultérieurement ? Conservez l'ID d'application Capgo et les canaux ; seule la package du plugin client change.