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 di esperti è qui per aiutarti! Ottieni supporto personalizzato, code recensioni e soluzioni personalizzate adattate alle tue esigenze specifiche.

Otieni Supporto Professionale

Fallimenti di caricamento

Se il tuo caricamento di bundle fallisce, controlla:

• La tua ID applicazione in capacitor.config.ts corrisponde alla tua applicazione nel Capgo dashboard
• Sei sicuro di eseguire il comando di caricamento dalla radice del tuo progetto Capacitor
• Le tue risorse web sono state 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 resumabile 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 di lavoro. Passa la strada al 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 ha bisogno di questa informazione per poter correttamente pacchettizzare le dipendenze dell'applicazione.

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

Se hai ancora problemi con i caricamenti, contatta il Capgo supporto Per ulteriori 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. Eseguire 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. Sarà registrato l'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 di 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 viene installato, assicurati di aver chiamato CapacitorUpdater.notifyAppReady() e che l'app sia stata completamente chiusa e riaperta.
   • Se si visualizza un messaggio di errore, cerca di reperire informazioni specifiche su quel messaggio di errore nei documenti Capgo o contatta il supporto per ricevere aiuto.

La riga di 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 attività di risoluzione dei problemi sui passaggi dopo il download.

Debug con registri nativi

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

Registri di 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 dal menu a discesa in alto
4. Cerca righe che includono Capgo per trovare i registri SDK

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

I registri 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 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 di connettività di rete che impediscono il download dell'aggiornamento

• Errori di permessi di 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

Sezione intitolata “Log di iOS”

Collega il tuo dispositivo o avvia il tuo simulatore

1. Common iOS-specific issues you might see in the logs include:
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 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 sul lato iOS:

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

Issue specifici iOS che potresti identificare nei log includono:

• Il problema dei certificati SSL quando si scarica l'aggiornamento
• L'applicazione di sicurezza dei trasporti 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 applicazioni di Electron, controlla sia l'output del processo principale che del processo renderer:

1. Eseguisci l'applicazione di Electron dal tuo terminale utilizzando il comando di lancio normale (ad esempio bun run electron:dev o bun run electron:servePer le applicazioni di Electron, controlla sia l'output del processo principale che del processo renderer:
2. Esegui l'applicazione di Electron dal tuo terminale utilizzando il comando di lancio normale (ad esempio
3. Per le applicazioni pacchettizzate, controlla gli strumenti di registrazione del sistema per gli errori di 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

Quando si debuggano gli aggiornamenti, confrontare i messaggi provenienti da entrambi i registri dei processi main e renderer per separare le questioni di avvio di Electron da Capgo le questioni del ciclo di vita degli aggiornamenti.

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

Quando si risolve 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.

Gli aggiornamenti non si applicano

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

• Assicurarsi di aver chiamato CapacitorUpdater.notifyAppReady() in applicazione code come mostrato nel quickstart
• Verificare che il dispositivo sia connesso a Internet e che i Capgo registri 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
• Cercare eventuali errori nei registri nativi che potrebbero indicare un problema nell'applicazione dell'aggiornamento

Riferirsi al aggiornamento 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 una maggiore visibilità su cosa sta accadendo.

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

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

SDK Installazione

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 nell'ordine, compreso il sincronizzazione dell'app dopo l'installazione del __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
• Integrazione CI/CD
• Passaggi del quickstart

Vedi i documenti di integrazione CI/CD per ulteriori consigli 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'applicazione.

Continua da qui: Sezione intitolata “Continua da qui: Sezione intitolata “

Risoluzione dei problemi context: Pagina/Area: Supporto / sezione di supporto premium o sezione di supporto del footer. Ruolo: Intestazione di sezione o pagina. Visualizzato in: pagina support-policy.astro. Chiave di messaggio `support_policy_troubleshooting_title` (Titolo di politica di supporto per la 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 Utilizzare @capgo/capacitor-dati-di-archiviazione-sqlite @capgo/capacitor-file per la dettaglio di implementazione in @capgo/capacitor-file Utilizzare @capgo/capacitor-file per la capacità nativa in Utilizzare @capgo/capacitor-file, e @capgo/capacitor-uploader for the implementation detail in @capgo/capacitor-uploader.