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 impostato su un canale (la Dispositivi tabella sulle pagine dei canali), quel canale vince sempre. Le mappature forzate sono sovrascritte console/API. Capgo le elimina dopo 90 giorni dall'ultima scrittura di sovrascrittura. Vedi Console e sovrascrittura di API scadono.
2. override Cloud (Dashboard o Public API): Modificare il canale di un dispositivo nel dashboard o tramite il Public API scrive un override legato a quel ID dispositivo. Riinstallando l'app non non lo cancella; cancellando l'override lo si cancella. Lo stesso periodo di conservazione di 90 giorni si applica.
3. Plugin setChannel() (locale): Le versioni correnti dei plugin setChannel() memorizzano il canale sul dispositivo dopo la validazione del backend. Non è un override del dashboard. Riinstallando l'app lo si cancella; l'app deve richiamare setChannel() nuovamente se desideri ancora quel canale.
4. Capacitor config defaultChannel (impostazione predefinita per build di test): Per le build interne / beta / di test puoi impostare defaultChannel (chiave legacy) channelin capacitor.config.* così i dispositivi di test iniziano su un canale di anteprima (ad esempio. beta, pr-123Se assente, il dispositivo procederà al cloud default. Le costruzioni di produzione lasciano spesso questo imdefinito.
5. Canale Cloud Predefinito (strategia principale per ~99% degli utenti): Il canale di produzione principale a cui atterrano quasi tutti gli utenti reali. Qualsiasi nuovo dispositivo senza una forza, senza un sovraccarico, senza una configurazione locale setChannel()e senza una configurazione defaultChannel utilizza questo. Cambiarlo fa rotolare (o annullare) per tutti in secondi, senza una nuova versione binaria.

Perché il canale cloud 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 passare a impostazioni predefinite.
• Cambiamenti tracciabili (i membri del team possono vedere chi ha modificato cosa nella UI / log). Principio di progettazione: Livelli sopra (forza / sovrascrivi / config) sono eccezioni

(debug unico utente, QA switching, build di test predefinito). I normali utenti scorrono verso impostazioni cloud predefinite. Cambiando il canale cloud influisce nuovi

• dispositivi normali che:
• Non sono stati forzati a utilizzare il canale cloud predefinito e non hanno già impostazioni di sovrascrittura cloud
• Non avere un'applicazione defaultChannel definito

Se un testo viene inviato con defaultChannel: 'beta' e successivamente cambiare il cloud predefinito a productioni dispositivi che sono partiti su beta attraverso la configurazione rimangono lì fino a quando non si applica un'assegnazione di priorità più alta, o fino a quando non si invia un binario senza defaultChannel. Eliminare una forza, un sovrascrittura cloud o locale setChannel() non elimina il valore della configurazione; quel fallback rimane fino al nuovo binario.

I dispositivi rimangono sul loro canale attuale a meno che non si faccia:

• Forzarli su un altro canale (console o Public API).
• Cambiare l'override cloud nel dashboard o Public API.
• Chiamare setChannel() (assegnamento locale sulle versioni correnti del plugin).
• Elimina / archivia il canale su cui si trovano (poi ricadranno attraverso la precedenza nuovamente alla prossima verifica).
• Aspetta fino a quando un override console/API scade dopo 90 giorni.
• Rinstabili l'app, che cancella un assegnamento locale ma non un override console/__CAPGO_KEEP_0__. setChannel() assignment but not a console/API override.

Nota: Impostare

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

Sezione intitolata “Esempio di configurazione Capacitor”

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

If cambi di dashboard predefinito in futuro production, dispositivi già su un altro canale (tramite config, override o forza) NON si sposteranno automaticamente; solo dispositivi freschi (o quelli di cui cancelli l'override/forza) li assumeranno.

---

Gestione dei canali

Prima di tutto, andiamo a esaminare la pagina dei canali. Puoi accedervi cliccando sul tuo app e poi cliccando sul pulsante dei canali elenco dei canali.

Sottosezione intitolata “Creazione di un canale”

__CAPGO_KEEP_0__1 Cliccando su di esso si aprirà una finestra modale dove potrai creare un nuovo canale.

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

Cosa significa "impostazioni non valide"?

A volte la configurazione di un canale non è valida. In tal caso, riceverai un grande avviso e la Misconfigured colonna dirà Yes per uno o più dei canali. Puoi imparare di più su questo qui

Cancellazione di un canale

Per eliminare un canale dall'app web, apri il Canali context Pulsante per eliminare il canale Pulsante Pulsante Elimina

Se l'icona della spazzatura non è visibile, il tuo account non ha le autorizzazioni per quel'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 le autorizzazioni: 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>

Una chiave legata all'organizzazione e all'applicazione Anteprima dell'applicazione Una chiave dell'organizzazione e dell'applicazione può cancellare solo atomicamente il canale di anteprima non pubblico e il bundle creato con essa. Non può modificare o cancellare un canale predefinito principale, un altro canale di anteprima della 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”

Impostazioni del canale

Gestione del canale

• Pannello di controllocontext
• Adozione del bundle corrente e statistiche di installazione per questo canale.: Channel settings listed below, plus progressive rollout and Test Update API.
• contextImpostazioni del canale elencate di seguito, più rilascio progressivo e Aggiornamento di prova API. setChannel()Dispositivi Console and API overrides expire.
• Mappature forzate create dalla console o solo da Public __CAPGO_KEEP_0__. Non elenca ogni dispositivo attualmente sul canale, e non elenca dispositivi che hanno utilizzatoVedi
• context: Visualizzazione in anteprima in browser e nativa del bundle collegato. Abilita la visualizzazione del bundle in Informazioni sull'app primo.

Impostazioni dell'informazione

Resta sulla Informazioni scheda. Le impostazioni vengono visualizzate in questo ordine:

Primo, Il canale di download predefinito è un badge di stato, non un toggle. Attivo significa che questo canale è il cloud predefinito per i dispositivi nuovi. Clicca gestisci nelle impostazioni dell'app per modificare il predefinito su Informazioni sull'app. Per i predefiniti specifici per piattaforma (uno per iOS, uno per Android e uno per Electron), vedi la stessa sezione.

secondo il IOS impostazione. Se questo è falso, i dispositivi iOS non saranno autorizzati a scaricare aggiornamenti da questo canale.

terzo è il Android impostazione. Se questo è falso, i dispositivi Android non saranno autorizzati a scaricare aggiornamenti da questo canale.

quarto è il Electron impostazione. Se questo è falso, le app Electron non saranno autorizzate a scaricare aggiornamenti da questo canale.

quinto è il Disable auto downgrade under native impostazione. Se questo è vero, allora sarà impossibile degradare da una versione nativa. Ciò significa che se hai caricato una versione sullo store dell'app o sullo store di Google Play e cerchi di impostare la versione del canale su 1.2.0 allora l'aggiornamento (degradazione) fallirà. 1.1.0 Sesta è la

impostazione. Questa impostazione è piuttosto complessa, e puoi imparare di più su di essa Disable auto updateSedicesima è la impostazione. Sceglie se i dispositivi scaricano un file zip completo, una delta dei file modificati o entrambi. Vedi

Pacchetto di aggiornamento Update package Ottava è la impostazione. Se questo è vero, allora i build di sviluppo saranno consentiti a scaricare gli aggiornamenti da questo canale. Se non lo è, allora qualsiasi richiesta di aggiornamento che ha impostato su false sarà rifiutata. Ciò è utile soprattutto per scopi di testing..

Novantesima è la Allow development buildimpostazione. Sceglie se i dispositivi scaricano un file zip completo, una delta dei file modificati o entrambi. Vedi prod Novantunesima è la

Nona è Allow production build. Se questo è falso, i build di produzione (store) non riceveranno aggiornamenti da questo canale. Lascialo attivo per i canali che servono utenti reali.

Decima è il Allow Emulators. Se questo è falso, Capgo non consentirà alcuna richiesta di aggiornamento che provenga da un emulatore. Questo è utile soprattutto per scopi di testing.

Undicesima è Allow physical devices. Se questo è falso, Capgo rifiuterà le richieste di aggiornamento da parte di telefoni e tablet reali. Lascialo attivo per i canali di produzione.

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

Aggiornamento di prova API

In fondo a Informazioni espandi Aggiornamento di prova API. Capgo mostra un comando curl contro /updates per un dispositivo di esempio su questo canale.

I cambiamenti possono richiedere fino a 60 secondi per apparire nel API a causa della cache. Se il canale non può essere testato, il console vi avverte: il canale richiede almeno una piattaforma (iOS o Android), le build di produzione, i dispositivi fisici e o essere il canale di download predefinito o consentire l'assegnazione del dispositivo da parte dell'utente.

Invia notifica di aggiornamento

Dopo aver modificato il bundle collegato, il console può chiedere di Invia notifica di aggiornamento. Questo mette in coda una notifica silenziosa, quindi i dispositivi sul canale controllano ora il nuovo pacchetto. Configura le credenziali di push per Android e iOS sulla scheda Notifiche dell'app prima di procedere.

Console e sovrascritture di API scadono

Le mappature forzate e le sovrascritture di canale pubblico API vengono eliminate 90 giorni dopo l'ultima scrittura di sovrascrittura. La data dell'ultimo accesso del dispositivo non riavvia questo orologio. Per un'assegnazione che sopravviva a questa pulizia, impostalo defaultChannel in tua Capacitor config (resiste alla reinstallazione, richiede un nuovo binario per cambiarlo) o chiama setChannel() dal tuo app (evita la pulizia dei 90 giorni, ma la reinstallazione lo cancella, quindi l'app deve chiamare setChannel() nuovamente).

Conservazione delle sovrascritture sul tab Devices del canale. Lo stesso avviso compare quando forzi un ID dispositivo sul canale.

Questo è separato da la conservazione dell'inventario dei dispositivi. L'inventario elimina i dispositivi che non si sono collegati a Capgo per 90 giorni. L'override di pulizia elimina anche la mappatura anche se il dispositivo è ancora attivo. Dettagli completi: Console e API override scadono dopo 90 giorni.

Pacchetto di aggiornamento

Apre un canale e rimane sulla Informazioni tab. Pacchetto di aggiornamento è nella lista delle impostazioni, sotto Disabilita l'aggiornamento automatico.

Aggiorna il pacchetto sul canale nella scheda Informazioni. I nuovi canali predefiniti utilizzano Zip e delta.

Questa impostazione sceglie cosa Capgo invia quando un dispositivo su questo canale cerca un aggiornamento. Lascia Zip e delta se non hai bisogno di forzare uno dei due.

Etichetta nella console	CLI / API valore	Cosa i dispositivi scaricano
Zip e delta	all	Un file zip completo e un delta quando entrambi esistono. Questo è il valore predefinito.
Zip solo	zip	Solo il file zip completo.
Delta solo	delta	Solo i file modificati.
Zip solo da builtin	zip_from_builtin	Zip solo mentre il dispositivo è ancora sul binario dello store. Dopo l'aggiornamento live di primo livello, Capgo serve zip e delta nuovamente.
Delta solo da builtin	delta_from_builtin	Delta solo mentre il dispositivo è ancora sul binario dello store. Dopo l'aggiornamento live di primo livello, Capgo serve zip e delta nuovamente.

Integrato è i contenuti web spediti all'interno del binario di App Store o Play Store, prima di qualsiasi Capgo aggiornamento. Utilizza un from builtin modalità quando l'aggiornamento di primo livello dal binario dello store dovrebbe essere zip-solo o delta-solo, e gli aggiornamenti successivi possono utilizzare entrambi.

Capgo non associerà un canale zip-solo con un bundle delta-solo, o il contrario. Il console, CLI, e Il canali API rifiutano il salvataggio e vi dicono di caricare il pacchetto mancante o di cambiare la modalità.

Potete impostare lo stesso valore dalla CLI. Il canale deve già esistere:

npx @capgo/cli@latest channel set production com.example.app --update-package zip

Valori validi: all, zip, delta, zip_from_builtin, delta_from_builtin.

Rullate progressive

Il canale Informazioni La scheda include un Rullata progressiva Sezione. Imposta un pacchetto di destinazione, scegli il percentuale e la durata del cache di decisione, quindi abilita il rullo. Dalla stessa sezione puoi sospendere o riprendere l'esposizione, promuovere il target a stabile, rimandarlo o configurare un'interruzione automatica, un rimbalzo o una notifica quando i segnali di fallimento superano un limite.

I controlli di rullata progressiva appaiono in cima alla scheda Informazioni del canale.

Leggi Rollout progressivo Prima di abilitare uno. Spiega le cohorti adesive, i cambiamenti di percentuale sicuri e il comportamento di pausa automatica.

Continua da Canali

Se stai utilizzando Canali context:Canali, pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta UI breve o elemento di navigazione. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Valore della cella visiva del white label delle soluzioni). per pianificare la routing dei canali e la distribuzione in fase, connettilo con Canali context:Canali, pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta UI breve o elemento di navigazione. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Valore della cella visiva del white label delle soluzioni). 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 per l'ambiente: Staging con un ID di App Mobile per il contesto pratico in Capgo Pratiche per l'ambiente: Staging con un ID di App Mobile.