Premiers pas avec Cordova Updater
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet 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.
Ce guide vous montre comment ajouter @capgo/cordova-updater à une application Cordova afin de recevoir des Capgo live updates sur iOS et Android.
Prerequisites
Section intitulée « Prérequis »- Cordova CLI 12+
- Cordova Android 13+ et/ou Cordova iOS 7+
- Un compte Capgo (capgo.app/register)
Installation
Section intitulée « Installation »-
Installez le plugin depuis npm et indiquez 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'updater Capacitor) :
Fenêtre de terminal 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 modification des variables de plugin :
Fenêtre de terminal cordova prepare android ios
Démarrage rapide
Section intitulée « Démarrage rapide »document.addEventListener('deviceready', async () => { await cordova.plugins.Updater.notifyAppReady();});Erreurs courantes
Section intitulée « Erreurs courantes »- N'utilisez pas cordova-plugin-ionic-webview avec ce plugin.
- Appelez
notifyAppReady()dès que votre bundle est chargé — avant que le travail UI intensif ne retarde la fenêtre de rollback. - Gardez les paramètres de schéma Cordova corrects.
Utilisation de JavaScript
Section intitulée « Utilisation de JavaScript »Après deviceready, le plugin est disponible en tant que 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 } };Notes sur les plateformes
Section intitulée « Notes sur les plateformes »- Nécessite Cordova Android 13+ afin que la WebView soit servie par défaut
https://localhost/schéma. - Le plugin enregistre un
CordovaPluginPathHandlerpour servir les assets du bundle téléchargé.
- Nécessite Cordova iOS 7+ avec le
app://localhost/schéma. - Le plugin implémente
CDVPluginSchemeHandlerpour intercepter les requêtes de bundle.
Envoyez votre premier bundle
Section intitulée « Envoyez votre premier bundle »Compilez vos assets web, puis envoyez-les avec le Capgo CLI (même workflow que Capacitor) :
bun run buildnpx @capgo/cli@latest bundle upload --channel=productionProchaines étapes
Section intitulée « Prochaines étapes »- Comparez les paramètres avec les Configuration de l’updater Capacitor — la plupart des options correspondent aux
plugin.xmlvariables. - Lecture Compatibilité Live update avant de déployer les modifications du plugin natif.
- Migration vers Capacitor plus tard ? Conservez le même ID d’application Capgo et les mêmes canaux ; seul le package du plugin client change.