Canali

Copia una riga di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Come Capgo sceglie un canale (precedenza)

When un dispositivo chiede a Capgo un aggiornamento, il canale che utilizzerà è deciso in questo ordine (priorità più alta per prima):

Mapping dispositivo forzato: Se l'ID dispositivo è esplicitamente impostato su un canale (vedi la lista dei dispositivi forzati all'interno delle impostazioni del canale), quel canale vince sempre.
Override Cloud (creato da setChannel() o azione Webapp): Chiamare setChannel (o modificare il canale di un dispositivo nel dashboard) scrive un override persistente nel cloud legato a quell'ID dispositivo. Quell'override viene consultato dopo il mapping forzato ma prima di qualsiasi impostazione predefinita. Ripristallando l'app non lo si cancella; eliminando l'entry del dispositivo non. __CAPGO_KEEP_0__ config
Capacitor config defaultChannel (test build default): Per costruzione interna / beta / di test puoi impostare defaultChannel (chiave legacy channel) in capacitor.config.* così i dispositivi di test iniziano su un canale di rilascio predefinito (ad esempio, beta, pr-123). Se assente, il dispositivo procederà al cloud default. Le costruzioni di produzione lasciano spesso questo non impostato.
Canale Cloud Predefinito (strategia principale per ~99% degli utenti): Il canale di produzione principale in cui quasi tutti gli utenti reali atterrano. Qualsiasi nuovo dispositivo senza una forza, senza un sovraccarico, e senza una configurazione defaultChannel utilizza questo. Cambiando questo distribuisce (o annulla) per tutti in secondi—nessun nuovo binario.

Perché il canale predefinito del cloud è la strada principale:

Rilascio istantaneo o rollback senza ricostruire o ripubblicare i binari nativi.
Un posto per gestire il comportamento di iOS, Android e Electron.
Più sicuro: puoi confermare che i bundle esistono e le impostazioni sono corrette prima di passare a impostazioni predefinite.
Modifiche auditabili (i membri del team possono vedere chi ha modificato cosa nella UI / log). Principio di progettazione: le layer sopra (forzare / sovrascrivere / configurare) sono eccezioni

(debug singolo utente, QA switching, build di test predefinito). La normale flusso degli utenti va verso il cloud predefinito. Cambiare il canale predefinito del cloud influisce su nuovi

dispositivi normali che:
Non hai già un sovrascrittura di cloud
Non hai un app-level definito defaultChannel Se un test build viene spedito con

e successivamente cambi il cloud default a defaultChannel: 'beta' i dispositivi che sono partiti su productionattraverso la configurazione rimangono lì fino a quando non: (a) li sovrascrivi con beta o (b) li forzi, o (c) elimini l'entry del dispositivo. setChannel()I dispositivi rimangono sul loro canale corrente a meno che non

Li forzi su un altro canale.

Chiama
(creando/sovrascrivendo la sovrascrittura di cloud) o cambiandolo manualmente nel dashboard. setChannel() __CAPGO_KEEP_0__
Rimuovi / archivia il canale su cui si trovano (poi ricadranno attraverso la precedenza nuovamente 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 ricade sulla regola successiva.

Nota: impostare defaultChannel significa che richiede un nuovo binario; utilizzalo intenzionalmente per test/QA, non per il controllo generale di produzione.

Esempio di configurazione Capacitor

// 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 il default del dashboard a productioni dispositivi già su un altro canale (tramite configurazione, sovrascrittura o forza) NON si sposteranno automaticamente; solo i dispositivi freschi (o quelli di cui hai cancellato l'override/forza) li assumeranno.

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 lista dei canali Creazione di un canale.

Sezione intitolata “Creazione di un canale”

Come puoi vedere, esiste un pulsante plus in angolo inferiore destro. (

nuovo canale1 Poi dopo aver cliccato su

un nuovo canale dovrebbe apparire nella lista.

__CAPGO_KEEP_0__ Add __CAPGO_KEEP_0__

Cosa significa non configurato correttamente?

A volte la configurazione di un canale non è valida. In tal 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

Per cancellare un canale dall'app web, apri la Sezione canali per il tuo app e trova la riga del canale. Nella Azione clicca sulla icona della spazzatura, quindi clicca su Elimina nella finestra di conferma.

Colonna di azione della riga del canale che mostra l'icona della spazzatura per eliminare

Se l'icona della spazzatura non è visibile, il tuo account non ha i permessi per quell'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 __CAPGO_KEEP_0__ che ha i permessi: channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

Selezionando il nome del canale si aprirà una finestra modale dove potrai gestire le impostazioni del canale.

Cliccando sul nome del canale si aprirà una finestra modale dove potrai gestire le impostazioni del canale.3 nella foto)

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 dei valori predefiniti specifici per piattaforma (uno per iOS, uno per Android e uno 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 Se questo è falso, i dispositivi Android non saranno autorizzati a scaricare aggiornamenti da questo canale. IOSImpostazioni del canale

Quarto è il Electron Impostazione. Questo è simile a IOS e AndroidSe questo è falso, allora gli app di Electron non saranno autorizzati a scaricare gli aggiornamenti da questo canale.

Quinto è il Disable auto downgrade under native Impostazione. Se questo è vero, allora 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 updateImpostazione. Questa impostazione è abbastanza complessa, e puoi imparare di più su di essa Qui

Per quanto riguarda Allow development build. Se questo è vero, i build di sviluppo saranno autorizzati a scaricare aggiornamenti da questo canale. Se non è vero, qualsiasi richiesta di aggiornamento che ha il prod impostato a false verrà rifiutata. Questo è utile soprattutto per scopi di testing.

Settimo è il Allow Emulators. Se questo è falso, Capgo disporrà di qualsiasi richiesta di aggiornamento che proviene da un emulatore. Questo è utile soprattutto per scopi di testing.

Otto è il Allow devices to self associate. Se questo è vero, il setChannel metodo sarà disponibile. Se questo è impostato a false e provi a chiamare il setChannel metodo con questo canale, la chiamata fallirà.

Rulli progressivi

The channel Informazioni tab include un Rilascio progressivo sezione. Imposta un bundle di destinazione, scegli il percentuale e la durata della cache di decisione, quindi abilita il rilascio. Dalla stessa sezione puoi sospendere o riprendere l'esposizione, promuovere il target a stabile, farlo tornare indietro o configurare un'interruzione automatica, un rollback o una notifica quando i segnali di errore superano un certo livello.

Controlli di rilascio progressivo in un canale Capgo — Controlli di rilascio progressivo appaiono in cima alla tab Informazioni del canale.

Leggi Rilasci progressivi prima di abilitarne uno. Spiega le cohorti adesive, i cambiamenti di percentuale sicuri e il comportamento di pausa automatica.

Continua da Canali

Se stai utilizzando Canali per pianificare la routing dei canali e la distribuzione in fase di staging, connettilo con Canali per i dettagli di implementazione in Canali, Canali per i dettagli di implementazione in Canali, Soluzione di Test Beta per il workflow del prodotto in Soluzione di Test Beta, Soluzione di Targeting della Versione per il workflow 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 ambiente di produzione: Staging con un ID di App Mobile.