Canali

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):

1. Mappatura forzata del dispositivo: Se l'ID del dispositivo è esplicitamente forzato a un canale (vedere la Lista dei dispositivi forzati impostazioni del canale), quel canale vince sempre.
2. Override Cloud (creato da setChannel() o azione Webapp): Chiamata setChannel (o cambiare il canale di un dispositivo nel pannello di controllo) 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. Ri-istallando l'app non non lo cancella; eliminando l'ingresso del dispositivo ne fa.
3. Capacitor config defaultChannel (configurazione di test predefinita): Per le versioni di test interna / beta puoi impostare defaultChannel (chiave legacy channel) in capacitor.config.* così che i dispositivi di test iniziano su un canale di pre-uscita (ad esempio beta, pr-123). Se assente, il dispositivo procederà alle impostazioni predefinite del cloud. Le versioni di produzione lasciano spesso questo impostato a null.
4. Canale di rete predefinito (strategia principale per ~99% degli utenti): Il canale di produzione principale su cui atterranno quasi tutti gli utenti reali. Qualsiasi nuovo dispositivo senza una forza, senza un sovraccarico e senza una configurazione defaultChannel utilizza questo. Cambiando il canale si distribuisce (o si annulla) per tutti in secondi—nessun nuovo binario.

Perché il canale di rete predefinito è la strada principale:

• Rullata istantanea o annullamento 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 cambiare il canale predefinito.
• Cambiamenti auditabili (i membri della squadra possono vedere chi ha cambiato cosa nella UI / log). Principio di progettazione: Le layer sopra (forza / sovraccarico / configurazione) sono eccezioni (debug singolo utente, QA switching, test build defaults). Gli utenti normali scorrono verso il canale di rete predefinito.

Modificando il canale cloud predefinito affecta nuovi dispositivi normali che:

• Non sono obbligati
• Non hanno già un sovrapposizione cloud
• Non hanno un livello di app definito defaultChannel selezionato

Se un test build parte con defaultChannel: 'beta' e successivamente cambia il canale cloud predefinito a productiondispositivi che sono partiti su beta attraverso la configurazione rimangono lì fino a quando non: (a) li sovrascrivete con setChannel(), (b) li forzate, o (c) cancellate l'ingresso del dispositivo.

Le dispositivi rimangono sul loro canale attuale a meno che non:

• Le forziate su un altro canale.
• Chiama setChannel() context
• o (creando/sovrascrivendo l'override cloud) o cambiarlo manualmente nel dashboard.

Rimuovere / archiviare il canale su cui si trovano (poi cadono nuovamente attraverso la precedenza di nuovo alla prossima verifica).

Se un canale è disabilitato per una piattaforma (vedi interruttori iOS / Android / Electron) e sarebbe stato selezionato altrimenti, la selezione lo ignora e cade su la regola successiva. defaultChannel Nota: Impostare

Capacitor config example

capacitor.config.ts

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

---

Gestione dei canali

Innanzitutto, prendiamo in considerazione la pagina dei canali. Puoi accedervi cliccando sul tuo app e poi cliccando sul pulsante dei canali elenco dei canali.

Lista dei canali

Come potete vedere, esiste un pulsante più in angolo inferiore destro. (1 in l'immagine) Cliccando su di esso si aprirà una finestra modale dove potrete creare un nuovo canale.

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

Cosa significa non configurato correttamente?

A volte la configurazione di un canale non è valida. In quel caso, riceverete un grande avviso e il Misconfigured si dirà Yes per uno o più dei canali. Potete imparare di più su di esso qui

Eliminare un canale

Per eliminare un canale dalla web app, apri il Canali context":"Canali di rilascio Capgo. Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visualizzato in: pagina soluzioni/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Valore della cella visiva del white label delle soluzioni). tab per il tuo app e trova la riga del canale. Nella Azione colonna, clicca sull'icona della spazzatura, quindi clicca Cancella

Riga del canale della colonna delle azioni che mostra l'icona della spazzatura da eliminare. Se l'icona della spazzatura non è visibile, il tuo account non ha i channel.delete La richiesta di autorizzazione 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 API che ha le autorizzazioni:

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

Legato all'organizzazione e all'app Anteprima dell'app La chiave può eliminare solo il canale di anteprima non pubblico e bundlarlo creato con channel delete <preview-channel> <app-id> --delete-bundleNon può cambiare o eliminare un canale predefinito/main esistente, un altro canale di antepriva della chiave, o un altro bundle della chiave. Vedi API Chiavi per la configurazione con le minori autorizzazioni.

Gestione di un canale

Cliccando sul nome del canale si aprirà una finestra modale dove potrai gestire le impostazioni del canale. (3 nel riquadro)

La pagina delle impostazioni del canale contiene tutte le opzioni di configurazione per il tuo canale. Andiamo a esaminare ogni impostazione.

---

Prima la Default channel context Pagina/Area: Capgo Builder / prodotto di costruzione cloud nativa. Ruolo: Etichetta UI breve o elemento di navigazione. Chiave di messaggio `native_build_builder_credit_first` (Primo credito del costruttore di build nativa). toggle. Quando abilitato, questo canale diventa il predefinito per i dispositivi nuovi. 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

---

Configurazione del canale predefinito IOS sezione.

Seconda la Android impostazione. Questo è relativamente semplice. Se questo è falso, i dispositivi iOS non saranno autorizzati a scaricare aggiornamenti da questo canale. IOSTerza è la

Quarto è il Electron impostazione. Questo è simile a IOS e Androidcontexto: Pagina/area: Sito web di marketing Capgo. Ruolo: Etichetta breve UI o elemento di navigazione. Visualizzato in: pagina trust.astro. Chiave di messaggio `and` (E).

. Se questo è falso, gli app di Electron non saranno autorizzate a scaricare aggiornamenti da questo canale. Disable auto downgrade under native Sesto è il 1.2.0 impostazione. Se questo è vero, sarà impossibile scendere di versione da una versione nativa. Ciò significa che se hai caricato una 1.1.0 versione sul negozio di app o su play store e cerchi di impostare la versione del canale su

allora l'aggiornamento (abbassamento) fallirà. Disable auto updateSesto è il . Questa impostazione è piuttosto complessa, e puoi imparare di più su di essa

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

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

Ottavo è il Allow devices to self associatecanale di produzione. Se questo è vero, il metodo setChannel sarà disponibile. Se questo è impostato su false e provi a chiamare il metodo setChannel con questo canale, la chiamata fallirà.

Rulli progressivi

Canale Informazioni la scheda include un Rilascio progressivo sezione. Imposta un bundle di destinazione, scegli il percentuale e la durata della cache decisionale, quindi abilita il rilascio. Dalla stessa sezione puoi sospenderne 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 fallimento superano un certo livello.

I controlli del rilascio progressivo si trovano in cima alla scheda 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 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 per l'ambiente di miglioramento: Staging con un unico ID di App Mobile.