Demarrage avec Mise à jour de Cordova

Copiez une invite de configuration avec les étapes d'installation et la guide markdown complète pour ce plugin.

        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.

Cette guide vous guide à travers l'ajout de @capgo/cordova-updater à une application Cordova afin de recevoir des mises à jour Capgo en temps réel sur iOS et Android.

Prérequis

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

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 au moment de l'installation (mêmes variables que l'Capacitor metteur à jour) :

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 :
Fenêtre de 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 le WebView soit servi par défaut https://localhost/ scheme.
Le plugin s'enregistre pour 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/ scheme.
Le plugin met en œuvre CDVPluginSchemeHandler pour intercepter les demandes de bundle.

Téléchargez votre premier bundle

Construirez vos actifs web, puis téléchargez avec le Capgo CLI (même workflow que Capacitor):

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

Étapes suivantes

Comparer les paramètres avec ceux de Capacitor la configuration de mise à jour de l'application — 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 plus tard ? Conservez l'ID d'application et les canaux Capgo identiques ; seule la package du plugin client change.