Capgo Tester di Semver

Verifica la compatibilità della politica del canale contro il baseline nativo inviato come version_build

Versione Baseline Nativa

La versione nativa inviata a Capgo come version_build, dal config o dai metadati dell'app nativa.

Versione Remota

La versione del bundle assegnata al canale risolto.

Contexto dell'App

Piattaforma

Costruzione di sviluppo

Eseguire su emulatore

Impostazioni del canale

Sviluppo per iOS

Consenti aggiornamenti per dispositivi iOS

Sviluppo per Android

Consenti aggiornamenti per dispositivi Android

Consenti costruzione di sviluppo

Consenti aggiornamenti per costruzioni di sviluppo

Consenti emulatori

Consenti aggiornamenti per dispositivi emulatori

Disabilita l'autoabbassamento sotto nativo

Previene l'abbassamento quando si esegue nativo code

Disabilita l'aggiornamento automatico

Versione maggiore: blocca la versione target maggiore maggiore della versione_build. Consente 1.2.3 -> 1.9.0, blocca 1.2.3 -> 2.0.0.

Inserisci due versioni semantiche per visualizzare la comparazione

Cosa significa "Versione di baseline nativa"

Native Baseline Version is the native app version sent to Capgo as version_build when the device asks the update server for a bundle. In a Capacitor app, that value can come from CapacitorUpdater.version da capacitor.config.*. Se quella impostazione non è package.json presente, il plugin ricade sulla versione dell'app nativa da iOS o Android. Non assumere che sia la tua

Capgo still uses version_name sapere quale bundle scaricato è attualmente installato. major, minorpolitiche semver del canale come patch , e version_build.

Capacitor config

__CAPGO_KEEP_0__ config CapacitorUpdater.version Impostare

quando desideri una versione esplicita inviata dall'app. Pro:

facile da mantenere lo stesso per le build di iOS e Android. Con:

la configurazione scaduta può riportare la versione sbagliata se dimentichi di aggiornarla prima di una rilascio nativo.

Versione dell'app nativa CFBundleShortVersionString o Android versionName.

Pro: corrisponde al binario degli utenti installato da TestFlight, App Store, Play Store o test interni.

Con: modificandolo richiede una compilazione nativa e può differire da piattaforma a piattaforma se le impostazioni di rilascio si allontanano.

Target bundle

Confrontalo con le versioni remote del bundle, le regole semver del canale o le restrizioni di caricamento come --native-version.

Pro: prevenendo l'invio di JavaScript che richiede una code nativa più recente per binari di app vecchi.

Con: le regole troppo restrittive possono bloccare aggiornamenti validi fino a quando il canale o i metadati del bundle non vengono aggiustati.

Per questo tester, inserisci il baseline nativo che il dispositivo invia come version_buildpoi, poi, confronta con la versione remota che desideri Capgo consegnare.

Perché Capgo utilizza la versione semantica?

La versione semantica è lo standard di versioning più ampiamente adottato nello sviluppo software. Utilizzando semver, Capgo garantisce compatibilità e sicurezza quando invia aggiornamenti live ai tuoi Capacitor app.

Il standard semver consente a Capgo di capire esattamente quali modifiche sono incluse in ogni aggiornamento:

Aggiornamenti di patch (1.0.0 → 1.0.1): Correzioni di bug, sicure per l'applicazione automatica
Aggiornamenti minori (1.0.0 → 1.1.0): Nuove funzionalità, compatibili con il passato
Aggiornamenti maggiori (1.0.0 → 2.0.0): Cambiamenti dirompenti, richiedono rilascio di app nativa negli store

Questo preclude a Capgo di inviare mai un aggiornamento incompatibile al tuo app nativo code, proteggendo i tuoi utenti da crash e assicurando che l'app rimanga stabile.

Strategie Semver Flessibili: Oltre la Versioning Base

Mentre semver è rigoroso sul suo formato di base, puoi estenderlo per le tue esigenze di squadra utilizzando identificatori di pre-versione e metadati di costruzione:

🏷️ Metadati di Costruzione (+) - La "Layer" Cosmetica

1.2.0+20240315.142530

Timestamp per la tracciatura della distribuzione

1.2.0+ui.refresh.dark-mode

Descrizione dell'aggiornamento UI per il team di design

1.2.0+build.4729.commit.a1b2c3d

Numero di build CI/CD e commit Git

Importante: I metadata di costruzione vengono ignorati nella precedenza della versione - 1.2.0+anything uguale 1.2.0 per la logica di aggiornamento di Capgo.

🔧 Identificatori di versione pre-release (-) - Canali di sviluppo

1.3.0-beta.1

Canale di testing beta

1.3.0-hotfix.payment

Ramo di correzione urgente

1.3.0-feature.newapi

Ramo di testing per nuove funzionalità

Nota: Le versioni pre-release hanno una precedenza inferiore - 1.3.0-beta.1 < 1.3.0

Approccio ibrido - Miglior dei due mondi

1.3.0-rc.1+ui.redesign.20240315

Candidato di rilascio con metadati di interfaccia utente e timestamp

Casi d'uso Semver nel mondo reale & strategie di squadra

🚀 Sviluppo veloce / Startup

0.1.0 - Primo rilascio MVP

0.2.0-beta.1 - Test di nuove funzionalità

0.2.0+ui.v2 - Metadati di ridisegno dell'interfaccia utente

1.0.0 - Pronto per la produzione

Usa 0.x.x per lo sviluppo pre-1.0, metadati per il tracciamento del design

🏢 Imprese / Regolamentate

2.1.0 → Rilascio trimestrale

2.1.1+sec.patch.cve2024 → Patch di sicurezza con tracciamento

2.2.0-rc.1+audit.ready → Candidato di pre-audit

Strict semver con metadati di conformità

🎮 Applicazioni di gioco / creatività

1.0.0+season.winter.2024 → Contenuto stagionale

1.1.0+event.halloween → Caratteristiche di evento

1.2.0+assets.hd.remaster → Aggiornamenti di asset

Metadati creativi per il tracciamento del contenuto

⚡ Strategia di patch veloce

1.2.0 → Produzione corrente

1.2.1-hotfix.payment → Correzione critica di bug

1.2.1+urgent.20240315.1430 → Rilasciato con timestamp

Pre-releasing per la verifica, metadati per il tracciamento della distribuzione

🌍 Strategia multi-piattaforma

1.3.0+ios.optimized → Ottimizzazioni iOS specifiche

1.3.0+android.material3 → Aggiornamenti di design Android

1.3.0+web.pwa.ready → Capacità PWA

Stessa versione, metadati specifici per piattaforma

🔄 Integrazione CI/CD

1.4.0-alpha.1+build.123 → Pre-release automatizzato

1.4.0+deploy.staging.456 → Distribuzione di staging

1.4.0+prod.final.789 → Distribuzione di produzione

Versionamento automatico con metadati di distribuzione

💡 Pro Tip:

Usa i metadati di costruzione (+) per la tracciatura, i timestamp o le informazioni estetiche che non influiscono sulla compatibilità
Usa gli identificatori di versione pre-release (-) per i canali di sviluppo che richiedono una precedenza diversa degli aggiornamenti
Combina entrambi per massima flessibilità: 1.2.0-beta.1+ui.dark.theme.20240315
Ricorda: Capgo rispetta le regole di precedenza semver, quindi pianifica la tua strategia di canale di conseguenza

Importante: Capgo utilizza una versioning semantico rigoroso

A differenza dell'implementazione semver di npm, Capgo segue la specifica SemVer ufficiale in modo rigoroso. npm's node-semver ha delle deviazioni note dalla spec, che possono causare un comportamento imprevisto.

Ad esempio, npm tratta versioni come 1.0.0-alpha.1 differente rispetto a quanto richiesto dalla specifica. Vedi il nostro issue segnalato e tentativo di risoluzione che non è mai stato integrato.

Versioni Semantiche Valide

1.0.0 ✓ Rilascio Standard

2.1.3-alpha ✓ Pre-rilascio

1.0.0-beta.1 ✓ Pre-rilascio con numero

1.0.0+build.1 ✓ Metadati di costruzione

1.0.0-rc.1+build.1 ✓ Versione Completa

Versioni Semantiche Non Valide

v1.0.0 ✗ 'v' iniziale non consentito

1.0 ✗ Mancante la versione di patch

1.0.0.0 ✗ Troppi componenti di versione

1.0.0- ✗ Pre-rilascio vuoto

1.0.0+ ✗ Metadati di costruzione vuoti

Capgo Update Behavior

✓ La strategia minore consente modifiche patch nella stessa linea maggiore.minore, ad esempio 1.0.0 -> 1.0.1

✓ La strategia patch blocca 1.0.0 -> 1.0.1. Consente solo modifiche di suffisso come 1.0.0-beta.1 -> 1.0.0-beta.2

✗ La strategia maggiore blocca i bundle di destinazione con un maggiore maggiore della linea di base nativa, ad esempio 1.0.0 -> 2.0.0

⚠ La protezione del downgrade utilizza la precedenza semver completa, quindi stabile 1.0.0 è più nuovo di 1.0.0-beta.2

Questo strumento segue la specifica di versionamento semantico ufficiale diversamente dall'implementazione di __CAPGO_KEEP_0__ unlike npm's implementation.