📢 canale

📢 Gestisci i canali di distribuzione per gli aggiornamenti dell'app in Capgo Cloud, controllando come gli update vengono inviati ai dispositivi.

➕ Aggiungi

Alias: a

npx @capgo/cli@latest channel add

➕ Crea un nuovo canale di distribuzione in Capgo Cloud per gestire l'invio degli update.

Esempio:

npx @capgo/cli@latest channel add production com.example.app --default

Opzioni:

Parametro	Tipo	Descrizione
-d	boolean	Imposta il canale come predefinito
—self-assign	boolean	Permette al dispositivo di auto-assegnarsi a questo canale
-a	string	chiave API per collegarti al tuo account
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

🗑️ Elimina

Alias: d

npx @capgo/cli@latest channel delete

🗑️ Elimina un canale da Capgo Cloud, con l'opzione di rimuovere i bundle associati per liberare risorse.

Esempio:

npx @capgo/cli@latest channel delete production com.example.app

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
—delete-bundle	boolean	Elimina il bundle associato al canale. Una chiave App Preview può eliminare in modo atomico solo il proprio canale preview e il bundle collegato non condiviso.
—success-if-not-found	boolean	Successo se il canale non viene trovato
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

Attenzione

Usa una chiave legata all'organizzazione e all'app Anteprima App chiave API con --delete-bundle solo per un canale PR preview non pubblico. Il comando utilizza una rotta di pulizia atomica ristretta: ha successo solo per il canale e il bundle non condiviso collegato creato da quella chiave. La chiave non può usarlo su un canale default/main esistente, sul canale di un'altra chiave preview o sul bundle di un'altra chiave, e non riceve comunque permessi generali bundle.delete. Consulta Chiavi API for setup.

📋 Elenco

Alias: l

npx @capgo/cli@latest channel list

📋 Elenca tutti i canali configurati per un'app su Capgo Cloud per rivedere le impostazioni di distribuzione.

Esempio:

npx @capgo/cli@latest channel list com.example.app

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 Ottieni il bundle corrente collegato a un canale specifico nel cloud di Capgo per il tracciamento degli update.

Esempio:

npx @capgo/cli@latest channel currentBundle production com.example.app

Opzioni:

Parametro	Tipo	Descrizione
-c	string	Canale da cui recuperare l'attuale bundle
-a	string	chiave API per collegarti al tuo account
—quiet	boolean	Stampa solo la versione del bundle
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

⚙️ Imposta

Alias: s

npx @capgo/cli@latest channel set

⚙️ Configura le impostazioni di un channel, come collegare un bundle, definire le strategie di update (major, minor, metadata, patch, none) o il targeting dei dispositivi (iOS, Android, dev, prod, emulator, device). Un channel deve essere impostato come default.

Esempio:

npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
-b	string	Numero di versione del bundle da impostare
-s	string	Imposta lo stato del canale: default o normal
—latest-remote	boolean	Recupera l'ultimo bundle caricato sul cloud di capgo e impostalo per il canale
—latest	boolean	Recupera l'ultima versione nel package.json per impostarla sul canale
—downgrade	boolean	Permette il downgrade a una versione inferiore alla Native Build
—no-downgrade	boolean	Disabilita il downgrade a una versione inferiore alla Native Build
—ios	boolean	Permette l'invio dell'update ai dispositivi iOS
—no-ios	boolean	Disabilita l'invio dell'update ai dispositivi iOS
—android	boolean	Consente l'invio di update ai dispositivi Android
—no-android	boolean	Disabilita l'invio di update ai dispositivi Android
—self-assign	boolean	Consente al dispositivo di auto-assegnarsi a questo channel
—no-self-assign	boolean	Impedisce ai dispositivi di auto-assegnarsi a questo channel
—disable-auto-update	string	Blocca gli update per tipo: major, minor, metadata, patch, o none (permette tutto)
—update-package	string	Serve zip, delta, o entrambi: all, zip, delta, zip_from_builtin, o delta_from_builtin
—rollout-bundle	string	Versione del bundle da rilasciare gradualmente su questo channel
—rollout-percentage	string	Percentuale di rollout da 0 a 100
—rollout-percentage-bps	string	Percentuale di rollout in punti base da 0 a 10000
—rollout-enable	boolean	Abilita il rollout configurato
—rollout-disable	boolean	Disabilita il rollout configurato
—rollout-pause	boolean	Pausa l'esposizione del rollout senza fare il rollback sui dispositivi selezionati
—rollout-resume	boolean	Riprendi un rollout in pausa
—rollout-rollback	boolean	Cancella lo stato del rollout e riporta i dispositivi a stable
—rollout-promote	boolean	Promuovi il target di rollout a stable e cancella lo stato di rollout
—rollout-cache-ttl-seconds	string	TTL della cache delle decisioni di rollout di Cloudflare in secondi
—auto-pause-enabled	boolean	Abilita la policy di auto-pause del rollout
—auto-pause-disabled	boolean	Disabilita la policy di auto-pause del rollout
—auto-pause-window-minutes	string	Finestra statistiche per l'auto-pause del rollout
—auto-pause-failure-rate-bps	string	Soglia del tasso di errore in punti base
—auto-pause-confidence	string	Livello di confidenza tra 0 e 1
—auto-pause-min-attempts	string	Minimo tentativi di installazione e fallimento prima dell'auto-pause
—auto-pause-min-failures	string	Minimo numero di errori prima dell'auto-pause
—auto-pause-action	string	Azione di auto-pause: pause, rollback o notify
—auto-pause-cooldown-minutes	string	Cooldown prima che l'auto-pause possa attivarsi di nuovo
—dev	boolean	Consente l'invio di update ai dispositivi di sviluppo
—no-dev	boolean	Disabilita l'invio di update ai dispositivi di sviluppo
—prod	boolean	Consente l'invio di update ai dispositivi di produzione
—no-prod	boolean	Disabilita l'invio di update ai dispositivi di produzione
—emulator	boolean	Consente l'invio di update agli emulatori
—no-emulator	boolean	Disabilita l'invio dell'update agli emulatori
—device	boolean	Abilita l'invio dell'update ai dispositivi fisici
—no-device	boolean	Disabilita l'invio dell'update ai dispositivi fisici
—qr-preview	boolean	Stampa un QR code nel terminale per l'anteprima di questo canale dopo l'aggiornamento
—send-update-notification	boolean	Invia una notifica nativa di controllo aggiornamenti ai dispositivi dopo l'aggiornamento del bundle del canale collegato
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)
—ignore-metadata-check	boolean	Ignora il controllo della compatibilità di node_modules se presente nel bundle
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)