How to Use Capgo Documentation for OTA Updates

Martin Donadieu Content Marketer - Marketing del contenuto senza ritardi della store? Capgo ti consente di distribuire aggiornamenti Over-the-Air (OTA) sicuri istantaneamente ai tuoi utenti. Saltare le recensioni della store e tenere il tuo app aggiornato con facilità.

Chiavi di apprendimento:

• Cosa è Capgo? Una piattaforma open-source per aggiornamenti in tempo reale in Capacitor applicazioni.
• Perché gli aggiornamenti OTA? Salva tempo, migliora l'esperienza dell'utente e risolvi i bug velocemente.
• Come iniziare?
  • Installa il Capgo plugin: npm install @capgo/capacitor-updater
  • Configura la tua app con una chiave API.
  • Utilizza canali come “produzione” o “beta” per distribuzioni mirate.
• Caratteristiche avanzate: La crittografia end-to-end, l'elaborazione degli errori e l'integrazione CI/CD.

La documentazione di Capgo (capgo.app/docs) fornisce istruzioni passo dopo passo per la configurazione, la sicurezza e la risoluzione dei problemi. Dalla installazione alle configurazioni avanzate, è la tua guida per aggiornamenti senza problemi.

Capgocontesto: testo HTML da un frammento di UI Capgo più lungo (chiave di pagina `submitting_a_pr_to_capgo`). Pagina/Area: Sito web di marketing Capgo. Ruolo: frase di copertina del sito web. Visto in: pagina contributing.astro. Preservare esattamente i termini di prodotto e marchio Capgo e i termini di sviluppatore. Chiave di messaggio `submitting_a_pr_to_capgo` (Invio di un PR a Capgo).

Utilizzare la Capgo Documentazione

La navigazione della documentazione in modo efficace è essenziale quando si lavora con aggiornamenti OTA. La documentazione di Capgo offre una guida dettagliata per l'integrazione degli aggiornamenti live nei Capacitor app.

Dove Trovare la Documentazione

È possibile accedere alla documentazione di Capgo a capgo.app/docs [1]. È organizzata in sezioni basate su scopi specifici:

Termini e concetti importanti

Ecco alcuni termini chiave che incontrerai:

• Canalicontext: Capgo release channels feature name. Page/area: Capgo solutions marketing page. Role: Short UI label or navigazione item. Seen in: page solutions/white-label.astro. Message key `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). [4].
• : Questi sono i flussi di aggiornamento utilizzati per controllare la distribuzione delle versioni. Ad esempio, potresti configurare i "produzione", "beta" e "staging" canali per soddisfare gruppi di utenti diversiPolitiche di aggiornamento [1].
• : Queste definiscono come gli aggiornamenti vengono consegnati e applicati. Le opzioni includono download automatici, impostazioni di installazione e sollecitazioni degli utentiListener dello stato dell'app [4].
• : Questi componenti seguono se l'app è in primo piano o in background: Packaged update files containing your app’s new version, including assets, code changes, and configuration updates [4].

: File di aggiornamento pacchettizzati contenenti la nuova versione dell'app, compresi gli asset, Code modifiche e aggiornamenti di configurazione dell'applicazione. Code Esempi e tutorial

La documentazione fornisce esempi di code per semplificare l'integrazione. Ecco un esempio base utilizzando TypeScript/JavaScript:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Initialize the updater
await CapacitorUpdater.notifyAppReady()

Per casi d'uso avanzati, la documentazione include esempi realistici [2][3], ad esempio:

• Passaggio tra canali per test A/B
• Flussi di aggiornamento personalizzati con sollecitazioni all'utente
• Gestione degli errori e implementazione dei rollback
• Integrazione degli aggiornamenti con pipeline CI/CD

Ogni tutorial evidenzia anche le considerazioni di prestazioni e gli aspetti di sicurezza, aiutandovi a prendere decisioni informate. La documentazione viene aggiornata frequentemente per includere le ultime funzionalità e le migliori pratiche [1].

Per dettagli di implementazione, consultate la guida di configurazione successiva.

Impostazione degli Aggiornamenti OTA

Impostate gli aggiornamenti OTA in Capgo per semplificare il vostro processo di distribuzione. Seguite questi passaggi e consigli per una configurazione senza problemi.

Passaggi di Configurazione Base

Comincia installando il plugin Capgo nel tuo progetto Capacitor:

npm install @capgo/capacitor-updater
npx cap sync

Successivamente, aggiorna il tuo capacitor.config.json file con la tua Capgo API chiave:

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "apiKey": "YOUR_API_KEY_HERE"
    }
  }
}

Poi, inizializza l'aggiornatore nel file principale dell'app per rilevare gli aggiornamenti:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();

Una volta fatto, puoi configurare i canali per gestire diversi flussi di aggiornamento.

Configurazione del Canale di Aggiornamento

Organizza i canali di aggiornamento per adattarli alle tue esigenze di distribuzione:

Per caricare un aggiornamento su un canale specifico, utilizzare il Capgo CLI:

npx @capgo/cli upload -c production

Metodi di Aggiornamento

Capgo offre due principali modalità per gestire gli aggiornamenti:

Aggiornamenti Automatici Abilita gli aggiornamenti automatici impostando autoUpdate: true in la tua configurazione. Ciò garantisce che gli aggiornamenti vengano applicati in background senza alcun ulteriore sforzo da parte degli sviluppatori.

Aggiornamenti Manuali Per un controllo maggiore, puoi gestire gli aggiornamenti manualmente. Utilizza il seguente modello per verificare e applicare gli aggiornamenti:

// Check for updates
const update = await CapacitorUpdater.download();

// Install when ready
if (update) {
  await CapacitorUpdater.set(update);
}

Per gli aggiornamenti critici, puoi chiedere conferma agli utenti prima di procedere:

if (update.version > currentVersion) {
  const userConsent = await showUpdatePrompt();
  if (userConsent) {
    await CapacitorUpdater.set(update);
  }
}

Puoi anche targetizzare specifiche fasce di utenti con ID e canali personalizzati:

await CapacitorUpdater.setCustomId('beta-tester-123');
await CapacitorUpdater.setChannel('beta');

Infine, assicurati di includere gestione degli errori e opzioni di rollback:

try {
  await CapacitorUpdater.set(update);
} catch (error) {
  await CapacitorUpdater.reset(); // Revert to the last working version
  console.error('Update failed:', error);
}

Con questi passaggi, il tuo sistema di aggiornamento OTA è pronto per essere utilizzato. Esplora le impostazioni avanzate per personalizzare ulteriormente il processo di aggiornamento.

sbb-itb-f9944d2

Impostazioni Avanzate

Migliora la tua Capgo Aggiorna OTA configurazione con misure di sicurezza aggiuntive e configurazioni di aggiornamento flessibili. Queste opzioni assicurano un'esperienza di aggiornamento sicura e liscia, rispettando le linee guida degli store di app.

Caratteristiche di Sicurezza

Capgo fornisce protocolli di sicurezza robusti per proteggere i tuoi bundle di aggiornamento e consegnarli in modo sicuro agli utenti. La piattaforma utilizza crittografia a chiave pubblica con crittografia end-to-end per tutti gli aggiornamenti [1]. Ecco come puoi abilitare le principali caratteristiche di sicurezza:

// Enable bundle verification
await CapacitorUpdater.setVerifyBundles(true);

// Configure encryption settings
await CapacitorUpdater.configure({
  encryption: {
    enabled: true,
    failOnError: true
  }
});

Componenti chiave del sistema di protezione del bundle includono:

Impostazioni di comportamento degli aggiornamenti

Potete personalizzare come gli aggiornamenti vengono consegnati e installati utilizzando gli ascoltatori di eventi e le opzioni di configurazione. Regolate la cronologia e l'interazione dell'utente per gli aggiornamenti con queste impostazioni:

// Listen for when an update is available
CapacitorUpdater.addListener('updateAvailable', async (info) => {
  if (info.version > currentVersion) {
    // Custom update logic based on app state
    const isAppInactive = await checkAppState();
    if (isAppInactive) {
      await CapacitorUpdater.download();
    }
  }
});

// Monitor download completion
CapacitorUpdater.addListener('downloadComplete', (info) => {
  console.log(`Update ${info.version} ready to install`);
  // Implement custom installation timing if desired
});

Per i rilasci fasi, potete configurare la distribuzione degli aggiornamenti direttamente tramite il pannello di controllo o con code:

// Set custom update conditions for a gradual rollout
await CapacitorUpdater.configure({
  rollout: {
    percentage: 25, // Start with 25% of users
    timeInterval: 24 // Increase rollout percentage every 24 hours
  }
});

Per gestire comportamenti specifici legati alle versioni:

// Handle version-specific update failures
CapacitorUpdater.addListener('updateFailed', async (info) => {
  if (info.error.code === 'VERSION_MISMATCH') {
    await CapacitorUpdater.reset(); // Revert to the last stable version
    // Optionally, handle error notification here
  }
});

These settings ensure updates are reliable while allowing you to tailor the process to your app’s needs. Always test updates thoroughly in Capgo’s staging environment before rolling them out to production [2].

Guida alla Risoluzione dei Problemi

Capgo's error logs e strumenti integrati aiutano a risolvere le sfide relative agli aggiornamenti OTA, mantenendo l'app conforme alle richieste dei negozi.

Issue Comuni e Soluzioni

Ecco alcuni problemi tipici e come risolverli:

• Download Falliti Simptomi: I download si bloccano o non si completano. Soluzione: Controlla la tua connessione di rete, conferma l'URL dell'aggiornamento è valido e aggiungi meccanismi di riprova per gestire le interruzioni.

• Conflitti di Versione Simptomi: Aggiornamenti che falliscono l'installazione o causano instabilità dell'applicazione. Soluzione: Utilizzare numeri di versione chiari per evitare conflitti e implementare opzioni di rollback per la sicurezza.

• Errori di installazione Sintomi: Aggiornamenti che falliscono o attivano automaticamente i rollback. Soluzione: Assicurarsi di chiamare notifyAppReady() dopo un aggiornamento riuscito per prevenire i rollback.

Per gli aggiornamenti più grandi di 50MB, dividerli in file più piccoli può migliorare le prestazioni sui dispositivi Android [5].

Utilizzare log di errori dettagliati per catturare i problemi in anticipo. Ad esempio, implementare questo ascoltatore:

CapacitorUpdater.addListener('updateFailed', (error) => {
  console.log(`Update failed: ${error.code}`);
  logUpdateError({
    errorCode: error.code,
    deviceInfo: error.device,
    timestamp: new Date().toISOString()
  });
});

Combinando la registrazione degli errori con le verifiche pre, puoi gestire questi problemi in modo efficace prima di concentrarti sulla conformità.

Regole Store App

Le soluzioni tecniche non sono sufficienti - le tue aggiornamenti devono anche essere in linea con le linee guida delle store app.

Requisiti Store App Apple:

• Trasparenza Utente: Informati chiaramente gli utenti sul contenuto dell'aggiornamento e ottieni il loro consenso.
• Funzionalità Principale: Assicurati che le principali funzionalità dell'app rimangano intatte come sono state valutate.
• Misure di Sicurezza: Utilizza metodi sicuri per trasmettere gli aggiornamenti.

Esecuzione su Android:

await CapacitorUpdater.configure({
  updateNotification: {
    title: "Update Available",
    message: "A new version is available. Please update to access the latest features.",
    requireUserConsent: true
  }
});

Pratiche Migliori:

• Controllo delle Versioni: Rilascia aggiornamenti gradualmente per ridurre i conflitti.
• Aggiornamenti: Fornisci avvisi di aggiornamento chiari e utili per l'utente.
• Sicurezza: Verifica l'integrità del pacchetto e utilizza la crittografia per proteggere i dati.

Riepilogo

: Questa sezione raccoglie le idee principali del guide.

La documentazione di Capgo fornisce istruzioni chiare per l'integrazione degli aggiornamenti OTA nei Capacitor app, mantenendo la conformità con le norme delle app store.

Utilizzando le risorse di Capgo, i sviluppatori possono implementare funzionalità essenziali come crittografia end-to-end e : Integra il flusso di lavoro CI/CD per automatizzare il processo di sviluppo e testing.coprendendo tutto, dall'installazione iniziale alle configurazioni avanzate [1].

Aree di Implementazione Chiave

Queste aree formano la spina dorsale del sistema di gestione degli aggiornamenti di Capgo.

Capgo’s CLI e strumenti di analytics semplificano la gestione degli aggiornamenti durante l’intero ciclo di vita dell’app [1].

Per ulteriori informazioni, puoi esplorare ulteriori risorse come API documentazione, progetti di esempio, e forum della community [2].

Continua da Come utilizzare Capgo Documentazione per Aggiornamenti OTA

Se stai utilizzando Come utilizzare Capgo Documentazione per Aggiornamenti OTA per pianificare la sicurezza e la conformità, connettilo con Crittografia per i dettagli di implementazione in Crittografia, Conformità per i dettagli di implementazione in Compliance, Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner di Sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di Trust per il flusso di lavoro del prodotto in Capgo Centro di Trust.