Checklist di configurazione una volta sola

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

Invia un nuovo build del negozio per primo

L'installazione del plugin Capgo nel tuo progetto non è sufficiente. Le aggiornamenti OTA funzionano solo su dispositivi che eseguono un'app nativa che già include il plugin.

Dopo aver aggiunto Capgo e chiamato CapacitorUpdater.notifyAppReady():

1. Esegui npx cap sync
2. Costruisci un nuovo binario iOS/Android
3. Invia alla Store, Play Store, TestFlight o alla tua distribuzione interna

Gli utenti con una versione del store più vecchia senza il plugin non riceveranno mai aggiornamenti in tempo reale. L'invio dei bundle a Capgo influisce solo sui dispositivi su un binario Capgo-abilitato.

Vedi anche risoluzione dei problemi.

Regola: i canali sono linee di rilascio (development, production), non biglietti, funzionalità o nomi degli sviluppatori.

---

Checklist di configurazione una volta sola

1. Crea canali: scegli il set più piccolo che si adatta (vedi di seguito).

2. Imposta il canale di caricamento predefinito in impostazioni dell'app:

   • Solo app → production
   • Team → development

3. Canale di produzione: pubblico acceso, dispositivo auto-imposto spento, blocca aggiornamenti sotto native acceso, guardia auto-aggiornamento acceso major.

4. Canale di test (development / staging): pubblico spento, dispositivo auto-imposto acceso per QA.

5. Carica da CI con --delta (checksum e dipendenze native sono automatiche):

   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 gestione delle versioni semanticheVerifica che sia corretta nella testatore SemVer prima di caricarlo.

6. Pubblica in produzione solo dopo aver testato, dal pannello di controllo o CLI.

7. Team e sicurezza: invita una volta, con le minime autorizzazioni, 2FA per l'organizzazione, una sola chiave API in CI.

Lascia l'encryption, min_update_version, metadati e anteprima spento a meno che non abbia una ragione chiara.

---

Scegli la tua dimensione

Semplice: 1 app, 1 canale: production

Team: development + productionCarica 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 ciascuno). Non creare canali aggiuntivi solo perché l'organizzazione è grande.

Treno di rilascio (facoltativo): staging → rc → production. Stesso template su ogni app che ne ha bisogno.

Attenzione

Non utilizzare canali denominati dopo i ticket, le persone o le variabili di CI come ${inputs_capgo_channel}.

---

Nome pacchetto vs commento

I nomi dei bundle sono obbligatori per seguire la versioning semantico . Capgo utilizza semver per le verifiche di compatibilità, le regole di aggiornamento automatico del canale e i rollback. Verifica ogni nome nel tester 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 utenti → commit abc1234 run 28059070270

Usa semver pre-release 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 pre-release: 1.8.0-20260629.1, 1.8.0-beta.2. Non inventare formati personalizzati come fix-login-bug o 2.5.2026062306context":"HTML text fragment from a longer Capgo UI string (parent key `alternatives_cta_questions`). Page/area: Capacitor live-update alternatives comparison page. Role: Long marketing or legal paragraph. Seen in: page alternatives.astro. Preserve Capgo product/brand and developer terms exactly. Message key `alternatives_cta_questions` (Alternatives CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `appflow_cta_questions`). Page/area: Appflow comparison / migration marketing copy. Role: Long marketing or legal paragraph. Seen in: page ionic-appflow.astro. Preserve Capgo product/brand and developer terms exactly. Message key `appflow_cta_questions` (Appflow CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `capwesome_cta_questions`). Page/area: Capawesome comparison page. Role: Long marketing or legal paragraph. Seen in: page capwesome.astro. Preserve Capgo product/brand and developer terms exactly. Message key `capwesome_cta_questions` (Capwesome CTA Questions). | HTML text fragment from a longer Capgo UI string (parent key `consulting_faq_subtitle`). Page/area: Consulting services page. Role: Section subtitle or tagline. Seen in: page consulting.astro. Preserve Capgo product/brand and developer terms exactly. Message key `consulting_faq_subtitle` (Consulting FAQ Subtitle). | Page/area: Appflow comparison / migration marketing copy. Role: Short UI label or navigation item. Seen in: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Message key `appflow_plugins_or` (Appflow Plugins Or).

. Non sono valide semver e le upload falliranno o comporteranno comportamenti imprevedibili. --commentInserisci le note di rilascio in

, non nel nome del bundle. version targeting e bundle versioning.

---

Delta upload

--delta carica un manifesto così i dispositivi scaricano solo i file modificati invece di tutto il bundle ogni volta. Il checksum viene sempre calcolato automaticamente. Non passi 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 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 principale preoccupazione.

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 __CAPGO_KEEP_0__ lo storage reduce Capgo storagee

Scelta: senza il backup zip sul server, dipendi interamente dal percorso del manifesto. Saltare --delta-only se effettivamente hai bisogno delle risparmi di archiviazione.

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

Suggerimento

Vedi Aggiornamenti delta context: Pagina/area: Pagina prodotti/prezzi aziendale. Ruolo: Etichetta breve UI o elemento di navigazione. Visualizzato in: pagina enterprise.astro. Chiave messaggio `enterprise_delta_updates` (Aggiornamenti Delta Aziendali). directUpdate per la risoluzione dei problemi e

---

del comportamento.

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

---

Error comuni

Errore	Risoluzione
Aspettare l'aggiornamento OTA prima di una nuova versione di negozio	Riavviare e distribuire l'app nativa dopo aver aggiunto il plugin
Caricare un bundle ma non distribuirlo in un canale	Assegnare il bundle a un canale (ad esempio production)
Canale per feature, ticket o sviluppatore	Usare solo corsie di rilascio permanenti
Nomi di canale dinamici CI	Nomi fissi: development, production
Troppi canali per un'app semplice	Inizia con 1-2 canali
Dispositivo impostato su produzione	Spento per la produzione, acceso per i canali di test
Saltare --delta	Aggiungi --delta per le upload; utilizza --delta-only solo quando hai bisogno di risparmiare spazio di archiviazione
Nomi di bundle non semver	Segui la versione semantica e valuta in SemVer tester
Cambiamento dello schema di versioning nel tempo	Mantieni semver; utilizza etichette di rilascio pre-ordinato per costruzioni aggiuntive (1.8.0-20260629.1)
Metadata / abilitato anteprima senza motivo	Disabilitato per impostazione predefinita

---

Scopri di più

Canali Impostazioni predefinite, precedenza e routing.

Aggiornamenti a delta Perché e come utilizzare --delta.

CI/CD Automazione dell'upload e della distribuzione.

Bundle Checksum, dipendenze e metadati.