Risoluzione dei problemi

Ecco alcune problematiche comuni che potresti incontrare mentre utilizzi Capgo e come risolverle.

🚀 Hai bisogno di aiuto esperto?

Bloccato con un problema complesso? Il nostro team esperto è qui per aiutarti! Ottieni supporto personalizzato, code recensioni e soluzioni personalizzate adattate alle tue esigenze specifiche.

Supporto Professionale

Fallimenti di caricamento

If il tuo caricamento del bundle fallisce, controlla:

• ID dell'app in capacitor.config.ts matches your app in the Capgo dashboard
• You’re running the upload command from the root of your Capacitor project
• Il tuo progetto ha le risorse web costruite e aggiornate

Opzioni di caricamento avanzate

The Capgo CLI provides some additional flags to help with common upload issues:

• --tus: Utilizza il protocollo di caricamento resumabile tus per caricamenti più affidabili di bundle grandi o su connessioni di rete deboli. Se il tuo bundle supera i 10MB o sei su una connessione instabile, considera l'uso di Fenestra del terminale --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json e --node-modules: Insegna a Capgo dove trovare la tua cartella radice package.json e node_modules se la tua app utilizza una struttura non standard come un repository unico o npm workspace. Passa la percorso della cartella radice package.json e il --node_modules percorso:

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo ha bisogno di questa informazione per poter correttamente pacchettizzare le dipendenze della tua app.

Puoi combinare questi flag con altre opzioni come --channel se necessario. Vedi il Capgo CLI documentazione per ulteriori informazioni sulle opzioni di caricamento disponibili.

Se hai ancora difficoltà con gli upload, contatta Capgo supporto per ulteriore assistenza.

Aggiornamenti di debug

Se stai incontrando problemi con gli aggiornamenti in tempo reale, il comando di debug Capgo è uno strumento utile per la risoluzione dei problemi. Per utilizzarlo:

1. Esegui il seguente comando nel tuo directory di progetto:

   npx @capgo/cli@latest app debug

2. Lancia il tuo app su un dispositivo o emulator e esegui l'azione che dovrebbe attivare un aggiornamento (ad esempio, riaprire l'app dopo aver caricato un nuovo bundle).

3. Guarda l'output del comando di debug. Sarà registrata informazione sull'aggiornamento, compreso:

   • Quando l'app controlla l'aggiornamento
   • Se viene trovato un aggiornamento e di quale versione si tratta
   • Progresso di download e installazione dell'aggiornamento
   • Qualsiasi errore che si verifica durante il processo di aggiornamento

4. Utilizza i registri di debug per identificare dove si verifica il problema. Ad esempio:

   • Se non viene trovato alcun aggiornamento, controlla che il tuo pacchetto sia stato caricato correttamente e che l'app sia configurata per utilizzare il canale corretto.
   • Se l'aggiornamento viene scaricato ma non installato, assicurati di aver chiamato CapacitorUpdater.notifyAppReady() e che l'app sia stata completamente chiusa e riaperta.
   • Se vedi un messaggio di errore, cerca il messaggio di errore specifico nei Capgo documenti o contatta il supporto per aiuto.

Il comando di debug è particolarmente utile per identificare problemi con il download e l'installazione dell'aggiornamento. Se i registri mostrano la versione di aggiornamento attesa trovata ma non applicata, concentra la tua ricerca di problemi sui passaggi dopo il download.

Debugging con registri nativi

Inoltre, oltre al comando di debug Capgo, i log nativi su Android, iOS e Electron possono fornire informazioni di risoluzione dei problemi preziose, soprattutto per problemi sul lato nativo del processo di aggiornamento.

Log di Android

Per accedere ai log di Android:

1. Connetti il tuo dispositivo o avvia il tuo emulatore
2. Apre il tuo studio Android e seleziona “Visualizza > Finestre degli strumenti > Logcat”
3. Nella finestra Logcat, filtra i log per mostrare solo il processo del tuo'applicazione selezionandolo dal menu a discesa in alto
4. Cerca eventuali righe che includono Capgo per trovare i log SDK

Alternativamente, puoi utilizzare il adb logcat comando e cerca con grep per Capgo per filtrare i log.

Il Capgo SDK registrerà gli eventi chiave durante il processo di aggiornamento, ad esempio:

• Quando viene avviata la verifica dell'aggiornamento
• Se viene trovato un aggiornamento e di quale versione si tratta
• Quando inizia e si completa il download dell'aggiornamento
• Quando viene attivato l'installazione dell'aggiornamento
• Qualsiasi errore che si verifica durante i passaggi di aggiornamento nativi

I problemi di connettività di rete che impediscono il download dell'aggiornamento

• Errori di autorizzazione dei file quando si salva o si legge il pacchetto di aggiornamento
• Spazio di archiviazione insufficiente per il pacchetto di aggiornamento
• Fallimento del riavvio dell'app dopo l'installazione dell'aggiornamento
• Problemi comuni specifici di Android che potresti vedere nei log includono:

Registri iOS

Per accedere ai registri iOS:

1. Connetti il tuo dispositivo o avvia il tuo simulatore
2. Apri Xcode e vai a “Finestra > Dispositivi e simulatori”
3. Seleziona il tuo dispositivo e clicca su “Apri Console”
4. Nel output della console, cerca righe che includono Capgo per trovare i registri SDK

Puoi anche utilizzare il log stream comando nella finestra di comando e cerca con Capgo per filtrare i registri.

Simile all'Android, i Capgo SDK registreranno gli eventi chiave iOS-side:

• Iniziazione e risultato del controllo di aggiornamento
• Inizio, progressione e completamento del download
• Trigger e risultato dell'installazione
• Qualsiasi errore durante il processo di aggiornamento nativo

I problemi specifici di iOS che potresti identificare nei log includono:

• Problemi con il certificato SSL durante il download dell'aggiornamento
• Blocco dell'aggiornamento del download da parte della sicurezza dell'applicazione
• Spazio di archiviazione insufficiente per il bundle di aggiornamento
• Fallimento nell'estrazione o nell'applicazione corretta del bundle di aggiornamento

Elenchi dei log di Electron

Per le app di Electron, controlla sia l'output del processo principale che del processo renderer:

1. Esegui l'app Electron dal tuo terminale utilizzando il tuo comando di avvio normale (ad esempio bun run electron:dev o bun run electron:serve) e osserva l'output del terminale per le verifiche di avvio, gli aggiornamenti e gli errori di rete.
2. Apri gli strumenti di sviluppatore nella finestra del renderer (Visualizza → Alternare strumenti di sviluppo) e ispeziona i registri del console e le richieste di rete fallite mentre si riproduce il flusso di aggiornamento.
3. Per le app pacchettizzate, controlla gli strumenti di log del sistema per gli errori o le fallite di avvio:
   • macOS: apri Console.app e filtra sul nome del tuo app
   • Windows: apri Event Viewer → Windows Logs → Application
   • Linux: utilizza il tuo visualizzatore di log desktop o journalctl per il processo dell'applicazione

Quando si debuggano gli aggiornamenti, confrontare i messaggi dai log dei processi principale e renderer per separare le questioni di avvio di Electron dalle questioni di ciclo di vita degli aggiornamenti Capgo.

Sui vari sistemi operativi, i log nativi forniscono una visione a livello inferiore del processo di aggiornamento, con più dettagli sulla implementazione nativa. Sono specialmente utili per l'identificazione delle questioni che si verificano al di fuori della layer JavaScript Capgo.

Quando si risolve un problema di aggiornamento live complesso, è una buona idea catturare sia i log di debug Capgo che i log nativi per una visione completa di cosa sta accadendo. I due log insieme daranno la migliore possibilità di identificare e risolvere il problema.

Gli aggiornamenti non si applicano

Se hai caricato un bundle ma non vedi le modifiche sul tuo dispositivo:

• Assicurati di aver chiamato CapacitorUpdater.notifyAppReady() nel tuo app code come mostrato nel quickstart
• Verifica che il tuo dispositivo sia collegato a Internet e i Capgo log di debug mostrino che l'aggiornamento è stato scaricato
• Prova a chiudere completamente e riaprire l'applicazione, poiché gli aggiornamenti vengono applicati solo alla prima avviatura
• Cerca eventuali errori nei log nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Consultare il deploying live updates guide per ulteriori informazioni sul processo di aggiornamento. Se sei ancora bloccato, utilizza il npx @capgo/cli@latest app debug command e i log nativi per ottenere maggiore visibilità su cosa sta accadendo.

Codici di errore comuni per gli aggiornamenti

Se i tuoi log mostrano errori di backend come disable_auto_update_to_major, semver_error, o cannot_update_via_private_channel, utilizza la guida dedicata:

• Problemi di Aggiornamento Comuni

Spiega cosa significa ogni problema comune code, perché accade e come risolverlo.

SDK di Installazione

Se hai difficoltà nell'installare il Capgo SDK, assicurati:

• Il tuo app utilizza una versione supportata di Capacitor (4.0 o successiva)
• Hai seguito i passaggi del quickstart in ordine, compreso il sincronizzazione dell'app dopo l'installazione del SDK

Integrazione CI/CD

Per problemi con l'attivazione degli upload Capgo dal tuo flusso di lavoro CI/CD:

• Controlla che il tuo token di autenticazione Capgo sia configurato correttamente
• Assicurati di eseguire il comando di upload dopo che i tuoi asset web sono stati costruiti
• Verifica che il comando di upload stia utilizzando il nome del canale corretto per il tuo ambiente di destinazione

Vedi il documento per ulteriori suggerimenti di risoluzione dei problemi. Puoi anche utilizzare il npx @capgo/cli@latest app debug comando per confermare se gli aggiornamenti attivati dal tuo flusso di lavoro CI/CD stanno raggiungendo l'app.