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. Ti consente di gestire gli aggiornamenti, i canali e i dispositivi in modo fluido.

Prendiamo una visione più approfondita di questo. 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): Visualizza le impostazioni e i dettagli fondamentali del tuo app (vedi sezione “Informazioni sull'app” di seguito).
   • Bundle (3): Gestisci le versioni e le rilasci del tuo 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 override.
   • Log (6): Accedi ai log dettagliati e ai rapporti di errore per il tuo app.
   • Costruzioni (7): Visualizza e gestisci le costruzioni del tuo app.

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): Rileva il numero di utenti unici attivi nel tempo.
   • Archiviazione (9): Mostra il consumo di archiviazione corrente.
   • Bandwidth (10): Visualizza l'utilizzo di banda.
   • Bundle Attivo (11): Mostra la distribuzione dei dispositivi attivi across different app bundles.

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

   • Caricamento Pacchetti (12): Numero totale di pacchetti 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 statistiche in base al giorno.
   • Cumulativo (16): Visualizza 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'applicazione

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 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 di visualizzazione per la tua applicazione. Puoi modificare questo come necessario.
• Canale di Caricamento Predefinito (5): Specifica il canale predefinito a cui verranno caricati i nuovi pacchetti. Puoi cliccare sull'icona di modifica per selezionare un canale di caricamento diverso.
• 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 diverso. Vedi la sezione "Configurazione del Canale Predefinito" per informazioni dettagliate. Elimina automaticamente i pacchetti non utilizzati (dopo x secondi) (7): Questa impostazione consente di eliminare automaticamente i pacchetti vecchi che non sono stati utilizzati per una durata specificata (in secondi). Impostalo su
• Default Channel Configuration section below for detailed information. 0 To disabilitare la cancellazione automatica. Ciò aiuta a gestire lo storage e a mantenere la lista dei bundle pulita.
• Esponi i Metadati del Bundle al Plugin (8): Quando abilitato, i campi di collegamento e commento del bundle verranno inviati al plugin di aggiornamento Capacitor. Questa funzionalità richiede una versione del plugin di 7.35.0 o superiore.
• Trasferisci la Proprietà dell'App (9): Questa sezione fornisce un'opzione per avviare 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, i bundle, i canali e i dispositivi.
• Pulsante Aggiorna: Salva eventuali modifiche apportate ai campi modificabili di questa pagina (ad esempio, Nome dell'App, Canale di Caricamento Predefinito, impostazione di cancellazione automatica dei bundle).

Configurazione del Canale Predefinito

La Canale di Download Predefinito è uno dei parametri più importanti per il tuo 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 forzata del dispositivo: Se l'ID del dispositivo è esplicitamente impostato su un canale nelle impostazioni del canale, quel canale vince sempre.
2. Override di Cloud: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel dashboard, si utilizza tale override.
3. Capacitor config defaultChannel: Se impostato nelle tue 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:

• 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 default specifici per piattaforma:

1. Crea canali separati per ogni piattaforma (ad esempio production-ios, production-android, e production-electron)
2. Abilita solo la piattaforma pertinente (iOS, Android o Electron) nella configurazione di ogni canale
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 gli aggiornamenti dal canale predefinito abilitato per iOS
• I dispositivi Android riceveranno gli aggiornamenti dal canale predefinito abilitato per Android

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

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

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

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

Cambiare il Canale Predefinito

Quando cambi il canale predefinito:

• Nuovi dispositivi riceveranno immediatamente aggiornamenti dal nuovo canale predefinito
• Dispositivi esistenti che già hanno un'assegnazione di canale (via override o forza) NON cambieranno automaticamente
• Per spostare i dispositivi esistenti, è necessario:
  • Usare setChannel() per sovrascriverli in modo programmatico
  • Forzarli al nuovo canale nel pannello di controllo
  • Cancellare le loro voci di dispositivo (si riregistreranno con il nuovo canale predefinito)

Suggerimento: Sii sempre sicuro di testare il tuo nuovo canale predefinito con un piccolo gruppo di dispositivi obbligati prima di renderlo predefinito per tutti gli utenti.