Saltare al contenuto principale
@capgo/capacitor-aggiornatore Aggiornamenti Sorgente aperta

Aggiornamento Plugin Capacitor

Deploy Ionic e Capacitor aggiornamenti live istantaneamente ai tuoi utenti senza ritardi di revisione degli store app

Installa

bun add @capgo/capacitor-updater bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-updater
  • pnpm add @capgo/capacitor-updater
  • yarn add @capgo/capacitor-updater

Guida

Come utilizzare Aggiornatore in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansione il codice QR code.

Anteprima del plugin di aggiornamento QR code

Ionic e Capacitor aggiornamenti live con @capgo/capacitor-aggiornamento

@capgo/capacitor-aggiornamento è il plugin di aggiornamento open-source dietro Capgo aggiornamenti live per Ionic e Capacitor app. Scarica i pacchetti web approvati, applica loro con protezione di rollback nativa e mantiene le modifiche binarie sul normale percorso di revisione dell'App Store e di Play.

Usalo quando hai bisogno di aggiornamenti OTA per HTML, CSS, JavaScript, asset e altre modifiche al layer web dopo che la shell nativa è stata approvata.

Installa

npm install @capgo/capacitor-updater
npx cap sync

Dove si inserisce

Per le squadre di Ionic, gli aggiornamenti live solitamente significano lo stesso workflow: invia un nuovo pacchetto web senza costringere ogni utente a passare attraverso una rilascio completo del store. Capgo gestisce quel workflow per le Capacitor app con canali, controlli di compatibilità, controllo del rilascio, registri di dispositivo e rollback.

Il plugin nativo, le entità, le modifiche al manifesto Android, le modifiche al plist iOS e gli aggiornamenti binari SDK richiedono ancora un rilascio normale dell'app store. Mantieni quelle modifiche nel tuo pipeline di costruzione nativa e usa gli aggiornamenti live per la layer web approvata.

Cos'è esposto da questo plugin

  • notifyAppReady - Notifica la layer nativa che JavaScript è stato inizializzato con successo.
  • setUpdateUrl - Imposta l'URL di aggiornamento dell'app dinamicamente durante l'esecuzione.
  • setStatsUrl - Imposta l'URL delle statistiche dell'app dinamicamente durante l'esecuzione.
  • setChannelUrl - Imposta l'URL del canale dell'app dinamicamente durante l'esecuzione.

- Esempio di utilizzo

notifyAppReady

- Notifica la layer nativa che JavaScript è stato inizializzato con successo.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

const result = await CapacitorUpdater.notifyAppReady();
console.log(result);

setUpdateUrl

- Imposta l'URL di aggiornamento dell'app dinamicamente durante l'esecuzione.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });

setStatsUrl

- Imposta l'URL delle statistiche dell'app dinamicamente durante l'esecuzione.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });

setChannelUrl

- Imposta l'URL del canale dell'app dinamicamente durante l'esecuzione.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });

- Riferimento completo

Continua da @capgo/capacitor-aggiornatore

Se stai utilizzando @capgo/capacitor-aggiornatore to plan live updates, connect it with Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto @capgo/capacitor-aggiornatore per i dettagli di implementazione Guida alla Pratica, Canalie Ripristini.

FAQ

Domande frequenti del plugin Updater

Come posso installare il plugin Updater in un'app Capacitor?

Esegui "bun add @capgo/capacitor-updater" (o "npm install @capgo/capacitor-updater"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino le native code. Importalo da "@capgo/capacitor-updater" nella tua app code.

Funziona @capgo/capacitor-updater con React, Vue e Angular?

Sì. Updater è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-updater?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-updater?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-updater/ e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e le richieste di pull sono benvenuti.

Posso aggiornare code che utilizza Updater senza una revisione dell'App Store?

Instalando o aggiornando il plugin si modificano le native code, quindi è necessario un nuovo build dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con Capgo live updates.

Invia le modifiche dell'Updater senza attendere la revisione dell'app

Una volta che il plugin è nel tuo build di store, gli aggiornamenti live di Capgo inviano le tue modifiche JavaScript, HTML e CSS ai utenti in pochi minuti.

Avvia con Capgo