Come utilizzare la versione semantica per gli aggiornamenti OTA con Capgo

Vuoi semplificare gli aggiornamenti delle app e il controllo delle versioni? Aggiornamenti delle app e controllo delle versioni? Versione semantica (SemVer) combinato con Capgo’s aggiornamenti Over-The-Air (OTA) rendono la gestione Capacitor applicazioni più facile e veloce. Ecco come funziona:

• Basici della versione semantica: Le versioni utilizzano il formato MAJOR.MINOR.PATCH:

  • MAJOR: Per modifiche di rottura.
  • MINOR: Per nuove funzionalità compatibili con la retrocompatibilità.
  • PATCH: Per risoluzione bug.

• Perché utilizzare SemVer con Capgo?

  • Comunicazione chiara sulle aggiornamenti.
  • Gestione delle versioni più intelligente.
  • Evitare conflitti di dipendenza.
  • Pianificazione delle rilasci organizzata.

• Capgo Setup Passaggi:

  1. Installa il plugin di aggiornamento di Capgo.
  2. Configura la versione dell'app in capacitor.config.json e altri file.
  3. Inizia con la tua chiave API.
  4. Usa Capgo CLI per creare e caricare aggiornamenti.

• Gestisci Versioni e Canali:

  • Usa canali separati (ad esempio, “beta” per le prove, “produzione” per le rilasci stabili).
  • Controlla le politiche di aggiornamento (aggiornamenti automatici delle patch, approvazione manuale per le modifiche principali).
  • Opzioni di rollback per gli aggiornamenti falliti.

• Processo di distribuzione:

  • Aggiorna i numeri di versione seguendo le regole di SemVer.
  • Testa accuratamente prima di distribuire.
  • Usa CLI comandi per caricare e distribuire gli aggiornamenti.

Capgo assicura che gli aggiornamenti raggiungano gli utenti velocemente e in modo affidabile, con strumenti per gestire le interruzioni e mantenere la stabilità. Perfetto per le squadre che utilizzano i flussi di lavoro CI/CD per automatizzare gli aggiornamenti.

Consiglio rapido: Testa sempre gli aggiornamenti e utilizza i canali per gestire i roll-out in fase di staging in modo efficace.

Semantic Versioning | Migliora il livello

Capgo Guida di configurazione

Ecco come configurare Capgo per la gestione degli aggiornamenti OTA e il controllo delle versioni con facilità.

Passaggi di configurazione iniziali

Inizia installando il Capgo plugin di aggiornamento:

npm install @capgo/capacitor-updater  
npx cap sync

Assicurati di avere capacitor.config.json file utilizza un formato di versione semantico:

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

Per i progetti più vecchi, aggiorna i dettagli della versione in questi luoghi:

• package.json (cerca il version campo)
• android/app/build.gradle (aggiorna versionName)
• ios/App/App.xcodeproj/project.pbxproj (aggiorna CURRENT_PROJECT_VERSION)

Una volta configurato, inizializza Capgo con la tua chiave API :

npx @capgo/cli@latest init YOUR_API_KEY

Tabella di riferimento rapida:

Integrazione del Controllo delle Versioni

Capgo funziona bene con le piattaforme CI/CD, rendendo aggiornamenti automatizzati facili. Le piattaforme supportate includono:

• GitHub Actions
• GitLab CI
• Azure DevOps
• Jenkins
• CircleCI

Se stai lavorando sullo sviluppo locale, puoi disabilitare gli aggiornamenti automatici aggiungendo questo alla tua configurazione:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Ciò assicura che Capgo non sovrascriva i tuoi cambiamenti locali. Una volta pronto il tuo setup, carica la tua prima versione:

npx @capgo/cli@latest bundle upload  
npx @capgo/cli@latest channel set production -s default

Infine, notifica il plugin nativo sulla salute del pacchetto nel file principale dell'app:

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

Questa configurazione assicura che la tua app sia pronta per i deployment OTA fluidi e la gestione delle versioni.

Utilizzo della versione semantica con Capgo

Gestione del numero di versione

Capgo utilizza la versione semantica (SemVer) per gestire le versioni dell'applicazione, formattate come MAJOR.MINOR.PATCH. Ecco come funziona:

• Versione maggiore (X.0.0): Incrementa il numero MAJOR per le modifiche che rompono la compatibilità.
• Versione minore (1.X.0): Incrementa il numero MINOR per le nuove funzionalità che rimangono compatibili.
• Versione di patch (1.0.X): Incrementa il numero PATCH per le correzioni di bug che non influiscono sulla compatibilità.

Seguendo le regole di SemVer, puoi semplificare la gestione delle versioni e assicurare aggiornamenti più fluidi attraverso i tuoi canali di distribuzione.

Guida per il Controllo delle Versioni

Capgo ti consente di gestire le distribuzioni in modo efficace configurando canali distinti per diverse fasi del tuo workflow.

• Gestione delle Versioni per CanaliOrganizza il tuo processo di distribuzione creando canali separati per il testing e la produzione. Ad esempio:

  • Utilizza un canale “beta” (ad esempio, 1.2.0-beta) per testare nuove funzionalità.
  • Mantieni un canale “produzione” (ad esempio, 1.2.0) per rilasci stabili.
  • Aggiungi canali specifici per piattaforma (ad esempio, “ios-hotfix” con versione 1.2.1) quando si affrontano problemi specifici per piattaforma.

• Configurazione della Politica di AggiornamentoControlla come vengono applicate le aggiornamenti utilizzando le opzioni di configurazione di Capgo . Ad esempio:

  {
    "plugins": {
      "CapacitorUpdater": {
        "disableAutoUpdate": "minor"
      }
    }
  }

  Questa configurazione garantisce che gli utenti ricevano automaticamente gli aggiornamenti di patch, mentre gli aggiornamenti minori e maggiori richiedono l'approvazione manuale.

• Strategia di Annullamento della VersioneUtilizza identificatori di pre-uscita per mantenere opzioni di annullamento chiare. Questa approccio ti consente di tornare a una versione precedente se si verificano problemi, mantenendo la versioning coerente su tutti i canali.

Queste migliori pratiche rendono più facile gestire gli aggiornamenti, testare nuove funzionalità e mantenere la stabilità nel processo di distribuzione dell'applicazione.

sbb-itb-f9944d2

Aggiornamento OTA di distribuzione

Una volta pronto il tuo setup di gestione delle versioni, segui questi passaggi per distribuire gli aggiornamenti OTA in modo efficace.

Preparazione dell'aggiornamento

Inizia aggiornando la versione in package.json e capacitor.config.json. Assicurati che la versione segua il formato SemVer (MAJOR.MINOR.PATCH):

• Correzione di bug: Incrementa il numero di PATCH (ad esempio, 1.0.1 → 1.0.2)
• Nuova Funzione: Incrementa il numero minore (ad esempio, 1.0.0 → 1.1.0)
• Modifica Rottura: Incrementa il numero maggiore (ad esempio, 1.0.0 → 2.0.0)

Testa approfonditamente la tua build e conferma che l'app comunichi con il server utilizzando notifyAppReady.

Successivamente, decidi la tua strategia di aggiornamento. Puoi scegliere tra:

• Aggiornamento Automatico: Imposta automaticamente le richieste di versione minima.
• Controllo Manuale: Specifica le richieste di versione esatte per gli aggiornamenti.
• Canali di comunicazione: Utilizza i canali per testare e distribuire in modo graduale.

Capgo CLI Comandi di aggiornamento

Utilizza Capgo’s CLI per distribuire il tuo aggiornamento con facilità. Ecco come fare:

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo garantisce una distribuzione sicura con crittografia end-to-end e gestione di chiavi sicura.

“@Capgo is a smart way to make hot code pushes (and not for all the money in the world like with @AppFlow) 🙂”

Una volta distribuito, puoi monitorare gli aggiornamenti attraverso il dashboard di Capgo. Gli aggiornamenti raggiungono generalmente gli utenti in pochi minuti dopo che hanno aperto l'app. Il processo funziona in questo modo:

• L'app verifica gli aggiornamenti.
• Scarica l'aggiornamento in background.
• Segna la nuova versione come attiva quando l'utente esce dall'app.
• Applica l'aggiornamento alla prossima avviatura.

Per le distribuzioni a livello aziendale, potresti voler integrare l'automazione di CI/CD.

“Pratichiamo lo sviluppo agile e @Capgo è fondamentale per consegnare continuamente ai nostri utenti!”

Risoluzione dei Problemi e Consigli

Problemi di Gestione della Versione

La gestione della versione semantica in Capgo può complicare a volte le distribuzioni di aggiornamento. Per evitare di sovrascrivere il tuo lavoro di sviluppo, configura i seguenti nel tuo capacitor.config.json file:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Se un aggiornamento fallisce, ecco cosa puoi fare:

• Imposta autoUpdate a false durante lo sviluppo.
• Disinstalla l'applicazione.
• Riinstallala con la versione corretta.
• Riabilita le auto-aggiornamenti una volta che tutto è stabile.

Per aggiornamenti di versione principale, utilizzare il disableAutoUpdateBreaking flag e ascolta l'evento majorAvailable per gestire gli aggiornamenti in modo corretto:

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

Combiningo queste configurazioni con buone pratiche di squadra, puoi mantenere la consistenza della versione e ridurre gli errori.

Controllo di Versione della Squadra

Una volta gestiti gli aggiornamenti individuali, è fondamentale per le squadre stabilire forti pratiche di controllo di versione.

“Testare ogni modifica prima di unirla al repository principale rafforzerà la stabilità e eviterà costosi errori” [4]

Ecco alcuni metodi per garantire la consistenza:

• Definisci una branca come il repository principale per agire come fonte di verità.
• Utilizza canali separati Capgo per ambienti di sviluppo e produzione.
• Automate gli upload delle versioni tramite pipeline CI/CD.
• Documenta tutte le code modifiche con messaggi di commit chiari e dettagliati.

Per i team più grandi, la seguente matrice di gestione delle versioni può aiutare a organizzare gli aggiornamenti:

Passaggi di aggiornamento di ripristino

Anche con le precauzioni, gli aggiornamenti possono fallire. Se succede, segui questi passaggi di ripristino:

1. Ritorna a una versione precedente di bundle stabile.
2. Aggiorna i numeri di versione per qualsiasi nuovo fix (nota: i numeri di versione non possono essere riutilizzati dopo la cancellazione) [2].
3. Verifica gli aggiornamenti durante l'avvio dell'app per assicurarti che funzionino correttamente.

L'aggiornatore di Capgo è progettato per gestire le interruzioni. Ad esempio, se il server non è raggiungibile o un aggiornamento è stato cancellato, l'app continua a funzionare normalmente. [3]Aggiornamenti automatici sono riprovati durante il prossimo avvio dell'app. [3]Questa resilienza integrata riduce il downtime e garantisce operazioni più fluide.

Riepilogo

L'uso combinato di Semantic Versioning e Capgo ha reso gli aggiornamenti OTA per le app Capacitor più efficienti. Con 947,6 milioni di aggiornamenti consegnati e 1.400 app in produzione che utilizzano questo sistema, i processi di distribuzione sono diventati il 81% più efficienti. [1]Questo setup consente ai sviluppatori di distribuire aggiornamenti velocemente e in modo controllato, evitando i ritardi degli store di app. [1]Ecco cosa dicono gli sviluppatori:

“Abbiamo distribuito gli aggiornamenti OTA di __CAPGO_KEEP_0__ in produzione per la nostra base di utenti di oltre 5000. Stiamo vedendo un'operazione molto fluida, quasi tutti i nostri utenti sono aggiornati in pochi minuti dopo la distribuzione dell'aggiornamento OTA su @__CAPGO_KEEP_0__.” - colenso

Il sistema di versioning MAJOR.MINOR.PATCH rende facile comunicare i cambiamenti di versione, le nuove funzionalità e i bug fix Capgo OTA updates Semantic Versioning, combined with Capgo, has made OTA updates for __CAPGO_KEEP_1__ apps more efficient. [1]

Here’s what developers are saying: [5]. Questo è particolarmente utile per le squadre che gestiscono più rilasci ogni settimana attraverso la piattaforma di Capgo.

Capgo’s soluzione crittografata, integrata con gli strumenti CI/CD, è anche economica - riducendo i costi fino a $26,100 in cinque anni [1]. I suoi canali personalizzabili assicurano che gli aggiornamenti raggiungano gli utenti giusti al momento giusto.

“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare continuamente ai nostri utenti!” - Rodrigo Mantica [1]

Continua da Come utilizzare la versione semantica con Capgo Aggiornamenti OTA

Se stai utilizzando Come utilizzare la versione semantica con Capgo Aggiornamenti OTA per pianificare il rollback e il controllo delle versioni, connettilo con Rollbacks per i dettagli di implementazione in Rollbacks, Versione di destinazione per i dettagli di implementazione in Versione di destinazione, Comportamento di aggiornamento per i dettagli di implementazione in Comportamento di aggiornamento, pacchetto per i dettagli di implementazione in pacchetto, e Capgo Aggiornamenti in tempo reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in tempo reale.