Guida
Come usare Updater in Capacitor
Live updates per Ionic e Capacitor con @capgo/capacitor-updater
@capgo/capacitor-updater è il plugin updater open source alla base delle live update di Capgo per app Ionic e Capacitor. Scarica i web bundle approvati, li applica con protezione nativa contro il rollback e mantiene le modifiche solo binarie nel normale iter di revisione di App Store e Play Store.
Usalo quando ti servono aggiornamenti OTA per HTML, CSS, JavaScript, asset e altre modifiche al web layer dopo che la shell nativa è già stata approvata.
Installa
npm install @capgo/capacitor-updater
npx cap sync
Dove si inserisce
Per i team Ionic, le live update seguono solitamente lo stesso workflow: rilascia un nuovo web bundle senza costringere ogni utente a un rilascio completo sugli store. Capgo gestisce questo workflow per le app Capacitor con canali, controlli di compatibilità, controllo del rollout, log dei dispositivi e rollback.
Plugin nativi, entitlements, modifiche al manifest Android, modifiche al plist iOS e aggiornamenti binari di SDK richiedono ancora un normale rilascio sugli store. Mantieni queste modifiche nella tua pipeline di build nativa e usa le live update per il web layer approvato.
Cosa espone questo plugin
notifyAppReady- Notifica al layer nativo che l'inizializzazione di JavaScript è avvenuta con successo.setUpdateUrl- Imposta dinamicamente l'URL degli update dell'app a runtime.setStatsUrl- Imposta dinamicamente l'URL delle statistiche dell'app a runtime.setChannelUrl- Imposta dinamicamente l'URL del canale dell'app a runtime.
Esempio d'uso
notifyAppReady
Notifica al layer nativo che l'inizializzazione di JavaScript è avvenuta con successo.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
Imposta dinamicamente l'URL degli update dell'app a runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
Imposta dinamicamente l'URL delle statistiche dell'app a runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
Imposta dinamicamente l'URL del canale dell'app a runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-updater/
- Documentazione: /docs/plugins/updater/
- Prodotto Live update: /live-update/
Continua da @capgo/capacitor-updater
Se stai usando @capgo/capacitor-updater per pianificare i live update, collegalo a Live Update per il workflow del prodotto, @capgo/capacitor-updater per i dettagli di implementazione, Per iniziare, Canali, e Rollback.