Come utilizzare il versioning semantico con Capgo Aggiornamenti OTA

Vuoi semplificare aggiornamenti dell'app e il controllo delle versioni? La versione semantica (SemVer) combinata con Capgogli aggiornamenti Over-The-Air (OTA) rendono più facile e veloce la gestione Capacitor le app. Ecco come:

Basics 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é utilizzare SemVer con Capgo?
- Comunicazione chiara sugli 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. Utilizza Capgo CLI per creare e caricare gli aggiornamenti.
Gestisci Versioni e Canali:
- Utilizza 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 le modifiche principali).
- Opzioni di annullamento per aggiornamenti falliti.
Processo di distribuzione:
- Aggiorna i numeri di versione seguendo le regole SemVer.
- Testa accuratamente prima di distribuire.
- Utilizza 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 flussi di lavoro CI/CD per automatizzare gli aggiornamenti.

Suggerimento 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

Capgo Dashboard di Aggiornamento in Tempo Reale

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

Passaggi di Configurazione Iniziale

Inizia installando il Capgo plugin di aggiornamento:

npm install @capgo/capacitor-updater  
npx cap sync

Assicurati che il tuo capacitor.config.json file utilizzi un formato di versione semantico:

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

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

package.json (cerca il campo version (aggiorna
android/app/build.gradle (aggiorna versionName)
ios/App/App.xcodeproj/project.pbxproj Install the __CAPGO_KEEP_0__ updater plugin 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:

Fase di configurazione	Azioni sulla chiave	Passo di verifica
Installazione	Installa plugin e sincronizza	Controlla `package.json`
Configurazione	Imposta numeri di versione	Verifica in tutti i file
Inizializzazione	Connetti con la chiave API	Stato della connessione di test
Costruisci	Creati il bundle iniziale	Conferma il successo dell'upload

Integrazione del controllo delle versioni

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

Se siete in fase di sviluppo locale, potete disabilitare gli aggiornamenti automatici aggiungendo questo alla vostra configurazione:

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

Ciò assicura che Capgo non sovrascriva le vostre modifiche locali. Una volta pronto il vostro setup, caricare la prima versione:

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

Infine, notificare il plugin nativo sulla salute del bundle nel file principale dell'app:

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

Questa configurazione 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): Incrementa il numero minore per nuove funzionalità che rimangono compatibili.
: Versione di Patch (1.0.X): Tipo di Versione

: Quando incrementare	: Comportamento di Aggiornamento Automatico	: Versione Maggiore (X.0.0)
: Per modifiche __CAPGO_KEEP_0__ che rompono la compatibilità	For breaking API changes	: Versione Minore (1.X.0)
: Incrementa il numero di patch per correzioni di bug che non influiscono sulla compatibilità.	Per nuove funzionalità	Configurabile in Capgo
Patch (1.0.X)	Per correzioni di bug	Di solito automatico

Seguendo le regole di SemVer, puoi semplificare la gestione delle versioni e assicurare 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 configurando 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à.
- 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.
Aggiorna la configurazione della politica: Controlla come vengono applicate le aggiornamenti utilizzando le opzioni di configurazione di Capgo.
```
{
  "plugins": {
    "CapacitorUpdater": {
      "disableAutoUpdate": "minor"
    }
  }
}
```
Esempio:
Questa configurazione garantisce che gli utenti ricevano automaticamente gli aggiornamenti di patch, mentre gli aggiornamenti minori e maggiori richiedono l'approvazione manuale.Strategia di rollback della versione

: Utilizza identificatori di pre-release per mantenere opzioni di rollback chiare. Questo approccio consente di tornare a una versione precedente se si verificano problemi, mantenendo la versioning coerente su tutte le 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

Distribuzione degli Aggiornamenti OTA

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

Preparazione dell'Aggiornamento package.json e capacitor.config.jsonAssicurati che la versione segua il formato SemVer (MAJOR.MINOR.PATCH):

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

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

Successivamente, decidi per la tua Estrategia di aggiornamento. Puoi scegliere da:

Aggiornamento Automatico: Imposta automaticamente le richieste di versione minima.
Controllo Manuale: Specifica le richieste di versione esatta per gli aggiornamenti.
Estrategia per Canali: 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 [channelId] [appId]

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

“@Capgo è un modo intelligente per effettuare push code caldi (e non per tutti i soldi del mondo come con @AppFlow) 🙂”

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

La app controlla 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 CI/CD.

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

Problemi di Risoluzione e Consigli

Issue di Gestione della Versione

La gestione della versione semantica in Capgo può a volte complicare le distribuzioni degli aggiornamenti. Per evitare di sovrascrivere il tuo lavoro di sviluppo, configura i seguenti nel tuo file: capacitor.config.json Se un aggiornamento fallisce, ecco cosa puoi fare:

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

If an update fails, here’s what you can do:

Imposta autoUpdate durante lo sviluppo. false Disinstalla l'applicazione.
Riinstalla l'applicazione con la versione corretta.
Riabilita le aggiornamenti automatici una volta che tutto è stabile.
Per aggiornamenti di versione maggiore, utilizza il flag e ascolta l'evento per gestire gli aggiornamenti in modo corretto:

Combinando queste configurazioni con buone pratiche di squadra, puoi mantenere la consistenza della versione e ridurre gli errori. disableAutoUpdateBreaking Controllo di Versione della Squadra majorAvailable Una volta gestiti gli aggiornamenti individuali, è fondamentale per le squadre stabilire forti pratiche di controllo di versione.

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

Utilizza il flag e ascolta l'evento per gestire gli aggiornamenti in modo corretto: __CAPGO_KEEP_0__

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 eviterà problemi di stabilità e costosi errori” [4]

Ecco alcune metodologie per garantire la consistenza:

Definisci una branca come il repository principale per agire come fonte di verità.
Utilizza canali separati per Capgo ambienti di sviluppo e produzione.
Carica automaticamente le 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:

Ambiente	Canale	Aggiornamento automatico	Versione Pattern
Sviluppo	dev	Disabilitato	0.x.x
Staging	beta	Abilitato	x.x.x-beta
Produzione	stable	Abilitato	__CAPGO_KEEP_0__

Aggiornamento dei passaggi di ripristino

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

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

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]Le richieste di rete fallite vengono automaticamente riprovate durante il lancio successivo dell'applicazione. [3]Questa resistenza integrata riduce il downtime e garantisce operazioni più fluide.

Riepilogo

La combinazione di Semantic Versioning e 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]. Questa configurazione consente agli sviluppatori di inviare aggiornamenti in modo rapido e controllato, bypassando i ritardi degli store di app.

Ecco cosa dicono gli sviluppatori:

“Abbiamo distribuito 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 dopo che l'OTA è stato distribuito a @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 a settimana attraverso la piattaforma di Capgo.

Capgo’s soluzione crittografata, integrata con gli strumenti CI/CD, è anche economica - riducendo i costi di 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 con How to Use Semantic Versioning con Capgo Aggiornamenti OTA

Se stai utilizzando How to Use Semantic Versioning con Capgo Aggiornamenti OTA per pianificare il rollback e il controllo delle versioni, connettilo con Rollbacks per i dettagli di implementazione in Rollbacks, Version Targeting per i dettagli di implementazione in Version Targeting, Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'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.

Come utilizzare la versione semantica con gli aggiornamenti OTA di Capgo