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 in tempo reale di Capgo.

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

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

   • Pannello di controllo (1): La vista corrente, che visualizza metriche e sommari chiave.
   • Informazioni (2): Visualizza le impostazioni e i dettagli fondamentali dell'app (vedi sezione "Informazioni sull'app" di seguito).
   • Pacchetti (3): Gestisci le versioni e le rilasci della tua app.
   • Canali (4): Configura e gestisci diversi canali di aggiornamento (ad esempio, produzione, beta).
   • Dispositivi (5): Visualizza e gestisci i dispositivi registrati, compresi l'impostazione di specifiche sovrapposizioni.
   • Log (6):: Accedi a log dettagliati e rapporti di errore per la tua app.
   • Build (7): Visualizza e gestisci i tuoi build dell'applicazione.

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

3. Carte di Riepilogo: Offre un riassunto rapido dei conteggi chiave:

   • Caricamenti Bundle (12): Numero totale di bundle dell'applicazione caricati.
   • Statistiche Aggiornamenti (13): Numero totale di aggiornamenti eseguiti, inclusi richieste, installazioni e fallimenti.
   • Statistiche di Distribuzione (14): Numero totale di distribuzioni.

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 Informazioni sull'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 visualizzato 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 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. Consulta la sezione Configurazione del Canale Predefinito per informazioni dettagliate.
• Elimina Bundle Non Utilizzati (dopo x secondi) (7): Questa 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 un'opzione per iniziare il trasferimento della tua applicazione a un'organizzazione diversa di cui fai parte.
• Elimina App Button: 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 Automatica dei Pacchetti).

Configurazione Canale Predefinito

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

Come Funziona un 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 forzata del dispositivo: Se l'ID del dispositivo viene esplicitamente impostato su un canale nelle impostazioni del canale, quel canale vince sempre.
2. Cloud override: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel pannello di controllo, viene utilizzato quel sovrascrittura.
3. Capacitor config defaultChannel: Se impostato nel tuo capacitor.config.* file, questo viene utilizzato per le build 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 specifici per piattaforma—ad esempio uno per iOS, uno per Android e uno per Electron. Ciò è utile quando:

• Vuoi distribuire aggiornamenti a una piattaforma prima delle altre
• Hai bisogno di strategie di aggiornamento diverse per piattaforma
• Stai testando una nuova versione su una piattaforma mentre mantieni l'altra stabile

Per configurare i valori predefiniti specifici 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. 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 Singolo Predefinito (Raccomandato per la maggior parte degli Applicativi)

Per la maggior parte degli applicativi, un canale predefinito singolo che supporta tutte e tre le piattaforme di base è 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.

Modifica il Canale Predefinito

Quando modifichi il canale predefinito:

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

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