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 del dispositivo obbligatoria: Se l'ID del dispositivo è esplicitamente impostato su un canale (vedi la Lista dei dispositivi obbligatori lista all'interno delle impostazioni del canale), quel canale vince sempre.
2. Cloud override (creato da setChannel() o azione Webapp: Chiamata setChannel (o modificare il canale di un dispositivo nel pannello di controllo) scrive un sovrascrittura persistente nel cloud legata a quell'ID dispositivo. Quella sovrascrittura viene consultata dopo la mappatura forzata ma prima di qualsiasi impostazione predefinita. Ri-istallando l'app non la cancella; eliminando l'entry del dispositivo __CAPGO_KEEP_0__ config
3. Capacitor config defaultChannel : Per i build interni / beta / test puoi impostare(chiave legacy defaultChannel ) in channelcosì che i dispositivi di test iniziano su un canale di pre-uscita (ad es. capacitor.config.* e.g. beta, pr-123) Se assente, il dispositivo procederà al cloud predefinito.
4. Canale predefinito Cloud (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 il canale si distribuisce (o si annulla) per tutti in secondi—nessun nuovo binario.

Perché il predefinito del cloud è 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.
• Meno pericoloso: puoi confermare che i pacchetti esistono e le impostazioni sono corrette prima di cambiare il 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 single user, QA switching, test build defaults). Flusso degli utenti normali verso il cloud predefinito.

Modificare il canale predefinito del cloud influenza nuovi dispositivi normali che:

• Non sono obbligati
• Non hanno già un sovrascrittura del cloud
• Non hanno un livello di app definito defaultChannel Se un test build parte con

e successivamente cambi il canale predefinito del cloud a defaultChannel: 'beta' __CAPGO_KEEP_0__ productiondispositivi che sono partiti su beta attraverso la configurazione rimangono lì fino a quando non: (a) li sovrascrivete con setChannel()dispositivi rimangono sul loro canale attuale a meno che non:

Forzali su un altro canale.

• Chiamare
• (creazione/sostituzione dell'override cloud) o cambiarlo manualmente nel pannello di controllo. setChannel() Rimuovere / archiviare 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 interfacce iOS / Android / Electron) e sarebbe stato altrimenti selezionato, la selezione lo ignora e cade sulla regola successiva.

Nota: Impostare

significa cambiare richiede un nuovo binario; utilizzalo intenzionalmente per test/QA, non per il controllo generale di produzione. defaultChannel __CAPGO_KEEP_0__ esempio di configurazione

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 impostazione predefinita del dashboard a production, i 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 la sovrascrittura/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.

Creazione di un canale

Come potete vedere, esiste un pulsante con un segno più in angolo in basso a destra. (1 in 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, otterrete un grande avviso e il Misconfigured colonna dirà Yes per uno o più dei canali.\nPuoi imparare di più su di esso qui

Cancellazione di un canale

La cancellazione di un canale è molto semplice. Basta cliccare sull'icona della spazzatura e confermare la cancellazione. (2 nell'immagine)

Gestione di un canale

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

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

---

Prima 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, compreso come configurare i predefiniti specifici per piattaforma (uno per iOS, uno per Android e uno per Electron), vedi la sezione Default Channel Configuration . Secondo il

---

setting. Questo è relativamente semplice. Se questo è falso, i dispositivi iOS non saranno autorizzati a scaricare aggiornamenti da questo canale. IOS Terzo è il

setting. Questo è simile a Android . Se questo è falso, i dispositivi Android non saranno autorizzati a scaricare aggiornamenti da questo canale. IOSQuarto è il

setting. Questo è simile a Electron e IOS and Android. Se questo è falso, gli app di Electron non saranno autorizzate a scaricare 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 update. Questa impostazione è abbastanza complessa, e puoi imparare di più su di essa Qui

Per quanto riguarda Allow development buildSe questo è vero, allora gli aggiornamenti di sviluppo saranno autorizzati a scaricare aggiornamenti da questo canale. Se non lo sono, allora qualsiasi richiesta di aggiornamento che ha il prod impostato a falso sarà rifiutata. Ciò è utile soprattutto per scopi di testing.

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.

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

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 testing beta per il flusso di lavoro del prodotto in Soluzione di testing beta, Soluzione di targeting versione per il flusso di lavoro del prodotto in Soluzione di targeting versione, e Capgo Pratiche di ambiente ottimali: Staging con un ID di app mobile per il contesto pratico in Capgo Pratiche di ambiente ottimali: Staging con un ID di app mobile.