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.

Otteni Supporto Professionale

Fallimenti di caricamento

Se il tuo caricamento del pacchetto fallisce, controlla doppio:

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

Opzioni di caricamento avanzate

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

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

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

• --package-json e --node-modules: Indica a Capgo dove trovare la tua root package.json e node_modules se la tua app utilizza una struttura non standard come un monorepo o npm workspace. Passa il percorso alla root 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 richiede questa informazione per poter bundle correttamente le dipendenze del tuo'applicazione.

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

Se hai ancora problemi con il caricamento, contatta il Capgo supporto per ulteriore assistenza.

Aggiornamenti di debug

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

1. Eseguire il seguente comando nel directory del tuo progetto:

   npx @capgo/cli@latest app debug

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

3. Guarda l'output del comando di debug. Sarà registrato l'informazione sul processo di aggiornamento, incluso:

   • Quando l'app verifica l'aggiornamento
   • Se viene trovato un aggiornamento e di quale versione si tratta
   • Progresso di download e installazione per l'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 nuovamente che il tuo bundle sia stato caricato con successo 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 la specifica voce di errore 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 prevista trovata ma non applicata, concentra la tua ricerca di problemi sui passaggi dopo il download.

Debugging con registri nativi

Inoltre alla Capgo comando di debug, i log nativi su Android, iOS e Electron possono fornire informazioni di risoluzione dei problemi preziose, soprattutto per le questioni relative alla parte nativa 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 Android Studio e seleziona “Visualizza > Finestre degli strumenti > Logcat”
3. Nella finestra di 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 SDK log

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

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

• When an update check is initiated
• 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

• Problemi di connessione di rete che impediscono il download dell'aggiornamento
• Spazio di archiviazione insufficiente per il bundle di aggiornamento
• Spazio di archiviazione esaurito per l'aggiornamento del bundle
• Fallimento nel riavviare l'app dopo l'installazione dell'aggiornamento

Registri iOS

Per accedere ai registri iOS:

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

Puoi anche utilizzare il log stream comando nel terminale e cerca con Capgo per filtrare i registri.

Simile all'Android, i registri Capgo SDK registreranno gli eventi chiave sul lato iOS:

• Avvio e risultato della verifica dell'aggiornamento
• Inizio, progressione e completamento del download
• Triggers e risultati dell'installazione
• Qualsiasi errore durante il processo di aggiornamento nativo

Problemi di certificato SSL quando si scarica l'aggiornamento

• Problemi con il certificato SSL durante il download dell'aggiornamento
• Spazio di archiviazione insufficiente per il bundle di aggiornamento
• Spazio di archiviazione insufficiente per l'aggiornamento del pacchetto.
• Fallimento nell'estrazione o nell'applicazione del pacchetto di aggiornamento

Sottosezione intitolata “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:servee monitora l'output del terminale per le verifiche di avvio, aggiornamento e errori di rete.
2. Esegui l'app Electron dal tuo terminale utilizzando il tuo comando di avvio normale (ad esempio, per esempio, l'alternativa a Capacitor Live Update, Appflow o Capawesome).
3. For packaged apps, check OS log tools for crashes or startup failures:
   • macOS: open Console.app e filtra per il nome del tuo app
   • Windows: open Visualizzatore degli Eventi → Registri di Windows → Applicazione
   • Linux: utilizza il tuo visualizzatore di log desktop o journalctl per il processo dell'app

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

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

Quando si affronta un problema live update difficile da risolvere, è una buona idea catturare sia i log di debug Capgo che 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.

Aggiornamenti non applicati

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

• Assicurati di aver chiamato CapacitorUpdater.notifyAppReady() nella tua app code come mostrato nella avvio rapido
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• Prova a chiudere completamente e riaprire l'app, poiché gli aggiornamenti vengono applicati solo alla prima avviatura
• Cerca eventuali errori nei registri nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Consultare il aggiornamento in tempo reale codice e i registri nativi per ottenere una maggiore visibilità su cosa sta accadendo. npx @capgo/cli@latest app debug acquisisci maggior visibilità sulle registrazioni del comando e dei log nativi.

Sottosezione intitolata "Codici di errore comuni"

Se i tuoi log mostrano errori backend come disable_auto_update_to_major, semver_error, or cannot_update_via_private_channelUtilizza la guida dedicata:

• Problemi di Aggiornamento Comuni

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

SDK di Installazione

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

• Che la tua app utilizzi una versione supportata di Capacitor (4.0 o successiva)
• Hai seguito le quickstart passaggi in ordine, inclusa la sincronizzazione dell'app dopo l'installazione del SDK

Integrazione CI/CD

Per problemi di attivazione delle Capgo upload dal tuo pipeline CI/CD:

• Double check your Capgo authentication token is set up correctly
• Assicurati di eseguire il comando di caricamento dopo che i tuoi asset web sono stati costruiti
• Verifica che il comando di caricamento utilizzi il nome del canale corretto per l'ambiente di destinazione

Vedi i Integrazione CI/CD docs for more troubleshooting tips. You can also use the npx @capgo/cli@latest app debug comando per confermare se gli aggiornamenti attivati dal flusso di lavoro CI/CD vengono ricevuti dall'app.

Continua dall'elenco dei problemi

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