Pagina dell'app
Copia un promemoria di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
What mostra la pagina dell'app?
Sottosezione intitolata “What mostra la pagina dell'app?”Prima, prendiamo in considerazione la pagina principale dell'app:
In Capgo, una pagina dell'app rappresenta la tua applicazione mobile integrata con il sistema di aggiornamento in tempo reale di Capgo. Ti consente di gestire aggiornamenti, canali e dispositivi in modo fluido.

Prendiamo una visione più approfondita di questo. La pagina principale dell'app è divisa in diverse aree chiave:
-
Barramento di navigazione superiore: Fornisce accesso alle viste di gestione dell'app principale. Lo screenshot è illustrativo; il console corrente include:
- Pannello di controllo: Metriche e sommari per l'app.
- Osserva (beta): segnali di lancio nativo, WebView, problema e salute delle rilascio.
- Informazioni: Impostazioni e dettagli dell'applicazione di base (vedi Informazioni sull'applicazione).
- Bundle: Versioni e rilasci.
- Canali: Canali di aggiornamento e controlli di rollout progressivo.
- Dispositivi: Dispositivi registrati e override.
- Log: Log Insights e log raw.
- Costruisce: Gestione di costruzione nativa.
-
Visualizzazione statistiche: Visualizza metriche importanti per il periodo di fatturazione precedente (i dati riflettono l'utilizzo dal tuo giorno di fatturazione, non dal 1° del mese):
- Utenti attivi mensili (8): Rileva il numero di utenti unici attivi nel tempo.
- Spazio di archiviazione (9): Mostra la consumazione di archiviazione corrente.
- Bandwidth (10): Visualizza l'utilizzo di banda.
- Bundle attivo (11): Mostra la distribuzione dei dispositivi attivi across different app bundles.
-
Riepilogo delle schede: Offre una panoramica rapida dei conteggi chiave:
- Caricamenti del bundle (12): Totale numero di bundle dell'app caricati.
- Statistiche degli aggiornamenti (13): Totale numero di aggiornamenti eseguiti, compresi richieste, installazioni e fallimenti.
- Statistiche delle distribuzioni (14): Totale numero di distribuzioni.
-
Opzioni di visualizzazione (15-18): Controlli per la filtrazione e la visualizzazione delle statistiche:
- Giornaliero (15): Visualizza le statistiche in base al giorno.
- Dati cumulativi (16): Visualizza statistiche cumulative nel tempo.
- Periodo fatturazione (17): Visualizza statistiche per il periodo di fatturazione corrente.
- Intervallo di date (18): Seleziona un intervallo di date personalizzato (ad esempio gli ultimi 30 giorni).
Informazioni sull'app
Scheda intitolata “Informazioni sull'app”Questa sezione corrisponde alla scheda “Informazioni” (1) nella barra di navigazione superiore. Ecco dove puoi visualizzare e gestire dettagli e impostazioni cruciali per la tua applicazione.

Lo screenshot è più vecchio della console corrente e non mostra ogni impostazione corrente. Utilizza le descrizioni dei campi di seguito come fonte di verità.
Ecco una panoramica dei campi e delle azioni disponibili:
- Icona dell'applicazione (2): Visualizza l'icona della tua applicazione. Puoi cliccare sul pulsante "Cambia" per caricare un'icona nuova.
- ID dell'applicazione (3): Un identificatore univoco per la tua applicazione all'interno di Capgo. Questo ID non è modificabile.
- Nome dell'applicazione (4): Nome visualizzato per la tua applicazione. Puoi modificarlo se necessario.
- Canale di upload predefinito (5): Specifica il canale predefinito a cui verranno caricati i nuovi pacchetti. Puoi cliccare sull'icona di modifica per selezionare un canale diverso da quello predefinito.
- Canale di download predefinito (6): Specifica il canale predefinito da cui i dispositivi scaricheranno gli aggiornamenti. Puoi cliccare sull'icona di modifica per selezionare un canale diverso da quello predefinito. Vedi la "Configurazione del canale predefinito" Default Channel Configuration Sezione di seguito per informazioni dettagliate.
- Elimina automaticamente le raccolte non utilizzate (dopo x secondi) (7): Questa impostazione consente di eliminare automaticamente le raccolte vecchie che non sono state utilizzate per un determinato periodo di tempo (in secondi). Impostalo su
0per disabilitare l'eliminazione automatica. Ciò aiuta a gestire lo spazio di archiviazione e a mantenere la lista delle raccolte pulita. - Esponi i metadati della raccolta al plugin (8): Abilitando questa funzione, i campi di collegamento e commento della raccolta verranno inviati al Capacitor Updater plugin. Questa funzione richiede una versione del plugin di 7.35.0 o superiore.
- Blocca le richieste di infrastruttura del provider: Quando abilitato, Capgo rifiuta le richieste di aggiornamento, statistiche e channel-self provenienti dalle aree IP dei datacenter di Google e Apple. Lascialo abilitato per il traffico di produzione normale. Disabilitalo temporaneamente solo quando intendi testare intenzionalmente da infrastruttura del provider. Le nuove app abilitano questa protezione per impostazione predefinita; le app esistenti conservano la loro impostazione precedente disabilitata fino a quando non la modifichi.
- Trasferisci la proprietà dell'app (9): Questa sezione fornisce un'opzione per iniziare il trasferimento della tua applicazione a un'organizzazione diversa di cui fai parte.
- Pulsante Elimina App: Elimina permanentemente la tua applicazione da Capgo. Questa azione è irreversibile e rimuoverà tutti i dati associati, le raccolte, i canali e i dispositivi.
- Aggiorna pulsante: Salva tutte le modifiche apportate ai campi modificabili di questa pagina (ad esempio, Nome dell'app, Canale di upload predefinito, Impostazione di eliminazione automatica dei bundle).
Configurazione del canale predefinito
Sottosezione intitolata “Configurazione del canale predefinito”Il Canale di download predefinito è uno dei parametri più importanti per il tuo app. Determina quale canale verrà utilizzato dai nuovi dispositivi per ricevere aggiornamenti quando si connettono a Capgo.
Come funziona il canale predefinito
Sottosezione intitolata “Come funziona il canale predefinito”Quando un dispositivo richiede un aggiornamento da Capgo, il sistema determina quale canale utilizzare in base alla seguente gerarchia di priorità (priorità più alta per prima):
- Mappatura forzata del dispositivo: Se l'ID del dispositivo è esplicitamente impostato su un canale nelle impostazioni del canale, quel canale vince sempre.
- Override Cloud: Se il dispositivo è stato assegnato a un canale tramite
setChannel()o manualmente nel dashboard, viene utilizzato quel override. - Capacitor config
defaultChannel: Se impostato nel tuocapacitor.config.*file, questo viene utilizzato per le build di test/beta. - Canale di Download Predefinito: La impostazione configurata qui—questo è ciò che ~99% dei tuoi utenti di produzione utilizzeranno.
Canali Predefiniti Specifici per Piattaforma
Sezione intitolata “Canali Predefiniti Specifici per Piattaforma”È possibile configurare i canali predefiniti specifici per piattaforma—ad esempio uno per iOS, uno per Android e uno per Electron. Ciò è utile quando:
- Desideri distribuire aggiornamenti a una piattaforma prima delle altre
- You avete bisogno di strategie di aggiornamento diverse per ogni piattaforma
- Stai testando una nuova versione su una piattaforma mentre mantieni le altre stabili
Per impostare i valori predefiniti specifici per ogni piattaforma:
- Creare canali separati per ogni piattaforma (ad esempio
production-ios,production-android, eproduction-electron) - In impostazioni di ogni canale, abilitare solo la piattaforma pertinente (iOS, Android o Electron toggle)
- Segnare entrambi i canali come “Predefinito” - Capgo consente di farlo quando i canali si rivolgono a diverse piattaforme
Quando un dispositivo richiede un aggiornamento:
- i dispositivi iOS riceveranno gli aggiornamenti dal canale predefinito abilitato per iOS
- i dispositivi Android riceveranno gli aggiornamenti dal canale predefinito abilitato per Android
Canale Predefinito Unico (Consigliato per le maggior parte delle Applicazioni)
Sezione intitolata “Canale Predefinito Unico (Consigliato per la maggior parte delle Applicazioni)”For la maggior parte degli applicativi, un singolo canale predefinito che supporta tutte e tre le piattaforme di base è l'approccio più semplice:
- Creare un canale (ad esempio,
production) - Assicurarsi che le opzioni per iOS, Android e Electron siano abilitate
- Marcarlo come canale predefinito
Ciò garantisce un comportamento coerente su tutte le piattaforme e semplifica il tuo workflow di rilascio.
Cambiare il Canale Predefinito
Sottosezione intitolata “Cambiare il Canale Predefinito”Quando cambia il canale predefinito:
- Nuovi dispositivi riceveranno immediatamente aggiornamenti dal nuovo canale predefinito
- Dispositivi esistenti che già hanno un'assegnazione di canale (via override o force) NON passeranno automaticamente a un nuovo canale
- Per spostare dispositivi esistenti, è necessario scegliere tra:
- Usa
setChannel()per sovrascriverli in modo programmatico - Forzarli al nuovo canale nel dashboard
- Eliminare le loro voci di dispositivo (si riregistreranno con il nuovo default)
- Usa
Suggerimento: Prima di rendere il nuovo canale default per tutti gli utenti, testalo sempre con un piccolo gruppo di dispositivi forzati.
Continua da Pagina App
Sezione intitolata “Continua da Pagina App”Se stai utilizzando Pagina App per pianificare dashboard e API operazioni, connettilo con Panoramica API per i dettagli di implementazione in Panoramica API Introduzione per i dettagli di implementazione in Introduzione API Chiavi per i dettagli di implementazione in API Chiavi Dispositivi per i dettagli di implementazione in Dispositivi, e Bundle per i dettagli di implementazione in Bundle.