Guide
Comment utiliser Updater dans Capacitor
Tester sur un appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Live updates Ionic et Capacitor avec @capgo/capacitor-updater
@capgo/capacitor-updater est le plugin d'updater open source derrière les live updates Capgo pour les apps Ionic et Capacitor. Il télécharge les bundles web approuvés, les applique avec une protection native contre le rollback, et réserve les changements binaires au processus de revue classique de l'App Store et du Play Store.
Utilisez-le pour les mises à jour OTA de l'HTML, CSS, JavaScript, des assets et autres changements de la couche web une fois votre shell natif déjà approuvé.
Installer
npm install @capgo/capacitor-updater
npx cap sync
Où il s'intègre
Pour les équipes Ionic, les live updates suivent généralement le même workflow : déployer un nouveau bundle web sans forcer chaque utilisateur à passer par une release complète sur les stores. Capgo gère ce workflow pour les apps Capacitor avec des canaux, des vérifications de compatibilité, le contrôle du déploiement progressif, les logs d'appareils et le rollback.
Les plugins natifs, entitlements, changements du manifest Android, du plist iOS et les updates binaires SDK nécessitent toujours une release classique sur les stores. Gardez ces changements dans votre pipeline de build natif et utilisez les live updates pour la couche web approuvée.
Ce que ce plugin expose
notifyAppReady- Notifier la couche native que l'initialisation du JavaScript a réussi.setUpdateUrl- Définir l'URL de mise à jour de l'app dynamiquement au runtime.setStatsUrl- Définir l'URL des statistiques de l'app dynamiquement au runtime.setChannelUrl- Définir l'URL du canal de l'app dynamiquement au runtime.
Exemple d'utilisation
notifyAppReady
Informer la couche native que l'initialisation du JavaScript a réussi.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
Définir l'URL de mise à jour de l'app dynamiquement au runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
Définir l'URL des statistiques de l'app dynamiquement au runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
Définir l'URL du canal de l'app dynamiquement au runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-updater/
- Docs : /docs/plugins/updater/
- Produit Live update : /live-update/
Continuez avec @capgo/capacitor-updater
Si vous utilisez @capgo/capacitor-updater pour planifier les live updates, connectez-l’à Live updates pour le workflow produit, @capgo/capacitor-updater pour les détails d'implémentation, Premiers pas, Canaux, et Rollbacks.