Guide
Comment utiliser Updater dans Capacitor
Tester sur l'appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Live updates pour Ionic et Capacitor avec @capgo/capacitor-updater
@capgo/capacitor-updater est le plugin de mise à jour open source derrière les live updates Capgo pour les applications Ionic et Capacitor. Il télécharge les bundles web approuvés, les applique avec une protection native contre le rollback, et laisse les changements binaires sur le circuit de validation habituel de l'App Store et du Play Store.
Utilisez-le lorsque vous avez besoin de mises à jour OTA pour le HTML, le CSS, le JavaScript, les assets et d'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 impliquent 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 applications Capacitor avec des canaux, des vérifications de compatibilité, le contrôle du déploiement progressif, les logs d'appareil et le rollback.
Les plugins natifs, les entitlements, les modifications du manifest Android, du plist iOS et les mises à jour 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 le JavaScript s'est initialisé avec succès.setUpdateUrl- Définir dynamiquement l'URL de mise à jour de l'application au runtime.setStatsUrl- Définir dynamiquement l'URL des statistiques de l'application au runtime.setChannelUrl- Définir dynamiquement l'URL du canal de l'application au runtime.
Exemple d'utilisation
notifyAppReady
Notifier la couche native que le JavaScript s'est initialisé avec succès.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
Définir dynamiquement l'URL de mise à jour de l'application au runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
Définir dynamiquement l'URL des statistiques de l'application au runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
Définir dynamiquement l'URL du canal de l'application 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 Update(s) pour le workflow produit, @capgo/capacitor-updater pour les détails d'implémentation, Prise en main, Canaux, et Rollbacks.