Come utilizzare Capgo Documentazione per aggiornamenti OTA

Hai bisogno di aggiornamenti aggiornamenti dell'app senza ritardi degli store di app? Capgo ti consente di consegnare aggiornamenti Over-the-Air (OTA) sicuri istantaneamente ai tuoi utenti. Saltare le recensioni degli store di app e tenere il tuo app aggiornato con facilità.

Chiavi di apprendimento:

• Cos'è Capgo? Una piattaforma open-source per aggiornamenti in tempo reale in Capacitor applicazioni.
• Perché gli Aggiornamenti OTA? Salva tempo, migliora l'esperienza 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.
• Funzionalità Avanzate: Crittografia end-to-end, gestione degli errori e integrazione CI/CD.

Capgo’s documentazione (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.

Capgo, plugin CapacitorJs per l'aggiornamento in tempo reale

Utilizzo della documentazione Capgo

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

Dove Trovare la Documentazione

Puoi accedere alla documentazione di Capgo a capgo.app/docs [1]Ecco le sezioni organizzate in base a scopi specifici:

Termini e concetti importanti

Ecco alcuni termini chiave che incontrerai:

• Canali: Questi sono flussi di aggiornamento utilizzati per controllare la distribuzione delle versioni. Ad esempio, potresti configurare i canali "produzione", "beta" e "staging" per soddisfare gruppi di utenti diversi [4].
• Aggiornamenti delle politiche: Questi definiscono come gli aggiornamenti vengono consegnati e applicati. Le opzioni includono download automatici, impostazioni di installazione e sollecitazioni degli utenti [1].
• Ascoltatori dello stato dell'app: Questi componenti seguono se l'app è in primo piano o in background [4].
• Bundle: File di aggiornamento pacchettizzati contenenti la nuova versione dell'app, inclusi asset, code modifiche e aggiornamenti di configurazione [4].

Esempi e tutorial di Code

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 degli utenti
• Gestione degli errori e implementazione dei rollback
• Integrazione degli aggiornamenti con i pipeline CI/CD

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

Per i dettagli di implementazione, consulta la guida di configurazione successiva.

Configurazione degli Aggiornamenti OTA

Set up OTA updates in Capgo to streamline your deployment process. Follow these steps and tips for a hassle-free configuration.

Passaggi di Configurazione Base

Start by installing the Capgo plugin in your Capacitor project:

npm install @capgo/capacitor-updater
npx cap sync

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

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

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

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

Una volta fatto, potrai 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 in un canale specifico, utilizzare il Capgo CLI:

npx @capgo/cli upload -c production

Metodi di Aggiornamento

Capgo fornisce due principali modi 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 sforzo extra da parte dei sviluppatori.

Aggiornamenti Manuali Per avere il controllo totale, puoi gestire gli aggiornamenti manualmente. Utilizza il seguente pattern 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 ai utenti di confermare prima di procedere:

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

Puoi anche targetizzare specifici gruppi 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 annullamento:

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 il tuo Capgo Aggiornamento OTA setup con misure di sicurezza aggiuntive e configurazioni di aggiornamento flessibili. Queste opzioni assicurano un'esperienza di aggiornamento sicura e liscia, mentre rispettano le linee guida degli store di app.

Caratteristiche di Sicurezza

Capgo fornisce protocolli di sicurezza robusti per proteggere i pacchetti di aggiornamento e consegnarli in modo sicuro agli utenti. La piattaforma utilizza la crittografia a chiave pubblica per tutte le aggiornamenti. [1]Di seguito è riportato come abilitare le funzionalità di sicurezza chiave:

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

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

I componenti chiave del sistema di protezione dei pacchetti includono:

Impostazioni del comportamento degli aggiornamenti

Potete personalizzare come gli aggiornamenti vengono consegnati e installati utilizzando gli ascoltatori di eventi e le opzioni di configurazione. Regolate il timing 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
  }
});

Queste impostazioni assicurano che gli aggiornamenti siano affidabili, consentendo comunque di personalizzare il processo in base alle esigenze dell'applicazione. Testate sempre gli aggiornamenti attentamente nell'ambiente di staging di Capgo prima di renderli disponibili nella produzione [2].

Guida alla Risoluzione dei Problemi

I registri di errori e gli strumenti integrati di Capgo aiutano a risolvere i problemi relativi agli aggiornamenti OTA, mantenendo l'applicazione conforme ai requisiti dei negozi

Problemi Comuni e Soluzioni

Ecco alcuni problemi tipici e come risolverli:

• Scarichi Falliti Sintomi: 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 Sintomi: Aggiornamenti che falliscono l'installazione o causano instabilità dell'app. Soluzione: Utilizza numeri di versione chiari per evitare conflitti e implementa opzioni di rollback per la sicurezza.

• Errori di Installazione Sintomi: Aggiornamenti falliscono o attivano rollback automatici. Soluzione: Assicurati 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].

Utilizza la registrazione degli errori dettagliata per catturare i problemi in anticipo. Ad esempio, implementa questo ascoltatore:

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

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

Regole dell'App Store

Le soluzioni tecniche non sono sufficienti - i tuoi aggiornamenti devono anche essere conformi alle linee guida dell'app store.

Requisiti dell'App Store Apple:

• Transparenza dell'Utente: Informati chiaramente gli utenti sul contenuto dell'aggiornamento e ottieni il loro consenso.
• Funzionalità di base: Assicurati che le principali funzionalità dell'app rimangano intatte come da revisione.
• Misure di Sicurezza: Utilizza metodi sicuri per la trasmissione degli aggiornamenti.

Implementazione Android:

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

Pratiche Migliorative:

• Controllo delle Versioni: Rilascia gli aggiornamenti gradualmente per ridurre i conflitti.
• Notifiche di Aggiornamento: Fornisci avvisi di aggiornamento chiari e facili da utilizzare.
• Sicurezza: Verifica l'integrità del pacchetto e utilizza la crittografia per proteggere i dati.

Riepilogo

Questa sezione raccoglie le idee principali dalla guida.

La documentazione di Capgo fornisce istruzioni chiare per l'integrazione degli aggiornamenti OTA nei Capacitor app mentre rimane conforme alle norme delle app store.

Utilizzando le risorse di Capgo, gli sviluppatori possono implementare funzionalità essenziali come crittografia end-to-end e integrazione CI/CD, coprendo tutto, dall'impostazione 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 in tutto il ciclo di vita dell'applicazione [1].

Per ulteriore supporto, puoi esplorare risorse aggiuntive come API documentazione, progetti di esempio, e forum della community [2].