Pagina dell'app

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 update, channel e dispositivi in modo fluido.

Analizziamolo più da vicino. La pagina principale dell'app è suddivisa in diverse aree chiave:

1. Barra di navigazione superiore: Fornisce l'accesso alle viste principali di gestione dell'app. Lo screenshot è illustrativo; la console attuale include:

   • Dashboard: Metriche e riepiloghi dell'app.
   • Observe (beta): Segnali su Native launch, WebView, issue e salute del rilascio.
   • Informazioni: Impostazioni e dettagli principali dell'app (vedi Informazioni sull'app).
   • Bundle: Versioni e release.
   • Canali: Canali di update e rollout progressivo.
   • Dispositivi: Dispositivi registrati e override.
   • Log: Analisi dei log e log grezzi.
   • Build: Gestione Native Build.

2. Visualizzazione statistiche: Visualizza le metriche principali dell'ultimo periodo di fatturazione (i dati si riferiscono al tuo ciclo di fatturazione, non al 1° del mese):

   • Utenti Attivi Mensili (8): Monitora il numero di utenti attivi unici nel tempo.
   • Archiviazione (9): Mostra il consumo attuale di storage.
   • Larghezza di banda (10): Visualizza l'utilizzo della banda.
   • Bundle Attivi (11): Mostra la distribuzione dei dispositivi attivi tra i vari bundle dell'app.

3. Schede di Riepilogo: Offre una panoramica rapida dei conteggi principali:

   • Upload di Bundle (12): Numero totale di bundle caricati.
   • Statistiche Update (13): Numero totale di update effettuati, inclusi richieste, installazioni e fallimenti.
   • Statistiche Deployment (14): Numero totale di deployment.

4. 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 del periodo di fatturazione corrente.
   • Intervallo di date (18): Seleziona un intervallo di date personalizzato (es. ultimi 30 giorni).

Informazioni sull'app

Questa sezione corrisponde alla scheda “Information” (1) nella barra di navigazione superiore. Qui puoi visualizzare e gestire i dettagli e le impostazioni cruciali della tua app.

Pagina App Information

Lo screenshot è precedente alla versione attuale della console e non mostra tutte le impostazioni correnti. Fai riferimento alle descrizioni dei campi sottostanti.

Ecco un riepilogo dei campi e delle azioni disponibili:

• Icona dell'app (2): Mostra l'icona della tua applicazione. Puoi cliccare sul pulsante “Change” per fare l'upload di 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 bundle non usati (dopo x secondi) (7): Questa impostazione permette di eliminare automaticamente i vecchi bundle non utilizzati per un periodo specificato (in secondi). Imposta a 0 per disabilitare l'auto-eliminazione. Aiuta a gestire lo storage e a mantenere pulita la lista dei bundle.
• Esponi metadati bundle al plugin (8): Quando abilitata, i campi link del bundle e commenti verranno inviati al plugin Capacitor Updater. Questa funzione richiede la versione 7.35.0 o superiore del plugin.
• Blocca richieste infrastruttura provider: Capgo rifiuta le richieste di update, stats e channel-self provenienti dai range IP noti dei datacenter Google e Apple. Lascialo abilitato per il normale traffico di produzione. Disabilitalo temporaneamente solo se testi intenzionalmente dall'infrastruttura del provider. Le nuove app hanno questa protezione attiva di default; le app esistenti mantengono l'impostazione precedente fino a modifica.
• Trasferisci proprietà app (9): Questa sezione offre l'opzione per avviare il trasferimento della tua applicazione a un'altra organizzazione di cui fai parte.
• Pulsante Elimina App: Elimina permanentemente la tua applicazione da Capgo. Questa azione è irreversibile e rimuoverà tutti i dati, bundle, channel e dispositivi associati.
• Pulsante Update: Salva tutte le modifiche apportate ai campi modificabili in questa pagina (es. App Name, Default Upload Channel, impostazione Auto Delete Bundles).

Configurazione del canale predefinito

Il Canale di download predefinito è una delle impostazioni più importanti per la tua app. Determina da quale canale riceveranno gli aggiornamenti i nuovi dispositivi al primo collegamento con Capgo.

Come funzionano i Default Channels

Quando un dispositivo richiede un aggiornamento a Capgo, il sistema determina quale canale utilizzare in base alla seguente precedenza (dalla priorità più alta):

1. Mappatura forzata del dispositivo: se il device ID è forzato esplicitamente su un canale nelle impostazioni dei canali, quel canale ha sempre la precedenza.
2. Override via Cloud: Se il dispositivo è stato assegnato a un canale tramite la dashboard o API pubblico, viene applicata quella sovrascrittura.
3. 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.
4. Configurazione Capacitor defaultChannel: Se impostato nel tuo capacitor.config.* file, viene utilizzato per le build di test/beta.
5. Canale di Download predefinito: L'impostazione configurata qui. È quella che utilizzerà circa il 99% dei tuoi utenti in produzione.

Canali predefiniti per piattaforma

Puoi configurare canali predefiniti specifici per piattaforma — ad esempio uno per iOS, uno per Android e uno per Electron. Questo è 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:

1. Crea canali separati per ogni piattaforma (ad esempio production-ios, production-android, e production-electron)
2. Nelle impostazioni di ogni canale, abilita solo la piattaforma pertinente (toggle iOS, Android o Electron)
3. Su Informazioni sull'app, imposta ciascun canale come Default Download Channel 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 gli aggiornamenti dal canale predefinito abilitato per Android

Canale predefinito unico (consigliato per la maggior parte delle app)

Per la maggior parte delle applicazioni, un unico canale predefinito che supporti tutte e tre le piattaforme core è l'approccio più semplice:

1. Crea un canale (es. production)
2. Assicurati che i toggle iOS, Android ed Electron siano attivi
3. Impostalo come Default Download Channel su Informazioni sull'app

Questo garantisce un comportamento coerente su tutte le piattaforme e semplifica il tuo workflow di rilascio.

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() (o unsetChannel()) dall'app. Eliminare il record del dispositivo nel backend non rimuove l'assegnazione setChannel() locale.
  • Forzarli sul nuovo canale dal dashboard (console/API override; scade dopo 90 giorni)
  • Eliminare il loro console/API override per seguire la precedenza. I dispositivi con solo il cloud default prenderanno il nuovo default.

Tip: Testa sempre il nuovo canale predefinito con un piccolo gruppo di dispositivi forzati prima di renderlo il default per tutti gli utenti.

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.