Elenco di configurazione una volta per tutte

Copiare un prompt di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Hai finito l'onboarding onboarding. Ora configura Capgo una volta. Dopo di che, il lavoro quotidiano è solo carica → testa → distribuisci.

Regola: i canali sono corsie di rilascio (development, production), non biglietti, caratteristiche o nomi degli sviluppatori.

Elenco di controllo di configurazione una volta sola

Creare canali: scegliere l'insieme più piccolo che si adatti (vedi di seguito).
Imposta canale di caricamento predefinito in impostazioni dell'app:
- Solo app → production
- Team → development
Canale di produzione: pubblico attivo, impostazione del dispositivo disattivata, blocco aggiornamenti nativi attivo, guardia degli aggiornamenti automatici attiva major.
Canale di test (development / staging: pubblico disattivato, impostazione del dispositivo attivata per le QA.
Carica da CI con --delta (checksum e dipendenze native sono automatiche):
Finestra del terminale
```
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta
```
Il --bundle il valore deve essere valido semantico versioning. Verificalo nel testatore SemVer prima di caricarlo.
Distribuisci in produzione solo dopo aver testato, dal Dashboard o CLI.
Equipe e sicurezza: invita una volta, meno permessi, 2FA per l'organizzazione, un solo API chiave in CI.

Crittografia in uscita, min_update_version, metadati, e anteprima disabilitato se non hai una chiara ragione.

Scegli il tuo dimensione

Semplice: 1 app, 1 canale: production

Team: development + production. Carica su dev, distribuisci su prod.

Versioni native: aggiungi canali solo quando necessario, ad esempio. production-9.0 + test-9.0. Mantieni gli utenti del negozio sul canale di produzione principale.

Molti app: stesso modello semplice per app (di solito uno production ciascuna). Non creare canali aggiuntivi solo perché l'organizzazione è grande.

Treno di rilascio (facoltativo): staging → rc → production. Stessa plantilla in ogni app che ne ha bisogno.

Nome del pacchetto vs commento

I nomi dei pacchetti sono richiesti per seguire la versione semantica. Capgo utilizza semver per le verifiche di compatibilità, le regole di aggiornamento automatico dei canali e le riprese. Verificare ogni nome nel Testatore di SemVer prima dell'upload.

Nome = semver da CI, ad esempio 1.8.0, 1.8.0-beta.1, o 1.8.0-20260629.42
Commento = testo libero per gli utenti → commit abc1234 run 28059070270

Usa semver etichette pre-release (la parte dopo ) quando si rilasciano molte build sotto lo stesso -. Ad esempio, mantieni MAJOR.MINOR.PATCHe aggiungi la data o il contatore di build nella pre-release: 1.8.0 prima dell'upload. 1.8.0-20260629.1, 1.8.0-beta.2. Non inventare formati personalizzati come fix-login-bug o 2.5.2026062306. Saranno rifiutati o comporteranno comportamenti imprevedibili.

Inserisci note sulla versione in --comment, non nel nome del pacchetto.

Vedi anche target di versione e versionamento del pacchetto.

Carica delta

--delta carica un Per i dispositivi scaricano solo i file modificati ogni volta al posto del bundle completo. Il checksum viene sempre calcolato automaticamente. Non passare il flag del checksum. Default:

Sottosezione intitolata “Default: --delta (manifest + zip backup)” `--delta` Finestra del terminale

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

This is the recommended default for most apps. Capgo stores the manifest Economia di storage: Sottosezione intitolata “Economia di storage: --delta-only”

manifesto `--delta-only`

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

Usa --delta-only quando vuoi ridurre lo __CAPGO_KEEP_0__ storage reduce Capgo storageSostituzione: senza il backup zip sul server, ti affidai completamente alla path del manifesto. Saltare

a meno che tu non abbia effettivamente bisogno dei risparmi di storage --delta-only Non è richiesta alcuna configurazione di plugin sul dispositivo. L'aggiornatore legge il manifesto e recupera solo i file modificati.

Suggerimento

Flusso di lavoro quotidiano

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

Errori comuni

Errore	Risoluzione
Aspettativa di OTA prima di una nuova versione di negozio	Riavvia e distribuisci l'app nativa dopo aver aggiunto il plugin
Caricamento di un bundle ma non distribuzione in un canale	Assegna il bundle a un canale (ad esempio `production`)
Canali per feature, ticket o sviluppatore	Usa solo le tratte di rilascio permanenti
Nomine dei canali CI dinamiche	Nomine fisse: `development`, `production`
Troppi canali per un'app semplice	Inizia con 1-2 canali
Dispositivo impostato automaticamente in produzione	Disabilitato per la produzione, abilitato per i canali di test
Salta `--delta`	Aggiungi `--delta` per le upload; utilizza `--delta-only` utilizza solo quando hai bisogno di risparmiare spazio di archiviazione
Nome bundle non semver	Segui la versione semantica e valuta in Testatore di SemVer
Cambiare lo schema di versioning nel tempo	Mantieni semver; utilizza etichette di pre-release per costruzioni aggiuntive (`1.8.0-20260629.1`)
Metadata / abilitato anteprima senza motivo	Disabilita per impostazione predefinita

Scopri di più

Canali Impostazioni, precedenza e routing.

Aggiornamenti Delta Perché e come utilizzare --delta.

CI/CD Automatizza l'upload e la distribuzione.

Buste Checksum, dipendenze e metadati.