Pagina dell'app
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Cosa mostra la pagina dell'app?
Sezione intitolata “Cosa mostra la pagina dell’app?”Per prima cosa, diamo un’occhiata alla pagina principale dell’app:
In Capgo, un'app rappresenta la tua applicazione mobile integrata con il sistema live update di Capgo. Ti permette di gestire aggiornamenti, canali e dispositivi senza problemi.

Diamo un'occhiata più da vicino. La pagina principale dell'app è divisa in diverse aree chiave:
-
Barra di navigazione superiore: Consente di accedere alle viste principali di gestione dell'app. Lo screenshot è illustrativo; la console attuale include:
- Dashboard: Metriche e riepiloghi per l'app.
- Observe (beta): segnali di avvio nativo, WebView, problemi e stato delle release.
- Informazioni: Impostazioni e dettagli principali dell'app (vedi Informazioni sull'app).
- Bundle: Versioni e rilasci.
- Canali: Canali di aggiornamento e controlli per il rollout progressivo.
- Dispositivi: Dispositivi registrati e override.
- Log: Analisi dei log e log grezzi.
- Build: Gestione delle build native.
-
Visualizzazione statistiche: Visualizza le metriche principali dell'ultimo periodo di fatturazione (i dati riflettono l'utilizzo dal giorno di fatturazione, non dal 1° del mese):
- Utenti attivi mensili (8): Traccia il numero di utenti attivi univoci nel tempo.
- Archiviazione (9): Mostra il consumo di archiviazione attuale.
- Bandwidth (10): Visualizza l'utilizzo della bandwidth.
- Bundle attivo (11): Mostra la distribuzione dei dispositivi attivi tra i diversi bundle dell'app.
-
Card riepilogative: Offre una panoramica rapida dei conteggi principali:
- Upload di bundle (12): Numero totale di bundle dell'app caricati.
- Statistiche aggiornamenti (13): Numero totale di aggiornamenti eseguiti, inclusi richieste, installazioni e fallimenti.
- Statistiche deployment (14): Numero totale di deployment.
-
Opzioni di visualizzazione (15-18): Controlli per filtrare e visualizzare le statistiche:
- Giornaliero (15): Visualizza le statistiche su base giornaliera.
- Cumulativo (16): Visualizza le statistiche cumulative nel tempo.
- Periodo di fatturazione (17): Visualizza le statistiche per il periodo di fatturazione corrente.
- Intervallo di date (18): Seleziona un intervallo di date personalizzato (es. ultimi 30 giorni).
Informazioni sull'app
Sezione intitolata “Informazioni sull'app”Questa sezione corrisponde alla scheda “Informazioni” (1) nella barra di navigazione superiore. Qui puoi visualizzare e gestire i dettagli e le impostazioni fondamentali della tua applicazione.

Lo screenshot è più vecchio della console attuale e non mostra tutte le impostazioni correnti. Usa le descrizioni dei campi qui sotto come riferimento affidabile.
Ecco un riepilogo dei campi e delle azioni disponibili:
- Icona dell'app (2): Mostra l'icona della tua applicazione. Puoi fare clic sul pulsante “Cambia” per caricare una nuova icona.
- ID App (3): Un identificatore univoco per la tua applicazione all'interno di Capgo. Questo ID non è modificabile.
- Nome app (4): Il nome visualizzato della tua applicazione. Puoi modificarlo se necessario.
- Canale di upload predefinito (5): Specifica il canale predefinito a cui verranno caricati i nuovi bundle. Puoi cliccare sull'icona di modifica per selezionare un altro canale 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 altro canale predefinito. La pagina del canale mostra se un canale è quello predefinito, ma lo cambi qui, non con un toggle sul canale. Apri un canale e clicca Gestisci nelle impostazioni dell'app per passare a questo campo. Consulta la sezione Configurazione del canale predefinito qui sotto per informazioni dettagliate.
- Eliminazione automatica dei bundle non utilizzati (dopo x secondi) (7): Questa impostazione consente di eliminare automaticamente i bundle vecchi non utilizzati per un periodo specifico (in secondi). Imposta su
0per disattivare l'eliminazione automatica. Questo aiuta a gestire lo storage e a mantenere l'elenco dei bundle ordinato. - Esposizione dei metadati del bundle al plugin (8): Se abilitato, i campi link e commento del bundle verranno inviati al plugin Capacitor Updater. Questa funzione richiede la versione 7.35.0 o superiore del plugin.
- Blocco delle richieste di infrastruttura del provider: Se abilitato, Capgo rifiuta le richieste di aggiornamento, statistiche e canale-self dagli intervalli di IP dei datacenter noti di Google e Apple. Lascialo abilitato per il traffico di produzione normale. Disabilitalo temporaneamente solo se testi intenzionalmente dall'infrastruttura del provider. Le nuove app abilitano questa protezione in modo predefinito; le app esistenti mantengono l'impostazione precedente disabilitata finché non la modifichi.
- Trasferimento della proprietà dell'app (9): Questa sezione offre un'opzione per avviare il trasferimento della tua applicazione a un'altra organizzazione di cui fai parte.
- Pulsante Elimina App: Elimina definitivamente la tua applicazione da Capgo. L'azione è irreversibile e rimuove tutti i dati, i bundle, i canali e i dispositivi associati.
- Pulsante di aggiornamento: Salva le modifiche apportate ai campi modificabili di questa pagina (ad es. Nome app, Canale di upload predefinito, impostazione Eliminazione automatica bundle).
Configurazione del canale predefinito
Sezione intitolata “Configurazione del canale predefinito”Il Canale di download predefinito è una delle impostazioni più importanti per la tua app. Determina da quale canale i nuovi dispositivi riceveranno gli aggiornamenti quando si collegano per la prima volta a Capgo.
Come funzionano i canali predefiniti
Sezione intitolata “Come funzionano i canali predefiniti”Quando un dispositivo richiede un aggiornamento a Capgo, il sistema determina quale canale usare in base alla seguente precedenza (a partire dalla priorità più alta):
- Mapping forzato del dispositivo: se il device ID viene forzato esplicitamente su un canale nelle impostazioni del canale, quel canale ha sempre la precedenza.
- Override cloud: Se il dispositivo è stato assegnato a un canale dalla dashboard o tramite Public API, viene applicata quella sovrascrittura.
- Plugin
setChannel(): Nelle versioni attuali del plugin si tratta di un'assegnazione locale, non di una sovrascrittura dalla dashboard. Vedi Come un dispositivo sceglie un canale. - Configurazione Capacitor
defaultChannel: Se impostato nel tuocapacitor.config.*file, viene utilizzato per le build di test/beta. - Canale di download predefinito: L'impostazione configurata qui. È quella che utilizzerà circa il 99% dei tuoi utenti in produzione.
Canali predefiniti per piattaforma
Sezione intitolata “Canali predefiniti per piattaforma”Puoi configurare canali predefiniti specifici per piattaforma — ad esempio uno per iOS, uno per Android e uno per Electron. È utile quando:
- Vuoi rilasciare gli aggiornamenti su una piattaforma prima dell'altra
- Hai bisogno di strategie di aggiornamento diverse per ogni piattaforma
- Stai testando una nuova versione su una piattaforma mantenendo l'altra stabile
Per impostare i default per piattaforma:
- Crea canali separati per ogni piattaforma (ad esempio
production-ios,production-android, eproduction-electron) - Nelle impostazioni di ogni canale, abilita solo la piattaforma pertinente (toggle iOS, Android o Electron)
- Su Informazioni sull'app, imposta ciascuno di questi canali come canale di download predefinito per la sua piattaforma. Capgo permette più di un default quando i canali puntano a piattaforme diverse.
Quando un dispositivo richiede un aggiornamento:
- I dispositivi iOS riceveranno gli aggiornamenti dal canale di default abilitato per iOS
- I dispositivi Android riceveranno aggiornamenti dal canale predefinito abilitato per Android
Canale predefinito unico (consigliato per la maggior parte delle app)
Sezione intitolata “Canale predefinito singolo (consigliato per la maggior parte delle app)”Per la maggior parte delle applicazioni, un singolo canale predefinito che supporta tutte e tre le piattaforme principali è l'approccio più semplice:
- Crea un canale (ad es.,
production) - Assicurati che i toggle per iOS, Android ed Electron siano abilitati
- Impostalo come Canale di download predefinito su Informazioni sull'app
Questo garantisce un comportamento coerente su tutte le piattaforme e semplifica il workflow di release.
Cambiare il canale predefinito
Sezione intitolata “Cambiare il canale predefinito”Quando cambi il canale predefinito:
- Nuovi dispositivi inizieranno subito a ricevere gli aggiornamenti dal nuovo default
- Dispositivi esistenti che hanno già un canale assegnato (tramite override o force) NON passeranno automaticamente
- Per spostare i dispositivi esistenti, devi:
- Usa
setChannel()(ounsetChannel()) dall'app. Eliminare il record del dispositivo nel backend non rimuove l'assegnazionesetChannel()locale. - Forzarli sul nuovo canale nella dashboard (console/API override; scade dopo 90 giorni)
- Eliminare il loro override console/API così ricadono nella precedenza. I dispositivi con solo il default cloud adottano poi il nuovo default.
- Usa
Tip: Testa sempre il nuovo canale predefinito con un piccolo gruppo di dispositivi forzati prima di impostarlo come default per tutti gli utenti.
Continua dalla pagina dell'app
Sezione intitolata “Continua dalla pagina dell'app”Se stai usando Pagina dell'app per pianificare le operazioni della dashboard e di API, collegalo a Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione delle chiavi API, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio di implementazione in Bundles.