Vuoi semplificare app updates e il controllo delle versioni? La versione semantica (SemVer) combinata con CapgoGli aggiornamenti Over-The-Air (OTA) di Capgo rendono la gestione Capacitor applicazioni più facili e veloci. Ecco come:
-
Versionamento Semantico Fondamentale: Le versioni utilizzano il formato
MAJOR.MINOR.PATCH:- MAJOR: Per modifiche di base.
- MINOR: Per nuove funzionalità compatibili con il passato.
- PATCH: Per correzioni di bug.
-
Perché Usare SemVer con Capgo?
- Comunicazione chiara sugli aggiornamenti.
- Gestione più intelligente delle versioni.
- Evitare conflitti di dipendenza.
- Pianificazione delle rilasci organizzata.
-
Setup di Capgo Passaggi:
- Installa il plugin di aggiornamento di Capgo.
- Configura la versione del tuo app in
capacitor.config.jsone altri file. - Avvia con la tua chiave di API.
- Utilizza Capgo CLI caricare e pubblicare aggiornamenti.
-
per creare e caricare gli aggiornamenti.:
- Utilizza canali separati (ad esempio, “beta” per le prove, “produzione” per le versioni stabili).
- Utilizza canali separati (ad esempio, "beta" per le prove, "produzione" per le versioni stabili).
- Opzioni di rollback per aggiornamenti falliti.
-
Processo di distribuzione:
- Aggiorna i numeri di versione secondo le regole di SemVer.
- Testa accuratamente prima di distribuire.
- Usa CLI per caricare e distribuire gli aggiornamenti.
Capgo ensures updates reach users quickly and reliably, with tools to handle disruptions and maintain stability. Perfect for teams using CI/CD workflows to automate updates.
Ricetta veloce: Testa sempre gli aggiornamenti e utilizza i canali per gestire i roll-out in fase di staging in modo efficace.
Versionamento Semantico | Migliora il livello
Capgo Setup Guide
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 syncAssicurati che il capacitor.config.json il file utilizza un formato di versione semantica:
{
"appId": "com.example.app",
"appName": "My App",
"version": "1.0.0"
}il file utilizza un formato di versione semantica:
package.jsonPer i progetti più vecchi, aggiorna i dettagli di versione in questi luoghi:version(cerca ilandroid/app/build.gradlecampo)versionName)ios/App/App.xcodeproj/project.pbxprojcampo)CURRENT_PROJECT_VERSION)
Una volta configurato, inizializza Capgo con la tua chiave API.
npx @capgo/cli@latest init YOUR_API_KEYTabella di Riferimento Rapida:
| Setup Phase | Azione Principale | 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 | Crea bundle iniziale | Conferma successo dell'upload |
Integrazione del controllo delle versioni
Capgo funziona bene con piattaforme CI/CD, rendendo aggiornamenti automatizzati facili. Le piattaforme supportate includono:
Se lavori sullo sviluppo locale, puoi disabilitare gli aggiornamenti automatici aggiungendo questo alla tua configurazione:
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": false
}
}
}Ciò garantisce 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 defaultInfine, notifica il plugin nativo dello stato di salute del bundle nel file principale dell'app:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
CapacitorUpdater.notifyAppReady();Questo setup assicura che la tua app sia pronta per le distribuzioni OTA fluide 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): aumenta il numero maggiore per modifiche che rompono la compatibilità.
- Versione Minore (1.X.0): Incrementa il numero di versione minore per nuove funzionalità compatibili.
- Versione di Patch (1.0.X)Aumenta il numero PATCH per i bug fix che non influiscono sulla compatibilità.
| Tipo di Versione | Quando Incrementare | Comportamento dell'Aggiornamento Automatico |
|---|---|---|
| Maggiore (X.0.0) | : Per cambiamenti di rottura API | Richiede approvazione manuale |
| Minore (1.X.0) | : Per nuove funzionalità | Configurabile in Capgo |
| Patch (1.0.X) | Per correzioni di bug | Solitamente automatico |
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 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à.
- Tieni 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 di piattaforma.
-
Politica di Aggiornamento di Configurazione: Controlla come gli aggiornamenti vengono applicati utilizzando le opzioni di configurazione di Capgo.
{ "plugins": { "CapacitorUpdater": { "disableAutoUpdate": "minor" } } }Questo setup garantisce che gli utenti ricevano automaticamente gli aggiornamenti di patch, mentre gli aggiornamenti minori e maggiori richiedono l'approvazione manuale.
-
Versione di Ritorno Strategia: Use pre-release identifiers to maintain clear rollback options. This approach allows you to revert to a previous version if problems occur, while keeping versioning consistent across all channels.
Queste migliori pratiche rendono più facile gestire gli aggiornamenti, testare nuove funzionalità e mantenere la stabilità nel processo di distribuzione dell'app.
sbb-itb-f9944d2
sbb-itb-f9944d2
Una volta pronto il tuo setup di gestione delle versioni, segui questi passaggi per distribuire aggiornamenti OTA in modo efficace.
Preparazione dell'Aggiornamento
Aggiorna la versione in : Inizia aggiornando la versione in Ecco 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 di versione: 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.
Ecco, decidi la tua strategia di aggiornamento. Puoi scegliere tra:
- Auto-Update: Impone automaticamente le richieste di versione minima.
- Controllo Manuale: Specifica le richieste di versione esatta per gli aggiornamenti.
- Channel-BasedUsa i canali per test e rilasci in fase di staging.
Comandi di Aggiornamento Capgo CLI
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 è 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 dashboard di Capgo. Gli aggiornamenti raggiungono gli utenti in pochi minuti dopo che hanno aperto l'app. Il processo funziona in questo modo:
- The app controlla le nuove versioni.
- Scarica l'aggiornamento in background.
- Segna la nuova versione come attiva quando l'utente esce dall'app.
- 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 è fondamentale per consegnare continuamente ai nostri utenti!”
Problemi di Risoluzione e Suggerimenti
Gestione delle versioni
Gestione della versione semantica in Capgo può talvolta complicare le distribuzioni 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
autoUpdateTofalseDurante lo sviluppo. - Disinstalla l'applicazione.
- Riinstallala con la versione corretta.
- Riabilire le aggiornamenti automatici una volta stabilito tutto.
Per aggiornamenti di versione maggiore, utilizza il disableAutoUpdateBreaking flag e ascolta l' majorAvailable event to handle updates properly:
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 delle versioni e ridurre gli errori.
Controllo delle versioni della squadra
Una volta gestiti gli aggiornamenti individuali, è fondamentale per le squadre stabilire forti pratiche di controllo delle versioni.
“Testare ogni modifica prima di unirirla al repository principale rafforzerà la stabilità e eviterà costosi errori” [4]
Ecco alcune metodologie per garantire la consistenza:
- Esegui una sola branca come repository principale repository principale Utilizza canali separati per ambiente di sviluppo e produzione.
- Usa 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 teami più grandi, la seguente matrice di gestione delle versioni può aiutare a organizzare gli aggiornamenti:
| Canale | Channel | Pattino di versione | Versione del Pattern |
|---|---|---|---|
| Sviluppo | dev | Disabilitato | 0.x.x |
| Stagione | beta | Abilitato | x.x.x-beta |
| Produzione | stable | Abilitato | x.x.x |
Passaggi di Recupero dell'Aggiornamento
Anche con le precauzioni, gli aggiornamenti possono fallire. Se ciò accade, segui questi passaggi di recupero:
- Ritorna a un bundle precedente stabile.
- Aggiorna i numeri di versione per qualsiasi nuovo fix (nota: i numeri di versione non possono essere riutilizzati dopo la cancellazione) [2].
- Controlla gli aggiornamenti durante l'avvio dell'app 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]. 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 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 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 OTA aggiornamenti
Se stai utilizzando Come utilizzare la versione semantica con gli aggiornamenti OTA di Capgo per pianificare il rollback e il controllo delle versioni, connettilo con Rollback per i dettagli di implementazione in Rollback Versione di destinazione per i dettagli di implementazione in Versione di destinazione Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento pacchetto per i dettagli di implementazione in pacchetto, e Aggiornamenti in tempo reale di Capgo per il workflow del prodotto in Capgo Aggiornamenti in Tempo Reale.
