Canali

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

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 il ID dispositivo viene esplicitamente impostato su un canale (vedi la Dispositivi forzati lista all'interno delle impostazioni del canale), quel canale vince sempre.
Cloud override (creato da setChannel() o azione Webapp): Chiamando setChannel (o modificando il canale di un dispositivo nella dashboard) si scrive un sovrapposizione persistente nel cloud legata a quel ID dispositivo. Quella sovrapposizione viene consultata dopo la mappatura forzata ma prima di qualsiasi impostazione predefinita. Riinstallando l'app non si la cancella; eliminando l'entry del dispositivo non.
Capacitor config defaultChannel (impostazione predefinita per build di test): Per i build interni / beta / di test puoi impostare defaultChannel (chiave legacy channel) in capacitor.config.* così i dispositivi di test iniziano su un canale di pre-uscita (ad esempio beta, pr-123). Se assente, il dispositivo procederà al cloud default.
Canale Cloud Predefinito (strategia principale per ~99% degli utenti): La principale produzione del canale raggiunge virtualmente tutti gli utenti reali. Qualsiasi nuovo dispositivo senza una forza, senza un override, e senza una configurazione defaultChannel utilizza questo. Cambiandolo si distribuisce (o si annulla) per tutti in secondi—nessun nuovo binario.

Perché il cloud default è 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.
Maggiore sicurezza: puoi confermare che i pacchetti esistono e le impostazioni sono corrette prima di passare a impostazioni predefinite.
Modifiche tracciabili (gli utenti del team possono vedere chi ha modificato cosa nella UI / log). Principio di progettazione: Layer sopra (forza / sovrascrivi / configurazione) sono eccezioni

(debug single user, QA switching, test build defaults). Flusso degli utenti normali verso il cloud predefinito. Cambiare il canale cloud predefinito influisce su nuovi

dispositivi normali che:
Non sono stati obbligati
Non hanno già un sovrascrittura cloud presente defaultChannel definito

Se un test build viene spedito con defaultChannel: 'beta' e successivamente cambi il cloud default a production, i dispositivi 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'entry del dispositivo.

I dispositivi rimangono sul loro canale corrente a meno che non:

Forzate su un altro canale.
Chiamate setChannel() (creando/sovrascrivendo l'override cloud) o cambiate manualmente in dashboard.
Rimuovete / archiviate 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 iOS / Android / Electron toggle) e altrimenti sarebbe stato selezionato, la selezione lo ignora e cade su la regola successiva.

Nota: Impostazione defaultChannel significa cambiarla richiede un nuovo binario; utilizzala intenzionalmente per test/QA, non per il controllo di produzione generale.

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 cambi il default 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

In primo luogo, prendiamo in considerazione la pagina dei canali. Puoi accedervi cliccando sul tuo app Cliccando sul tuo app e poi cliccando sul pulsante dei canali.

Creazione di un canale

Come potete vedere, esiste un pulsante + nell'angolo in basso a destra. (1 in immagine) Cliccando su di esso si aprirà un modulo dove potrete creare un nuovo canale.

Poi dopo aver cliccato su Add un nuovo canale dovrebbe apparire nell'elenco.

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

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

Sezione intitolata “Gestione di un canale”

Eliminazione di un canale3 nella foto)

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

Prima c'è il Default channel tasto di commutazione. 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 valori predefiniti specifici per piattaforma (uno per iOS, uno per Android e uno per Electron), vedi la sezione Configurazione del Canale Predefinito Secondo c'è l'impostazione

di questa impostazione. Se è falsa, i dispositivi iOS non saranno autorizzati a scaricare aggiornamenti da questo canale. IOS Terzo c'è l'impostazione

di questa impostazione. Questo è simile a Android Se è falsa, i dispositivi Android non saranno autorizzati a scaricare aggiornamenti da questo canale. IOSLet’s go through each setting.

Quarto è il Electron impostazione. Questo è simile a IOS e AndroidSe questo è falso, allora 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, 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 è vero, i build di sviluppo saranno autorizzati a scaricare aggiornamenti da questo canale. Se non è vero, qualsiasi richiesta di aggiornamento che non ha il prod impostato a false verrà rifiutata. Questo è utile soprattutto per scopi di testing.

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

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