Area App

Cosa mostra la pagina dell'app?

Prima di tutto, prendiamo in esame la pagina principale dell'app:

In Capgo, una pagina dell'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 alle viste di gestione dell'app principale. Lo screenshot è illustrativo; la console corrente include:

   • Pannello di controllo: Metriche e sommari per l'app.
   • Osserva (beta): Lancio nativo, WebView, segnali di problema e salute della versione.
   • Informazioni: Impostazioni e dettagli dell'applicazione principale (vedi Informazioni sull'applicazione).
   • Pacchetti: Versioni e rilasci.
   • Canali: context: Canali di rilascio Capgo. Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta di navigazione breve o elemento UI. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Valore della cella visiva Solutions White Label).
   • Canali di aggiornamento e controlli di rollout progressivo.: Dispositivi
   • Dispositivi registrati e override.: Log Insights e registri di sistema.
   • Builds: Gestione di costruzione nativa.

2. Statistics Display: 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.
   • Storage (9): Mostra la consumazione di archiviazione corrente.
   • Bandwidth (10): Visualizza l'utilizzo di banda.
   • Bundle Attivo (11): Mostra la distribuzione dei dispositivi attivi per diversi bundle dell'applicazione.

3. Riepiloghi: 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 con cadenza giornaliera.
   • 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): Scegli un intervallo di date personalizzato (ad esempio gli ultimi 30 giorni).

Informazioni sull'app

Questa sezione corrisponde alla scheda “Informazioni” (1) nella barra di navigazione in alto. Ecco dove puoi visualizzare e gestire dettagli e impostazioni cruciali per la tua applicazione.

Pagina dell'App

Lo screenshot è più vecchio rispetto alla console corrente e non mostra ogni impostazione corrente. Utilizzare le descrizioni dei campi sotto come fonte di verità.

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 modificare questo come necessario.
• Canale di Upload 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 predefinito diverso. Vedi la sezione Configurazione del Canale Predefinito di seguito 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 ai plugin (8): Quando abilitato, i campi di collegamento e commento del bundle vengono inviati al plugin di aggiornamento Capacitor. Questa funzione richiede la versione del plugin 7.35.0 o successiva.
• Blocca le richieste di infrastruttura del provider: Quando abilitato, Capgo rifiuta le richieste di aggiornamento, statistiche e canale-self provenienti dalle aree IP dei datacenter di Google e Apple. Lascialo abilitato per il traffico di produzione normale. Disabilitalo temporaneamente solo quando intendi testare da infrastruttura del provider. Gli app nuove abilitano questa protezione per impostazione predefinita; le app esistenti conservano la loro impostazione precedente disabilitata fino a quando non la modifichi.
• 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 App, Canale di upload predefinito, impostazione di eliminazione automatica dei pacchetti).

Configurazione del Canale Predefinito

La Canale di Download Predefinito è uno dei parametri più importanti per la tua app. Determina quale canale i nuovi dispositivi riceveranno gli 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 dispositivo obbligatoria: Se l'ID dispositivo è esplicitamente impostato su un canale nelle impostazioni del canale, quel canale vince sempre.
2. Override Cloud: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel pannello di controllo, viene utilizzato quel override.
3. Capacitor config defaultChannel: Se impostato nel tuo capacitor.config.* file, questo viene utilizzato per le versioni 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. In 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 (Consigliato per la maggior parte degli Applicativi)

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

1. Creare un canale (ad esempio, production)
2. Assicurarsi che i pulsanti iOS, Android e Electron siano abilitati
3. Marcarlo 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:

• 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 a un altro canale
• Per spostare i dispositivi esistenti, è necessario scegliere tra:
  • 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: Assicurati sempre di testare il nuovo canale predefinito con un piccolo gruppo di dispositivi forzati prima di renderlo predefinito per tutti gli utenti.

Continua da Pagina App

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