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 log non elaborati.
   • Builds: Gestione di costruzioni native.

2. Visualizzazione statistiche: Visualizza le metriche importanti per il periodo di fatturazione scorso (i dati riflettono l'utilizzo dal tuo giorno di fatturazione, non dal 1° del mese):

   • Utenti attivi al mese (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 in base a diversi bundle dell'applicazione.

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

   • Caricamenti di Bundle (12): Numero totale di bundle dell'app caricati.
   • Statistiche degli Aggiornamenti (13): Numero totale di aggiornamenti eseguiti, compresi richieste, installazioni e fallimenti.
   • Statistiche delle Distribuzioni (14): Numero totale di distribuzioni.

4. Opzioni di Visualizzazione (15-18): Controlli per la filtrazione e la visualizzazione delle statistiche:

   • Giornaliero (15): Visualizza statistiche con cadenza giornaliera.
   • Cumulativo (16): Visualizza statistiche cumulative nel tempo.
   • Periodo di fatturazione (17): Visualizza 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 dell'App

Il screenshot è più vecchio della console corrente e non mostra ogni impostazione corrente. Utilizzare le descrizioni dei campi di seguito 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 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 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. La pagina del canale mostra se un canale è predefinito, ma puoi cambiarlo qui, non con un pulsante di commutazione sul canale. Apri un canale e clicca Gestisci le impostazioni dell'app per saltare a questo campo. Vedi la sezione Configurazione predefinita del canale 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 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 pacchetti pulita.
• Esponi i metadati del pacchetto ai plugin (8): Quando abilitato, i campi di collegamento e commento del pacchetto verranno inviati al plugin di aggiornamento Capacitor. Questa funzionalità richiede una versione del plugin di 7.35.0 o superiore.
• Blocca le richieste di infrastruttura del provider: Quando abilitato, Capgo rifiuta le richieste di aggiornamento, statistiche e canale-self provenienti dalle aree IP note di Google e Apple. Lascialo abilitato per il traffico di produzione normale. Disabilitalo temporaneamente solo quando intendi testare intenzionalmente da infrastruttura del provider. Le nuove app 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'applicazione (9): Questa sezione offre l'opzione di avviare il trasferimento 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 eventuali modifiche apportate ai campi modificabili di questa pagina (ad esempio, Nome dell'applicazione, 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 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. Mapping dispositivo obbligatorio: Se l'ID del 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 dalla dashboard o da Public API, si utilizza tale override.
3. Plugin setChannel(): In versioni plugin correnti, questo è un'assegnazione locale, non un override della dashboard. Vedi Come un dispositivo sceglie un canale.
4. Configurazione Capacitor defaultChannel: Se impostata nel tuo capacitor.config.* file, si utilizza per le versioni di test/beta.
5. Canale di Download Predefinito: La configurazione impostata 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:

• 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. Creare canali separati per ogni piattaforma (ad esempio production-ios, production-android, e production-electron)
2. In impostazioni di ogni canale, abilitare solo la piattaforma pertinente (toggle iOS, Android o Electron)
3. On Informazioni sull'app, impostare ogni uno di quei canali come il Canale di download predefinito per la sua piattaforma. Capgo consente di avere più di un canale predefinito quando i canali puntano 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 singolo (Raccomandato per le maggior parte delle app)

Per la maggior parte delle applicazioni, un canale predefinito singolo che supporta tutti e tre i principali sistemi operativi è l'approccio più semplice:

1. Creare un canale (ad esempio, production)
2. Assicurarsi che i pulsanti per iOS, Android e Electron siano abilitati
3. Impostarlo come Canale di download predefinito su Informazioni sull'app

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

Modifica 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 force) NON passeranno automaticamente
• Per spostare i dispositivi esistenti, è necessario:
  • Usare setChannel() (o unsetChannel()Eliminare il dispositivo di backend non cancella un'assegnamento locale. setChannel() Eliminare l'assegnamento.
  • Forzarli sul nuovo canale nella dashboard (console/API override; scade dopo 90 giorni)
  • Cancella il loro console/API override in modo che cadano nella precedenza. I dispositivi con solo il cloud predefinito prendono poi il nuovo predefinito.

Suggerimento: Testa sempre 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 App per pianificare dashboard e API operazioni, connettila con API Overview 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.