Troubleshooting

Ecco alcuni problemi comuni che potresti incontrare mentre utilizzi Capgo e come risolverli.

🚀 Hai bisogno di Aiuto Esperto?

Sei 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.

Ottenere Supporto Professionale

Fallimenti nell'upload

Se il tuo upload del bundle fallisce, controlla:

• Che il tuo ID applicazione in __CAPGO_KEEP_0__ corrisponda al tuo app in __CAPGO_KEEP_0__ dashboard capacitor.config.ts Se stai eseguendo il comando di upload dalla radice del tuo progetto Capgo
• Se il tuo upload del bundle fallisce, controlla che il tuo ID applicazione in Capacitor corrisponda al tuo app in Capacitor dashboard e che stai eseguendo il comando di upload dalla radice del tuo progetto Capacitor
• Le tue risorse web sono costruite e aggiornate

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 resumable di tus per caricamenti più affidabili di grandi bundle o su connessioni di rete scarse. Se il tuo bundle supera i 10 MB o sei su una connessione instabile, considera l'uso di --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 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 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 del tuo app

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

Se hai ancora problemi con i caricamenti, contatta il Capgo supporto per ulteriori informazioni.

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 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. Viene registrata informazione sull'aggiornamento, comprese:

   • 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
   • 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 bundle sia stato caricato con successo 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 completamente e riaperta.
   • Se si visualizza un messaggio di errore, cerca l'errore specifico nei Capgo documenti o contatta il supporto per aiuto.

La comandi di debug è particolarmente utile per l'identificazione dei 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

In aggiunta alla comandi di debug Capgo, i registri nativi su Android, iOS e Electron possono fornire informazioni di troubleshooting preziose, soprattutto per i problemi sul lato nativo del processo di aggiornamento.

Registri Android

Per accedere ai registri Android:

1. Collega il tuo dispositivo o avvia l'emulatore
2. Apri Android Studio e seleziona "Visualizza > Finestre degli strumenti > Logcat"
3. Nella finestra Logcat, filtra i registri per mostrare solo il processo dell'applicazione selezionandolo dalla lista a discesa in alto
4. Cerca righe che includono Capgo per trovare i registri SDK

Alternativamente, puoi utilizzare il comando e cercare con adb logcat per filtrare i registri. Capgo I registri __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ registreranno gli eventi chiave durante il processo di aggiornamento, ad esempio:

The Capgo SDK will log key events during the update process, such as:

• Se viene trovato un aggiornamento e di quale versione si tratta
• Per ulteriori informazioni, consulta il
• When l'aggiornamento inizia a scaricare e si completa
• When l'installazione dell'aggiornamento viene attivata
• Qualsiasi errore che si verifica durante i passaggi di aggiornamento nativi

Problemi comuni specifici di Android che potresti vedere nei log includono:

• Problemi di connettività di rete che impediscono il download dell'aggiornamento
• Errori di autorizzazione dei file quando si salva o si legge il bundle di aggiornamento
• Spazio di archiviazione insufficiente per il bundle di aggiornamento
• Fallimento del riavvio dell'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. 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 cerca con Capgo per filtrare i log.

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

• La verifica dell'aggiornamento e il risultato
• L'inizio, il progresso e la fine del download
• L'attivazione e il risultato dell'installazione
• Qualsiasi errore durante il processo di aggiornamento nativo

Problemi specifici di iOS che potresti identificare nei log includono:

• Problemi con il certificato SSL quando si scarica l'aggiornamento
• L'applicazione trasporto sicurezza blocca il download dell'aggiornamento
• Spazio di archiviazione insufficiente per il bundle di aggiornamento
• Fallimento nell'estrazione o nell'applicazione del bundle di aggiornamento

Log di Electron

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

1. Eseguisci l'app di Electron dal tuo terminale utilizzando il comando di lancio normale (ad esempio bun run electron:dev o bun run electron:servee osserva l'output del terminale per avvio, controlli di aggiornamento e errori di rete.
2. Esegui l'app di Electron dal tuo terminale utilizzando il comando di lancio normale (ad esempio
3. Per le app pacchettizzate, controlla gli strumenti di registrazione del sistema per le crash o i fallimenti di avvio:
   • macOS: apri Console.app e filtra sul nome della tua app
   • Windows: apri Event Viewer → Windows Logs → Application
   • contextLinux journalctl : utilizza il tuo visualizzatore di log desktop o

Quando si debuggano 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 dalle questioni del ciclo di vita degli aggiornamenti Capgo.

Nelle piattaforme diverse, 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 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 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 i cambiamenti 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 che i log di debug Capgo mostrino che l'aggiornamento è stato scaricato
• Prova a chiudere completamente e riaprire l'app, poiché gli aggiornamenti vengono applicati solo alla prima avviatura
• Cerca eventuali errori nei log nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Riferirsi al aggiornamenti in tempo reale 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 maggiore visibilità su cosa sta succedendo.

Codici di errore comuni di aggiornamento

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

• Problemi di Aggiornamento Comuni

It explains what each common code means, why it happens, and how to fix it.

SDK Installation

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 nell'ordine, compresa la sincronizzazione dell'app dopo l'installazione di __CAPGO_KEEP_0__ Integrazione CI/CD steps in order, including syncing your app after installing the SDK

Per problemi con l'invio di __CAPGO_KEEP_0__ upload dal tuo flusso di lavoro CI/CD:

For issues with triggering Capgo uploads from your CI/CD pipeline:

• Double check your Capgo authentication token is set up correctly
• __CAPGO_KEEP_0__ Installation
• quickstart

Vedi i l'integrazione CI/CD i documenti per ulteriori consigli di risoluzione dei problemi. Puoi anche utilizzare il npx @capgo/cli@latest app debug comando per confermare se gli aggiornamenti attivati da CI/CD vengono ricevuti dall'applicazione.

Continua da qui dalla sezione di Risoluzione dei problemi

Se stai utilizzando Risoluzione dei problemi context: Pagina/Area: Supporto / supporto premium o sezione di supporto nel footer. Ruolo: Intestazione di sezione o pagina. Visto in: pagina support-policy.astro. Chiave di messaggio `support_policy_troubleshooting_title` (Titolo di supporto per la risoluzione dei problemi). @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, per la capacità nativa in Utilizzare @capgo/capacitor-dati-di-archiviazione-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-caricatore per il dettaglio di implementazione in @capgo/capacitor-caricatore.