Pagina dell'app

What mostra la pagina dell'app?

Prima, 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. Barramento di navigazione superiore: Consente l'accesso a diverse sezioni della gestione dell'app:

   • Pannello di controllo (1): La vista corrente, che mostra metriche e sommari chiave.
   • Informazioni (2): Mostra le impostazioni e i dettagli fondamentali dell'app (vedi la 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 override specifici.
   • 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 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): Rileva il numero di utenti unici attivi nel tempo.
   • Storage (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'app.

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

   • Cariche di Bundle (12): Totale di bundle dell'app caricati.
   • Aggiornamenti Statistiche (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 statistiche in base al giorno.
   • Cumulativo (16): Visualizza statistiche cumulative nel tempo.
   • Periodo di Facturazione (17): Visualizza statistiche per il periodo di fatturazione corrente.
   • Intervallo di data (18): Scegli un intervallo di data personalizzato (ad esempio, gli ultimi 30 giorni).

Informazioni sull'app

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:

• Iconografia 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'applicazione (4): Il nome di visualizzazione per la tua applicazione. Puoi modificare questo come necessario.
• Canale di upload predefinito (5): Specifica il canale predefinito a cui vengono caricati nuovi bundle. Puoi cliccare sull'icona di modifica per selezionare un canale di upload predefinito diverso.
• Canale di download predefinito (6): Specifica il canale predefinito da cui i dispositivi scaricano 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 i bundle non utilizzati (dopo x secondi) (7): Questa impostazione consente di eliminare automaticamente i bundle vecchi che non sono stati utilizzati per una durata specificata (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 ai plugin (8): This setting allows you to automatically delete old bundles that haven’t been used for a specified duration (in seconds). Set to 0 to disable auto-deletion. This helps manage storage and keep your bundle list clean.
• Expose Bundle Metadata to Plugin (8): Quando abilitato, i campi di collegamento e commento saranno inviati al plugin Capacitor Aggiornatore. 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 pacchetti, i canali e i dispositivi.
• Pulsante Aggiorna: Salva qualsiasi modifica che hai fatto ai campi modificabili di questa pagina (ad esempio, Nome dell'app, Canale di caricamento predefinito, impostazione di eliminazione automatica dei pacchetti).

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.

How Funziona il Canale Predefinito

When a device richiede un aggiornamento da Capgo, il sistema determina quale canale utilizzare in base alla seguente gerarchia di priorità (priorità più alta per prima):

1. Mapping del dispositivo obbligatorio: 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, viene utilizzato l'override impostato.
3. Configurazione di Capacitor defaultChannel: Se impostata nella tua capacitor.config.* file, viene utilizzato per le versioni di test/beta.
4. Canale di Download Predefinito: La configurazione impostata qui—questo è ciò che ~99% dei tuoi utenti di produzione utilizzeranno.

Canali di default specifici per piattaforma

Puoi configurare canali di default 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. Creare canali separati per ogni piattaforma (ad esempio production-ios, production-android, e production-electron)
2. In impostazioni di ogni canale, abilita solo la piattaforma pertinente (toggle iOS, Android o Electron)
3. Segna entrambi i canali come “Default” - Capgo consente di farlo quando i canali si rivolgono a diverse piattaforme

When un dispositivo richiede un aggiornamento:

• Il dispositivi iOS riceveranno gli aggiornamenti dal canale iOS abilitato predefinito
• Il dispositivi Android riceveranno gli aggiornamenti dal canale Android abilitato predefinito

Canale predefinito singolo (Raccomandato per la maggior parte delle App)

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

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

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

Cambiare il Canale Predefinito

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 force) NON passeranno automaticamente
• Per spostare i dispositivi esistenti, devi fare:
  • Usa setChannel() per sovrascriverli in modo programmatico
  • Forzali al nuovo canale nel pannello di controllo
  • Elimina le loro voci di dispositivo (si reregistreranno con il nuovo canale predefinito)

Suggerimento: Prima di rendere il nuovo canale predefinito disponibile per tutti gli utenti, assicurati di testarlo con un piccolo gruppo di dispositivi forzati.

Continua da Pagina dell'App

Se stai utilizzando Pagina dell'App per pianificare il dashboard e le API operazioni, connettilo con Panoramica di API per i dettagli di implementazione in Panoramica di API Introduzione per i dettagli di implementazione in Introduzione Chiavi di API per i dettagli di implementazione in Chiavi di API Dispositivi per i dettagli di implementazione in dispositivi, e Bundle per i dettagli di implementazione in Bundle.