Saltare al contenuto

Pagina dell'app

Innanzitutto, prendiamo in considerazione la pagina principale dell'app:

In Capgo, una app rappresenta la tua applicazione mobile integrata con il sistema di aggiornamento in tempo reale di Capgo. Ti consente di gestire aggiornamenti, canali e dispositivi in modo fluido.

Screenshot della pagina principale

Prendiamo una visione più approfondita di questo. La pagina principale dell'app è divisa in diverse aree chiave:

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

    • Pannello di controllo (1): L'attuale visualizzazione, che mostra metriche e sommari chiave.
    • Informazioni (2): Mostra le impostazioni e i dettagli fondamentali dell'app (vedi sezione “Informazioni sull'app” di seguito).
    • Pacchetti (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 sovrapposizioni.
    • Log (6): Accedi a log dettagliati e rapporti di errore per il tuo app.
    • Costruzioni (7): Visualizza e gestisci le costruzioni del tuo app.
  2. Statistiche Visualizza: 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): Racconta il numero di utenti attivi unici nel tempo.
    • Memoria (9): Mostra la consumazione di memoria attuale.
    • Bandwidth (10): Visualizza l'utilizzo di banda.
    • Bundle Attivo (11): Mostra la distribuzione dei dispositivi attivi su diversi bundle dell'app.
  3. Carte di Riepilogo: Offre un'anteprima rapida dei conteggi chiave:

    • Cariche Bundle (12): Totale di bundle dell'app caricati.
    • Statistiche Aggiornamenti (13): Numero totale di aggiornamenti eseguiti, compresi 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 al giorno.
    • 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).

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
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): The nome visualizzato per la 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 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 diverso da quello predefinito. Vedi la sezione Configurazione del canale predefinito per informazioni dettagliate.
  • Elimina automaticamente i bundle non utilizzati (dopo x secondi) (7): Questa impostazione consente di eliminare automaticamente i bundle vecchi che non sono stati utilizzati per un determinato periodo di tempo (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 funzionalità richiede almeno la versione 7.35.0 del plugin.
  • Cedimento della proprietà dell'applicazione (9): Questa sezione fornisce un'opzione per avviare la cessione della tua applicazione a un'organizzazione diversa di cui fai parte.
  • Pulsante Elimina Applicazione: Elimina permanentemente la tua applicazione da Capgo. Questa azione è irreversibile e rimuoverà tutti i dati associati, i pacchetti, i canali e i dispositivi.
  • Pulsante Aggiorna: Salva qualsiasi modifica che hai apportato ai campi modificabili di questa pagina (ad esempio, Nome dell'applicazione, Canale di caricamento predefinito, impostazione di eliminazione automatica dei pacchetti).

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.

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. Sovrapposizione di Cloud: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel dashboard, si utilizza tale sovrapposizione.
  3. Capacitor config defaultChannel: Se impostato nel tuo capacitor.config.* file, si utilizza per le build di test/beta.
  4. Canale di Download Predefinito: La configurazione impostata qui—questo è ciò che ~99% dei tuoi utenti di produzione utilizzeranno.

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 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-androidE abilita solo la piattaforma pertinente (iOS, Android o Electron toggle) production-electron)
  2. Segna entrambi i canali come “Predefinito” - __CAPGO_KEEP_0__ consente di farlo quando i canali si rivolgono a diverse piattaforme
  3. Mark both channels as “Default” - Capgo allows this when channels target different platforms

__CAPGO_KEEP_0__

  • i dispositivi iOS riceveranno aggiornamenti dal canale predefinito abilitato per iOS
  • i dispositivi Android riceveranno aggiornamenti dal canale predefinito abilitato per Android
Sezione intitolata “Canale predefinito singolo (Raccomandato per la maggior parte degli Applicazioni)”

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

  1. Creare un canale (ad esempio, production)
  2. Assicurarsi che le impostazioni per iOS, Android e Electron siano abilitate
  3. Marcarlo come canale predefinito

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

Quando cambierai 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 passeranno automaticamente
  • Per spostare i dispositivi esistenti, è necessario:
    • Utilizzare setChannel() per sovrascriverli in modo programmatico
    • Forzarli al nuovo canale nella dashboard
    • Cancellare le loro voci di dispositivo (si rireisteranno con il nuovo canale predefinito)

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

Se stai utilizzando Pagina App per pianificare la dashboard e le operazioni di API API Overview API Overview per i dettagli di implementazione in __CAPGO_KEEP_0__ Overview Introduzione API Keys API Keys per i dettagli di implementazione in __CAPGO_KEEP_0__ Keys Dispositivi Pacchetti per i dettagli di implementazione in Pacchetti.