App Page

Cosa mostra la pagina dell'app?

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

In Capgo, un'app rappresenta la tua applicazione mobile integrata con il sistema di aggiornamento live di Capgo.

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 viste di gestione dell'app principale. Lo screenshot è illustrativo; il console corrente include:

   • Pannello di controllo: Metriche e sommari per l'app.
   • Osserva (beta): Avvio nativo, WebView, segnali di problema e salute della versione.
   • Informazioni: Impostazioni e dettagli dell'app (vedi Informazioni sull'app).
   • Bundle: Versioni e rilasci.
   • Canali: Canali di aggiornamento e controlli di rollout progressivo.
   • Dispositivi: Dispositivi registrati e override.
   • Log: Insight sui log e loghi raw.
   • Builds: Gestione di costruzione nativa.

2. Visualizza importanti metriche 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. Spazio di Archiviazione (9):
   • Mostra la consumazione di archiviazione corrente. Bandwidth (10):
   • Visualizza l'utilizzo di banda. Bundle Attivo (11):
   • Visualizza l'utilizzo di banda. Mostra la distribuzione dei dispositivi attivi in base a diversi pacchetti di applicazione.

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

   • Caricamenti di pacchetti (12): Totale di pacchetti di applicazione caricati.
   • Statistiche degli aggiornamenti (13): Totale di aggiornamenti eseguiti, compresi richieste, installazioni e fallimenti.
   • Statistiche di distribuzione (14): Totale di distribuzioni.

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

   • Giornaliero (15): Visualizza statistiche con cadenza quotidiana.
   • Accumulato (16): Visualizza statistiche cumulative nel tempo.
   • Periodo di fatturazione (17): Visualizza 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 superiore. Ecco dove puoi visualizzare e gestire dettagli e impostazioni cruciali per la tua applicazione.

Pagina delle informazioni sull'app

The screenshot è più vecchio rispetto alla 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'applicazione (2): Visualizza l'icona della tua applicazione. Puoi cliccare sul pulsante 'Cambia' per caricare un'icona nuova.
• ID dell'applicazione (3): Un identificatore univoco per la tua applicazione all'interno di Capgo. Questo ID non è modificabile.
• Nome dell'applicazione (4): 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 pacchetti. 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 scaricheranno aggiornamenti. Puoi cliccare sull'icona di modifica per selezionare un canale di download predefinito diverso. Vedi il Configurazione del Canale Predefinito Consulta la sezione seguente 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 al Plugin (8): Abilitando questa funzione, i campi di collegamento e commento dei pacchetti verranno inviati al Capacitor Plugin di aggiornamento. 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 channel-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 intenzionalmente da infrastruttura del provider. Gli app nuovi abilitano questa protezione per impostazione predefinita; gli 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 avviare il trasferimento della tua applicazione a un'organizzazione diversa di cui fai parte.
• Bottone 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.
• Aggiorna: Salva qualsiasi modifica che hai fatto ai campi modificabili di questa pagina (ad esempio, Nome Applicazione, Canale di Caricamento 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 del dispositivo obbligatorio: Se l'ID dispositivo viene esplicitamente impostato su un canale nei impostazioni del canale, quel canale vince sempre.
2. Cloud override: Se il dispositivo è stato assegnato a un canale tramite setChannel() o manualmente nel pannello di controllo, viene utilizzato quel sovrascrittura.
3. Capacitor config defaultChannel: Se impostato nel tuo capacitor.config.* file, questo viene utilizzato per le build 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:

• Desideri distribuire aggiornamenti a un piattaforma prima dell'altra
• Hai bisogno di strategie di aggiornamento diverse per ogni piattaforma
• Stai testando una nuova versione su una piattaforma mentre mantieni l'altra stabile

Per configurare i valori predefiniti 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 (iOS, Android o toggle per Electron)
3. Segnare 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 App)

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 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 workflow 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 del canale (via override o force) NON passeranno automaticamente al nuovo canale
• Per spostare dispositivi esistenti, è necessario scegliere tra:
  • Usare setChannel() per sovrascriverli in modo programmatico
  • Forzarli al nuovo canale nella dashboard
  • Cancellare le loro entrate dispositivi (si rireisteranno con il nuovo canale predefinito)

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

Continua da Pagina App

Se stai utilizzando Pagina 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 Bundle per i dettagli di implementazione in Bundle.