Troubleshooting

Ecco alcune questioni 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 tuo bundle fallisce, controlla:

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

Opzioni di caricamento avanzate

Il Capgo CLI fornisce alcune flag aggiuntive per aiutare con i problemi di caricamento comuni:

• --tusUtilizza il protocollo di caricamento resumabile tus Utilizza il protocollo di caricamento resumabile tus per upload più affidabili di grandi bundle o in connessioni di rete scarse. Se il tuo bundle supera i 10MB o sei su una connessione instabile, considera l'uso di --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 spazio dei lavori. Passa il percorso alla 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 bundle le dipendenze della tua app.

Puoi combinare queste bandiere con altre opzioni come --channel a seconda delle tue esigenze. Consulta i Capgo CLI documenti per avere informazioni dettagliate su tutte le opzioni di caricamento disponibili.

Se hai ancora difficoltà con il caricamento, 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 risolvere i problemi. Per utilizzarlo:

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

   npx @capgo/cli@latest app debug

2. Lanciare l'applicazione su un dispositivo o emulatore e eseguire l'azione che dovrebbe attivare l'aggiornamento (ad esempio, riaprire l'applicazione dopo aver caricato un nuovo bundle).

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

   • Quando l'applicazione controlla l'aggiornamento
   • Se viene trovato un aggiornamento e di quale versione si tratta
   • Progresso del download e dell'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 nuovamente che il bundle sia stato caricato con successo e che l'applicazione sia configurata per utilizzare il canale corretto.
   • Se l'aggiornamento viene scaricato ma non installato, assicurati di aver chiamato CapacitorUpdater.notifyAppReady() e che l'applicazione sia stata completamente chiusa e riaperta.
   • Se vedi un messaggio di errore, cerca l'errore specifico nei Capgo documenti o contatta il supporto per aiuto.

The command di debug è particolarmente utile per l'identificazione di problemi con il processo di download e installazione dell'aggiornamento. Se i log mostrano la versione di aggiornamento prevista trovata ma non applicata in ultima analisi, concentrare la tua ricerca di risoluzione dei problemi sui passaggi dopo il download.

Debugging con Log nativi

In aggiunta al comando di debug Capgo, i log nativi su Android, iOS e Electron possono fornire informazioni di troubleshooting 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. Apri Android Studio e seleziona “Visualizza > Finestre di strumenti > Logcat”
3. Nella finestra di Logcat, filtra i log per mostrare solo il processo dell'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 e cercare con grep per Capgo per filtrare i log.

Il Capgo SDK registreranno 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

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

• Gli errori di autorizzazione dei file quando si salva o si legge il bundle di aggiornamento
• Problemi comuni specifici di Android che potresti vedere nei log includono:
• Spazio di archiviazione esaurito per il bundle di aggiornamento
• Impossibilità di riavviare l'app dopo l'installazione dell'aggiornamento

Log di iOS

Per accedere ai log di iOS:

1. Collega 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. Nella console, cerca le righe che includono Capgo per trovare i SDK log

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

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

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

I problemi relativi ai certificati SSL quando si scarica l'aggiornamento

• Blocco dell'aggiornamento del download da parte della sicurezza dei trasporti dell'app
• Spazio di archiviazione insufficiente per il bundle dell'aggiornamento
• Fallimento nell'estrazione o nell'applicazione corretta del bundle dell'aggiornamento
• Log di Electron

iOS-specific issues you might identify in the logs include:

Per le app di Electron, controlla sia l'output del processo principale che di quello 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 le informazioni di avvio, le verifiche di aggiornamento e gli errori di rete.
2. Apri gli strumenti di sviluppatore nella finestra del renderer (Visualizza → Alternare strumenti di sviluppo) e ispeziona i registri di 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 crash o fallimenti di avvio:
   • macOS: apri Console.app e filtra sul nome dell'app
   • Windows: apri Visualizzatore di eventi → Registri di Windows → Applicazione
   • Linux: utilizza il tuo visualizzatore di log desktop o journalctl per il processo dell'app

When debugging aggiornamenti, confronta i messaggi da entrambi i registri del processo principale e del processo renderer per separare le questioni di avvio di Electron da Capgo le questioni di ciclo di vita degli aggiornamenti.

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

When si sta risolvendo un problema di aggiornamento live complesso, è una buona idea catturare sia i Capgo registri di debug che i registri nativi per una rappresentazione completa di cosa sta succedendo. I due registri 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() in il tuo app code come mostrato nel quickstart
• Verifica che il tuo dispositivo sia connesso a Internet e i Capgo log di debug mostrino l'aggiornamento scaricato
• Prova a chiudere completamente e riaprire l'app, poiché gli aggiornamenti vengono applicati solo al lancio fresco
• Cerca eventuali errori nei log nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Riferiti al aggiornamento live guida per ulteriori informazioni sul processo di aggiornamento. Se sei ancora bloccato, utilizza il npx @capgo/cli@latest app debug comando e i log nativi per ottenere una maggiore visibilità su cosa sta accadendo.

Codici di errore comuni dell'aggiornamento

If i tuoi log mostrano errori 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 code comune, perché accade e come risolverlo.

SDK Installation

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, compresa la sincronizzazione dell'app dopo l'installazione del SDK

Integrazione CI/CD

Per i problemi relativi al trigger dei caricamenti 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 caricamento dopo che i tuoi asset web sono stati costruiti
• Verifica che il comando di caricamento stia utilizzando il nome del canale corretto per il tuo ambiente di destinazione

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

Sezione intitolata “Continua da Troubleshooting”

If sei stai utilizzando Risoluzione dei problemi 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, Utilizzando @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Utilizzando @capgo/capacitor-file per la capacità nativa in Utilizzando @capgo/capacitor-file, e @capgo/capacitor-uploader per i dettagli di implementazione in @capgo/capacitor-uploader.