Pagina dell'app

Cosa mostra la pagina dell'app?

In primo luogo, prendiamo in considerazione la pagina principale dell'app:

In Capgo, un'app rappresenta la tua applicazione mobile integrata con il sistema di aggiornamento live di Capgo_. Consente di gestire aggiornamenti, canali e dispositivi in modo fluido.

Ecco una panoramica più dettagliata. La pagina principale dell'app è divisa in diverse aree chiave:

1. Barra di navigazione superiore: Fornisce accesso alle diverse sezioni della gestione dell'app:

   • Pannello di controllo (1): La vista corrente, che visualizza metriche e sommari chiave.
   • Informazioni (2): Mostra le impostazioni e i dettagli dell'app (vedi sezione “Informazioni sull'app” di seguito).
   • Bundle (3): Gestisci le versioni e le rilasci dell'app.
   • Canali (4): Configura e gestisci diversi canali di aggiornamento (ad esempio, produzione, beta).
   • Dispositivi (5): Visualizza e gestisci i dispositivi registrati, inclusa la configurazione di override specifici.
   • Log (6): Accedi a log dettagliati e rapporti di errore per la tua app.
   • Builds (7): Visualizza e gestisci i build della tua app.

2. Statistiche Visualizzazione: 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): Segnala il numero di utenti unici attivi nel tempo.
   • Archiviazione (9): Mostra la consumazione di archiviazione corrente.
   • Bandwidth (10): Visualizza l'utilizzo di banda.
   • Bundle Attivo (11): Mostra la distribuzione dei dispositivi attivi su diversi bundle dell'applicazione.

3. Riepilogo delle schede: Offre un'anteprima rapida dei conteggi chiave:

   • Caricamenti di Bundle (12): Totale di bundle dell'applicazione caricati.
   • Statistiche degli Aggiornamenti (13): Totale di aggiornamenti eseguiti, compresi richieste, installazioni e fallimenti.
   • Statistiche delle Distribuzioni (14): Totale di distribuzioni effettuate.

4. Opzioni di Visualizzazione (15-18): Controlli per la filtrazione e la visualizzazione delle statistiche:

   • Giornaliero (15): Visualizza le statistiche in base alla giornata.
   • 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 (ad esempio, gli ultimi 30 giorni).

Informazioni sull'applicazione

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.

Pagina delle Informazioni dell'App

Ecco una panoramica dei campi e delle azioni disponibili:

• Icona dell'App (2): Visualizza l'icona della tua applicazione. Puoi cliccare sul pulsante “Cambia” per caricare una nuova icona.
• ID dell'App (3): Un identificatore univoco per la tua applicazione all'interno di Capgo. Questo ID non è modificabile.
• Nome dell'App (4): Il nome di visualizzazione per la tua applicazione. Puoi modificarlo se necessario.
• Canale di Caricamento Predefinito (5): Specifica il canale predefinito a cui verranno caricati nuovi bundle. 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 di download predefinito diverso. Vedi la sezione Configurazione del canale predefinito per informazioni dettagliate.
• Elimina automaticamente bundle non utilizzati (dopo x secondi) (7): Il presente impostazione consente di eliminare automaticamente i bundle vecchi che non sono stati utilizzati per un periodo di tempo specificato (in secondi). Impostalo su 0 per disabilitare l'eliminazione automatica. Ciò aiuta a gestire lo spazio di archiviazione e a mantenere la lista dei bundle pulita.
• Esponi i metadati del bundle al plugin (8): Abilitando questa funzione, i campi di collegamento e commento dei bundle verranno inviati al plugin di aggiornamento Capacitor. Questa funzione richiede almeno la versione 7.35.0 del plugin.
• Trasferisci la proprietà dell'app (9): Questa sezione fornisce l'opzione di iniziare il trasferimento della tua applicazione a un'organizzazione diversa di cui fai parte.
• Elimina l'app: Elimina permanentemente la tua applicazione da Capgo. Questa azione è irreversibile e rimuoverà tutti i dati associati, i pacchetti, i canali e i dispositivi.
• Aggiorna Button: Salva qualsiasi modifica che hai fatto ai campi modificabili di questa pagina (ad esempio, Nome Applicazione, Canale di Caricamento Predefinito, Impostazione di Eliminazione dei Pacchetti Auto).

Configurazione del Canale Predefinito

Il Canale di Download Predefinito è uno dei più importanti impostazioni per la tua app. Determina quale canale i nuovi dispositivi riceveranno aggiornamenti quando si connettono per la prima volta a Capgo.

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):

1. Mappatura del dispositivo obbligatoria: Se l'ID dispositivo viene esplicitamente impostato su un canale nei impostazioni del canale, quel canale vince sempre.
2. Cloud override: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel dashboard, quel sovraccarico viene utilizzato.
3. Capacitor config defaultChannel: Se impostato nel tuo capacitor.config.* file, questo viene utilizzato per le costruzioni di test/beta.
4. Canale di download predefinito: La impostazione configurata qui—questo è ciò che ~99% dei tuoi utenti di produzione utilizzeranno.

Canali predefiniti specifici per piattaforma

Puoi 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 un piattaforma prima delle altre
• Hai bisogno di strategie di aggiornamento diverse per ogni piattaforma
• Stai testando una nuova versione su una piattaforma mentre mantieni l'altra stabile

Per impostare i valori predefiniti specifici per ogni 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 (iOS, Android o Electron toggle)
3. Segna 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 aggiornamenti dal canale predefinito abilitato per iOS
• I dispositivi Android riceveranno aggiornamenti dal canale predefinito abilitato per Android

Canale Predefinito Unico (Raccomandato per le maggior parte delle App)

Per la maggior parte degli applicativi, un canale predefinito singolo che supporta tutte e tre le piattaforme core è l'approccio più semplice:

1. Crea un canale (ad esempio, __CAPGO_KEEP_0__) production)
2. Assicurati che le impostazioni per iOS, Android e Electron siano abilitate
3. Etichettalo come canale predefinito

Ciò garantisce un comportamento coerente su tutte le piattaforme e semplifica il tuo flusso di rilascio.

Cambiare il Canale Predefinito

Quando cambia il canale predefinito:

• I dispositivi nuovi inizieranno immediatamente a ricevere aggiornamenti dal nuovo canale predefinito
• I dispositivi esistenti quelli che già hanno un'assegnazione del canale (via override o force) NON passeranno automaticamente
• Per spostare dispositivi esistenti, è necessario scegliere tra:
  • Usare setChannel() per sovrascriverli in modo programmatico
  • Forzarli al nuovo canale nella dashboard
  • Cancellare le loro voci di dispositivo (si riregistreranno con il nuovo default)

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