Troubleshooting

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

Se il caricamento del bundle fallisce, controlla:

• Il tuo ID applicazione in capacitor.config.ts corrisponde al tuo app in il Capgo dashboard
• Stai eseguendo il comando di caricamento dalla radice del tuo progetto Capacitor
• I tuoi asset web sono costruiti e aggiornati

Opzioni di upload avanzate

Il Capgo CLI fornisce alcune flag aggiuntive per aiutare con le comuni problematiche di upload:

• --tus: Utilizza il protocollo di upload resumable tus per upload più affidabili di grandi bundle o su connessioni di rete deboli. Se il tuo bundle supera i 10MB o sei su una connessione spessa, considera l'uso di --tus:

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

• --package-json e --node-modules: Insegna al Capgo dove trovare la radice package.json e node_modules Se il tuo app utilizza una struttura non standard come un repository unico o npm spazio dei lavoro. Passa il percorso alla radice package.json e --node_modules path:

  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 compilare correttamente le dipendenze del tuo app.

Puoi combinare questi flag con altre opzioni come --channel come necessario. Vedi i Capgo CLI documenti per avere informazioni dettagliate sulle opzioni di caricamento disponibili.

Se hai ancora problemi con i caricamenti, contatta Capgo supporto For ulteriori assistenza.

Aggiornamenti di debug

If you’re encountering issues with live updates, the Capgo debug command is a helpful tool for troubleshooting. To use it:

1. Fenestra del terminale

   npx @capgo/cli@latest app debug

2. Guarda l'output del comando di debug. Sarà registrato informazioni sull'aggiornamento, comprese:

3. Quando l'app controlla gli aggiornamenti

   • Se viene trovato un aggiornamento e di quale versione si tratta
   • Progresso di download e installazione per l'aggiornamento
   • Seleziona il dispositivo o l'emulatore per l'aggiornamento
   • Qualsiasi errore che si verifica durante il processo di aggiornamento

4. Usa 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 viene installato, assicurati di aver chiamato CapacitorUpdater.notifyAppReady() e che l'app sia stata chiusa e riaperta completamente.
   • Se vedi un messaggio di errore, cerca il messaggio di errore specifico nei documenti Capgo 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 prevista trovata ma non applicata, concentra la tua ricerca di errori sui passaggi dopo il download.

Debugging con Log nativi

Inoltre ai registri di debug del Capgo si aggiungono i registri nativi di Android, iOS e Electron, che possono fornire informazioni di troubleshooting preziose, soprattutto per problemi sul lato nativo del processo di aggiornamento.

Log di Android

To accedere ai log di Android:

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

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

I log Capgo SDK registreranno gli eventi chiave durante il processo di aggiornamento, ad esempio:

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

Il problema comune di connettività di rete che impedisce il download dell'aggiornamento

• Errori di autorizzazione dei file quando si salva o si legge il bundle di aggiornamento
• Spazio di archiviazione esaurito per il bundle di aggiornamento
• Fallimento nel riavviare l'app dopo l'installazione dell'aggiornamento
• Log di iOS

Sottosezione intitolata “Log di iOS”

Collega il tuo dispositivo o avvia il tuo simulatore

1. Collega il tuo dispositivo o avvia il tuo simulatore
2. Apri Xcode e vai a ‘Finestra > Dispositivi e Simulatori’
3. Scegli il tuo dispositivo e clicca su ‘Apri Console’
4. Nel output della console, cerca eventuali righe che includono Capgo per trovare i SDK log

Puoi anche utilizzare il log stream comando nella finestra dei comandi e grep per Capgo per filtrare i log.

Simile all'Android, il Capgo SDK registrerà gli eventi chiave iOS:

• L'iniziazione e il risultato del controllo di aggiornamento
• L'inizio, il progresso e la completa del download
• L'attivazione e il risultato dell'installazione
• Qualsiasi errore durante il processo di aggiornamento nativo

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

• Problemi di certificato SSL quando si scarica l'aggiornamento
• La sicurezza dei trasporti dell'app blocca il download dell'aggiornamento
• Spazio di archiviazione insufficiente per il bundle dell'aggiornamento
• Fallimento nell'estrazione o nell'applicazione corretta del bundle dell'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 di Electron dal tuo terminale utilizzando il comando di avvio normale (ad esempio bun run electron:dev o bun run electron:serve) e osserva l'output del terminale per l'avvio, le verifiche degli aggiornamenti e gli errori di rete.
2. Apri gli Strumenti di sviluppatore nella finestra del renderer (Visualizza → Alternare gli Strumenti di sviluppatore) e ispeziona i log del console e le richieste di rete fallite mentre si riproduce il flusso di aggiornamento.
3. Per le app pacchettizzate, controlla gli strumenti di registrazione del sistema per le crash o le fallite di avvio:
   • macOS: apri Console.app e filtra sul nome della tua app
   • Windows: apri Event Viewer → Windows Logs → Application
   • Linux: utilizza il tuo visualizzatore di log desktop o journalctl per il processo della tua app

When si verificano gli aggiornamenti, confrontare i messaggi provenienti da entrambi i log del processo principale e del processo renderer per separare le questioni di avvio di Electron da Capgo le questioni del ciclo di vita degli aggiornamenti.

Across piattaforme, i log nativi forniscono una visione a livello inferiore del processo di aggiornamento, con maggiori dettagli sulla implementazione nativa. Sono particolarmente utili per identificare le questioni che si verificano al di fuori della Capgo layer JavaScript.

When si risolve un problema di aggiornamento in tempo reale complesso, è una buona idea catturare entrambi i Capgo log di debug e i log nativi per una visione completa di cosa sta succedendo. I due log insieme daranno la migliore possibilità di identificare e risolvere il problema.

Gli aggiornamenti non si applicano

Se si è caricato un bundle ma non si vedono le modifiche sul dispositivo:

• Assicurarsi di aver chiamato CapacitorUpdater.notifyAppReady() nel proprio app code come mostrato nel quickstart
• Verificare che il dispositivo sia connesso a Internet e i Capgo log di debug mostrino che l'aggiornamento è stato scaricato
• Prova a chiudere completamente e riaprire l'app, poiché gli aggiornamenti vengono applicati solo al lancio fresco
• Cercare eventuali errori nei log nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Consultate il guide per ulteriori informazioni sul processo di aggiornamento. Se sei ancora bloccato, utilizza il e i log nativi per ottenere una maggiore visibilità su cosa sta succedendo. npx @capgo/cli@latest app debug Codici di errore comuni di aggiornamento

Sezione intitolata “Codici di errore comuni di aggiornamento”

, o disable_auto_update_to_major, semver_error, utilizza la guida dedicata: cannot_update_via_private_channelProblemi di Aggiornamento Comuni

• Spiega cosa significa ogni __CAPGO_KEEP_0__ comune, perché accade e come risolvere il problema.

code Installation

installazione di SDK

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

• La tua app utilizza una versione supportata di Capacitor (4.0 o successiva)
• Hai seguito i passaggi del quickstart nella giusta sequenza, compreso il sincronizzazione della tua app dopo l'installazione del SDK

Integrazione CI/CD

Per problemi con l'attivazione degli upload Capgo dalla tua pipeline CI/CD:

• Duplica la verifica del tuo token di autenticazione Capgo
• Assicurati di eseguire il comando di upload dopo la creazione dei tuoi asset web
• Verifica che il comando di upload utilizzi il nome del canale corretto per il tuo ambiente di destinazione

Vedi anche Integrazione CI/CD le informazioni per ulteriori suggerimenti di risoluzione dei problemi. Puoi anche utilizzare il npx @capgo/cli@latest app debug comando per confermare se le tue aggiornamenti attivati da CI/CD vengono ricevuti dall'app.

Continua da Troubleshooting

Se stai utilizzando Troubleshooting per pianificare lo storage e il trattamento dei file, connettilo con @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizza @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzare @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file per il dettaglio di implementazione in @capgo/capacitor-file, Utilizzare @capgo/capacitor-file per la capacità nativa in Utilizzare @capgo/capacitor-file, e @capgo/capacitor-uploader per il dettaglio di implementazione in @capgo/capacitor-uploader.