Come utilizzare la versione semantica con gli aggiornamenti Capgo OTA

Vuoi semplificare aggiornamenti dell'app e il controllo delle versioni? La versione semantica (SemVer) combinata con Capgofa gestire Capacitor app più facile e veloce. Ecco come:

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

  • MAJOR: Per modifiche di rottura.
  • MINOR: Per nuove funzionalità compatibili con il passato.
  • PATCH: Per correzioni di bug.

• Perché Usare SemVer con Capgo?

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

• Capgo Setup I passaggi:

  1. Install il plugin di aggiornamento di Capgo.
  2. Configura la versione del tuo app in capacitor.config.json e altri file.
  3. Inizia con la tua chiave di API.
  4. Usa Capgo CLI per creare e caricare gli 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 per le patch, approvazione manuale per i cambiamenti maggiori).
  • Opzioni di rollback per gli aggiornamenti falliti.

• Procedura di distribuzione:

  • Aggiorna i numeri di versione seguendo le regole di SemVer.
  • Testa accuratamente prima di distribuire.
  • Usa i comandi CLI 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.

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

Versionamento Semantico | Livello Su

Capgo Guida di configurazione

Ecco come configurare Capgo per la gestione degli aggiornamenti OTA e del 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 che il tuo capacitor.config.json context:HTML testo frammento da una stringa di Capgo UI più lunga (chiave padre `solutions_cordova_to_capacitor_ai_step2_body`). Pagina/area: pagina di marketing di soluzioni di Capgo. Ruolo: frase di copertina del sito web. Visualizzato in: pagina solutions/cordova-to-capacitor-ai.astro. Chiave messaggio `solutions_cordova_to_capacitor_ai_step2_body` (Solutions Cordova To Capacitor Ai Step2 Body).

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

il file utilizza un formato di versione semantica:

• package.json Per i progetti più vecchi, aggiorna i dettagli della versione in questi luoghi: version (cerca il
• android/app/build.gradle campo) versionName)
• ios/App/App.xcodeproj/project.pbxproj (aggiorna CURRENT_PROJECT_VERSION)

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

Una volta configurato, inizializza __CAPGO_KEEP_0__ con la tua __CAPGO_KEEP_1__ chiave:

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 lavori sullo sviluppo locale, puoi disabilitare gli aggiornamenti automatici aggiungendo questo alla tua configurazione:

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

Questo assicura che Capgo non sovrascriva le tue modifiche 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 bundle nel file principale dell'app:

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

Questo setup assicura che l'app sia pronta per gli aggiornamenti 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'app, formattate come MAJOR.MINOR.PATCH. Ecco come funziona:

• Versione maggiore (X.0.0): Incrementa il numero maggiore per modifiche che rompono la compatibilità.
• Versione minore (1.X.0)Aumenta il numero MINORE per nuove funzionalità compatibili.
• Patch Version (1.0.X)Aumenta il numero PATCH per correzioni di bug che non influiscono sulla compatibilità.

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

Linee guida per il controllo delle versioni

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

• Gestione delle versioni basata sui canali: Organizza 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à.
  • Conserva 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 della piattaforma.

• Configurazione della politica di aggiornamento: Controlla come vengono applicate le aggiornamenti utilizzando le Capgo’s opzioni di configurazione. 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.

• Versione di Ritorno della Strategia: Utilizza gli identificatori di pre-versione per mantenere opzioni di ritorno chiare. Questa approccio 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 : e context capacitor.config.jsonAssicurati che la versione segua il formato SemVer (MAJOR.MINOR.PATCH):

• Bug Fix: Incrementa il numero di PATCH (ad esempio, 1.0.1 → 1.0.2)
• Nuova Funzionalità: Incrementa il numero di MINOR (ad esempio, 1.0.0 → 1.1.0)
• Cambiamento Rottura: Incrementa il numero di MAJOR (ad esempio, 1.0.0 → 2.0.0)

Verifica approfondita della 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: Impone automaticamente le richieste di versione minima.
• Controllo Manuale: Specifica le richieste di versione esatta per gli aggiornamenti.
• Aggiornamento per Canale: Utilizza i canali per test e rilasci in fase di staging.

Capgo CLI Comandi di Aggiornamento

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

# 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 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'applicazione.
• Applica l'aggiornamento alla prossima avviatura.

Per i deployment a livello aziendale, potresti voler integrare l'automazione CI/CD.

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

Problemi di Risoluzione e Consigli

Gestione delle Versioni

Gestire la versione semantica in Capgo può talvolta complicare i deployment degli aggiornamenti. Per evitare di sovrascrivere il tuo lavoro di sviluppo, configura i seguenti elementi 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 aggiornamenti automatici una volta che tutto è stabile.

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

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

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

Controllo della Versione della Squadra

Una volta gestiti gli aggiornamenti individuali, è fondamentale per le squadre stabilire forti pratiche di controllo della 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 da utilizzare come fonte di verità.
• Utilizza canali separati per Capgo ambiente di sviluppo e produzione.
• Automatizza gli upload delle versioni tramite pipeline CI/CD.
• Documenta tutte le code modifiche con messaggi di commit chiari e dettagliati.

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

Passaggi di ripristino dell'aggiornamento

Anche con le precauzioni, gli aggiornamenti possono fallire. Se ciò accade, segui questi passaggi di recupero:

1. Ritorna a un bundle stabile precedente.
2. Incrementa 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'applicazione per assicurarti che funzionino come previsto.

Capgo's updater è progettato per gestire le interruzioni. Ad esempio, se il server non è raggiungibile o un aggiornamento è stato cancellato, l'applicazione continua a funzionare normalmente. [3]. Inoltre, le richieste di rete fallite vengono automaticamente riprovate durante il prossimo avvio dell'applicazione. [3]. Questa resilienza integrata riduce il downtime e garantisce operazioni più fluide.

Riepilogo

La versione semantica, combinata con Capgo, ha reso gli aggiornamenti OTA per le applicazioni Capacitor più efficienti. Con 947,6 milioni di aggiornamenti consegnati e 1.400 applicazioni in produzione che utilizzano questo sistema [1], i processi di distribuzione sono diventati il 81% più efficienti [1]. Questo setup consente ai developer di inviare aggiornamenti velocemente e in modo controllato, bypassando i ritardi degli store di app.

Ecco cosa dicono i developer:

“Abbiamo rilasciato Capgo aggiornamenti OTA in produzione per la nostra base utenti di +5000. Stiamo vedendo un'operazione molto fluida quasi tutti i nostri utenti sono aggiornati in pochi minuti di quando l'OTA viene distribuito su @Capgo.” - colenso [1]

Il sistema di versioning MAJOR.MINOR.PATCH rende facile comunicare cambiamenti di versione, nuove funzionalità e correzioni di bug [5]. Ciò è particolarmente utile per i team 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 versioning semantico con Capgo aggiornamenti OTA

Se stai utilizzando How to Use Semantic Versioning with Capgo OTA Updates per pianificare il rollback e il controllo delle versioni, connettilo con Rollbacks per i dettagli di implementazione in Rollbacks Versione Target context: Pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Intestazione di sezione o pagina. Visto in: pagina soluzioni/version-targeting.astro. Chiave di messaggio `solutions_version_targeting_title` (Titolo delle soluzioni per la versione). | Pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta di UI breve o elemento di navigazione. Visto in: pagina soluzioni/version-targeting.astro. Chiave di messaggio `solutions_version_targeting` (Soluzioni per la versione). per i dettagli di implementazione in Versione Target Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento bundle Capgo Live Updates for the product workflow in Capgo Live Updates.