Elenco dei canali
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Come Capgo sceglie un canale (precedenza)
Sezione intitolata “Come Capgo sceglie un canale (precedenza)”Quando un dispositivo chiede a Capgo di aggiornarsi, il canale che verrà utilizzato viene deciso in questo ordine (priorità più alta per prima):
- Mappatura forzata del dispositivo: Se l'ID del dispositivo è esplicitamente impostato su un canale (vedere il lista all'interno delle impostazioni del canale), quel canale vince sempre. Sovrascrittura di Cloud (creata da
- o azione Webapp)
setChannel(): ChiamareForced devicessetChannel(o cambiando il canale di un dispositivo nel dashboard) scrive un sovraccarico persistente nel cloud legato a quell'ID dispositivo. Quel sovraccarico viene consultato dopo la mappatura forzata ma prima di qualsiasi impostazione predefinita. Ripristallando l'app non lo cancella; eliminando l'ingresso dispositivo non lo tocca. __CAPGO_KEEP_0__ config (build di prova predefinito) - Capacitor config
defaultChannel(chiave legacy) indefaultChannelcosì che i dispositivi di prova iniziano su un canale di pre-uscita (ad esempio,channel). Se assente, il dispositivo procederà al default cloud. I costrutti di produzione lasciano spesso questo non impostato.capacitor.config.*Canale Cloud Predefinito (prima strategia per circa il 99% degli utenti)beta,pr-123: Il canale di produzione principale su cui quasi tutti gli utenti reali atterrano. Qualsiasi nuovo dispositivo senza una forza, senza un sovraccarico e senza una configurazione - precederà al canale cloud predefinito.: Per i costrutti di produzione è consigliabile lasciare questo impostato su "" (canale cloud predefinito).
defaultChannelutilizza questo. Cambiarlo rilascia (o annulla) per tutti in secondi—nessun nuovo binario.
Perché il defaut cloud è la strada principale:
- Rilascio o annullamento istantaneo senza ricostruire o ristampare i binari nativi.
- Un posto per gestire il comportamento di iOS, Android e Electron.
- Più sicuro: puoi confermare che i pacchetti esistono e le impostazioni sono corrette prima di passare alla configurazione predefinita.
- Modifiche tracciabili (i membri della squadra possono vedere chi ha modificato cosa nella UI / log). Principio di progettazione: Le layer sopra (forza / sovrascrivi / config) sono eccezioni
(debug utente singolo, QA switching, build di test predefinito). Gli utenti normali scorrono verso la configurazione cloud predefinita. Cambiando la il canale influisce nuovo dispositivi normali che:
- Non sono obbligati
- Non hanno già un sovraccarico cloud
- Non hanno un livello di app
defaultChanneldefinito
Se un test build parte con defaultChannel: 'beta' e successivamente cambiate il cloud predefinito a productioni dispositivi che sono partiti su beta attraverso la configurazione rimangono lì fino a quando non: (a) li sovrascrivete con setChannel() (b) li obbligate, o (c) cancellate l'entry del dispositivo.
i dispositivi rimangono sul loro canale attuale a meno che tu non:
- Forzarli su un altro canale.
- Chiama
setChannel()(creazione/sostituzione dell'override cloud) o modificalo manualmente nel pannello di controllo. - Elimina / archivia il canale su cui si trovano (poi cadrebbero nuovamente attraverso la precedenza di nuovo alla prossima verifica).
Se un canale è disabilitato per una piattaforma (vedi interruttori iOS / Android / Electron) e altrimenti sarebbe stato selezionato, la selezione lo ignora e cade sulla regola successiva.
Nota: Impostare
defaultChannelsignifica che richiede un nuovo binario; utilizzalo intenzionalmente per test/QA, non per il controllo generale di produzione.
Capacitor esempio di configurazione
Sottosezione intitolata “Capacitor esempio di configurazione”// Example: a TestFlight or internal QA build defaults to the beta channel.const config = { plugins: { Capgo: { defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default. // legacy key: channel }, },};export default config;Se in seguito cambierai la dashboard predefinita a productiondispositivi già su un altro canale (tramite config, override o forza) NON si sposteranno automaticamente; solo dispositivi freschi (o quelli di cui hai cancellato l'override/forza) li assumeranno.
Gestione dei canali
Sezione intitolata “Gestione dei canali”In primo luogo, prendiamo in considerazione la pagina dei canali. Puoi accedervi cliccando sul tuo app e poi cliccando sul pulsante dei canali elenco dei canali.

Sezione intitolata “Creazione di un canale”
Come puoi vedere, esiste un pulsante di aggiunta in basso a destra. (Creazione di un canale1 in immagine) Cliccando su di esso si aprirà una finestra modale dove potrai creare un nuovo canale.

Dopo aver cliccato su Add un nuovo canale dovrebbe apparire nella lista.

Cosa significa non configurato correttamente?
Sezione intitolata “Cosa significa non configurato correttamente?”A volte la configurazione di un canale non è valida. In quel caso, riceverai un grande avviso e il Misconfigured colonna dirà Yes per uno o più dei canali.
Puoi imparare di più su di esso qui
Cancellazione di un canale
Sezione intitolata “Eliminare un canale”Per eliminare un canale dall'app web, apri la Canali scheda per il tuo app e trova la riga del canale. Nella Colonna azione colonna, clicca sull'icona della spazzatura, quindi clicca Elimina in il dialogo di conferma.

Se l'icona della spazzatura non è visibile, il tuo account non ha le channel.delete permessi per quella app. Chiedi a un amministratore di organizzazione o app di concedere un ruolo che può eliminare i canali, o elimina il canale con una chiave API che ha i permessi:
npx @capgo/cli@latest channel delete <channel-name> <app-id>Un'organizzazione e un'app legate Anteprima dell'app La chiave dell'app può cancellare solo atomicamente il canale di anteprima non pubblico e il bundle creato con esso. Non può cambiare o cancellare un canale predefinito/main esistente, un altro canale di anteprima di una chiave o il bundle di un'altra chiave. Vedi channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ Chiavi API Keys Gestione del canale
Sezione intitolata “Gestione del canale”
Cliccando sul nome del canale si aprirà una finestra modale dove potrai gestire le impostazioni del canale. (nella immagine)3 Impostazioni del canale

La pagina delle impostazioni del canale contiene tutte le opzioni di configurazione per il tuo canale. Andiamo a esaminare ogni impostazione.
In primo luogo il Default channel toggle. Quando abilitato, questo canale diventa il predefinito per i nuovi dispositivi. Per una spiegazione completa di come funzionano i canali predefiniti, compresa la configurazione delle impostazioni specifiche per piattaforma (una per iOS, una per Android e una per Electron), vedi la sezione Configurazione del Canale Predefinito In secondo luogo l'
impostazione. Questo è relativamente semplice. Se questo è falso, i dispositivi iOS non saranno autorizzati a scaricare aggiornamenti da questo canale. IOS In terzo luogo è l'
impostazione. Questo è simile a Android In quarto luogo è l' IOSimpostazione. Questo è simile a
__CAPGO_KEEP_0__ Electron __CAPGO_KEEP_0__ IOS e Android. Se questo è falso, gli app di Electron non saranno autorizzate a scaricare gli aggiornamenti da questo canale.
Quinto è il Disable auto downgrade under native Impostazione. Se questo è vero, sarà impossibile scendere di versione da una versione nativa. Ciò significa che se hai caricato una 1.2.0 versione nell'archivio dell'app o del play store e cerchi di impostare la versione del canale su 1.1.0 allora l'aggiornamento (abbassamento) fallirà.
Sesto è il Disable auto update. Questa impostazione è piuttosto complessa, e puoi imparare di più su di essa Per quanto riguarda
Se questo è vero, gli app di sviluppo saranno autorizzate a scaricare gli aggiornamenti da questo canale. Se non lo sono, allora qualsiasi richiesta di aggiornamento che ha il Allow development buildimpostato a falso sarà rifiutata. Ciò è utile soprattutto per scopi di testing. prod __CAPGO_KEEP_0__
Settimo è il Allow Emulators. Se questo è falso allora Capgo impedirà qualsiasi richiesta di aggiornamento che proviene da un emulatore. Questo è utile soprattutto per scopi di testing.
Ottavo è il Allow devices to self associate. Se questo è vero allora il metodo setChannel sarà disponibile. Se questo è impostato su falso e provi a chiamare il metodo setChannel con questo canale allora la chiamata fallirà.
Rulli progressivi
Sezione intitolata “Rulli progressivi”Il canale Informazioni tab include una Rilascio progressivo sezione. Imposta un pacchetto di destinazione, scegli il percentuale e la durata della cache di decisione, quindi abilita il rilascio. Dalla stessa sezione puoi sospensione o riprendere l'esposizione, promuovere il target a stabile, ripristinarlo o configurare una sospensione automatica, un rollback o una notifica quando i segnali di fallimento superano un certo livello.

Leggi I rilasci progressivi prima di abilitarne uno. Spiega le cohorti adesive, i cambiamenti di percentuale sicuri e il comportamento di pausa automatica.
Continua da Canali
Sezione intitolata “Continua da Canali”Se stai utilizzando Canali per pianificare la routing dei canali e la distribuzione in fasi, connettilo con Canali per i dettagli di implementazione in Canali, Canali per i dettagli di implementazione in Canali, Soluzione di Test Beta per il flusso di lavoro del prodotto in Soluzione di Test Beta, Soluzione di Targeting della Versione per il flusso di lavoro del prodotto in Soluzione di Targeting della Versione, e Capgo Pratiche di Miglioramento dell'ambiente: Staging con un ID di App Mobile per il contesto pratico in Capgo Pratiche di Miglioramento dell'ambiente: Staging con un ID di App Mobile.