Aller au contenu principal
@capgo/cordova-updater Mises à jour Open source

Cordova Updater Plugin Cordova

Mises à jour OTA pour Cordova iOS et Android avec la même API que capacitor-updater

Installer

bun add @capgo/cordova-updater
npm, pnpm ou yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

Guide

Comment utiliser Cordova Updater dans Cordova

Utiliser @capgo/cordova-updater

@capgo/cordova-updater apporte les live updates Capgo aux apps Cordova iOS et Android avec le même API JavaScript que @capgo/capacitor-updater. Installez le plugin Cordova, appelez notifyAppReady() à chaque lancement, et envoyez des bundles avec @capgo/cli.

Installation

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

Utilisation de base

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

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

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

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

Prérequis plateforme

  • Cordova Android 13+ et Cordova iOS 7+
  • Schémas WebView Cordova par défaut (https://localhost/ sur Android, app://localhost/ sur iOS)
  • À éviter cordova-plugin-ionic-webview — cela empêche le remplacement du bundle

Déployer un nouveau bundle

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

Conseils pratiques

  • Réutilisez le même ID d'application Capgo et les mêmes canaux si vous déployez également un client Capacitor ou Electron.
  • Traitez les mises à niveau de plugins natifs ou de plateformes Cordova comme tout autre changement natif : déployez un nouveau binaire sur les stores avant de vous appuyer sur de nouvelles API natives dans vos bundles JS.
  • Tous les détails de configuration sont dans la documentation Cordova updater.

FAQ

FAQ du plugin Cordova Updater

Comment installer le plugin Cordova Updater dans une application Cordova ?

Exécutez "bun add @capgo/cordova-updater" (ou "npm install @capgo/cordova-updater"), puis suivez les étapes de configuration Cordova dans le guide et le README GitHub.

Est-ce que @capgo/cordova-updater fonctionne avec React, Vue et Angular ?

Oui. Cordova Updater est un package Cordova, il fonctionne donc avec n'importe quel framework web tournant sous Cordova : React, Vue, Angular, Svelte ou en JavaScript pur.

Est-ce que @capgo/cordova-updater est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/cordova-updater/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Déployez les changements de Cordova Updater sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo