Elenco di controllo di configurazione una volta sola

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

Hai finito l'acquisizione. 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 sviluppatori.

Elenco di configurazione una volta sola

Crea canali : scegli l'insieme più piccolo che si adatti (vedi di seguito).
Imposta canale di upload predefinito in impostazioni dell'app:
- Solo app → production
- Team → development
Canale di produzione: pubblico attivato, dispositivo auto-impostato disattivato, blocca aggiornamenti sotto nativo attivato, guardia di aggiornamento automatico attivato major.
Canale di test (development / staging: pubblico spento, dispositivo impostato su on per QA.
Carica da CI con --delta (il calcolo del checksum e le dipendenze native sono automatici):
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 valore deve essere valido semantica versioning. Verifica prima di caricare. Testatore SemVer prima di caricare.
Pubblica in produzione solo dopo aver testato, dal pannello di controllo o CLI.
Team & sicurezza: invita una volta, almeno i permessi, 2FA per l'org, un solo API chiave in CI.

Lascia l'encryption, min_update_versionDati, metadati e anteprima spento se hai una ragione chiara.

Scegli la tua 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 per ogni). Non creare canali aggiuntivi solo perché l'org è grande.

Rilascio train (facoltativo): staging → rc → production. Stesso template su ogni app che ne ha bisogno.

Nome del pacchetto vs commento

Il nome del pacchetto sono richiesto da seguire semantica Capgo utilizza semver per le verifiche di compatibilità, le regole di aggiornamento automatico e le annullazioni. Verifica ogni nome nel Testatore di SemVer prima dell'upload.

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

Usa semver versione di anteprima etichette (la parte dopo -) quando rilasciate molti build sotto lo stesso MAJOR.MINOR.PATCH. Ad esempio, conserva 1.8.0 e aggiungi la data o il contatore di build nella versione di anteprima: 1.8.0-20260629.1, 1.8.0-beta.2. Non inventare formati personalizzati come fix-login-bug o 2.5.2026062306. Non sono validi semver e le pubblicazioni falliranno o comporteranno comportamenti imprevedibili.

Inserisci note di rilascio in --comment, non nel nome del pacchetto.

Vedi anche target di versione e gestione della versione del pacchetto.

Carica Delta

--delta carica manifesto in questo modo i dispositivi scaricano solo i file modificati ogni volta e non il pacchetto completo. Il checksum viene sempre calcolato automaticamente. Non è necessario specificare un flag di checksum.

Predefinito: `--delta` (manifesto + backup zip)

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

Questo è il valore consigliato predefinito per la maggior parte degli app. Capgo memorizza il manifesto e conserva il file zip completo come backup. Buono quando il costo dello storage non è la tua preoccupazione principale.

Salvataggio di storage: `--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 storage di __CAPGO_KEEP_0__ reduce Capgo storageTrade-off: senza il backup del file zip sul server, ti affidai completamente alla path del manifesto. Saltare

Scegli questa opzione quando desideri ridurre lo storage di __CAPGO_KEEP_0__. --delta-only se non hai bisogno dei risparmi di archiviazione.

Non è richiesta alcuna configurazione di plugin aggiuntiva sul dispositivo. L'aggiornatore legge il manifesto e recupera solo i file modificati.

Ciclo di lavoro quotidiano

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

Errori comuni

Errore	Soluzione
Sperare nell'aggiornamento OTA prima di una nuova versione del negozio	Riavviare e distribuire l'app nativa dopo aver aggiunto il plugin
Caricare un bundle ma non distribuirlo in un canale	Assegna il bundle a un canale (ad esempio `production`)
Canale per feature, ticket o sviluppatore	Usare solo corsie di rilascio permanenti
Nomi di canale dinamici	Nomi fissi: `development`, `production`
Troppi canali per un'app semplice	Inizia con 1-2 canali
Dispositivo impostato automaticamente su produzione	Spento per la produzione, acceso per i canali di test
Salta `--delta`	Aggiungi `--delta` agli upload; utilizza `--delta-only` solo quando hai bisogno di risparmiare spazio di archiviazione
Nomignoli di bundle non semver	Segui la versione semantica e valuta in Verificatore 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	Disabilitato per impostazione predefinita

Scopri di più

Canali Impostazioni, precedenza e routing.

Aggiornamenti delta Perché e come utilizzare --delta.

CI/CD Automatizza l'upload e il deploy.

Pacchetti Checksum, dipendenze e metadati.