🚀 Hai bisogno di un esperto?
Bloccato su un problema complesso? Il nostro team di esperti è a tua disposizione! Ricevi supporto personalizzato, revisioni code e soluzioni su misura per le tue esigenze specifiche.
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Ecco alcuni problemi comuni che potresti incontrare durante l'uso di Capgo e come risolverli.
🚀 Hai bisogno di un esperto?
Bloccato su un problema complesso? Il nostro team di esperti è a tua disposizione! Ricevi supporto personalizzato, revisioni code e soluzioni su misura per le tue esigenze specifiche.
Se l'upload del bundle fallisce, verifica di nuovo:
capacitor.config.ts corrisponde alla tua app nella dashboard CapgoIl Capgo CLI offre alcune flag aggiuntive per risolvere i problemi comuni di upload:
--tus: Utilizza il protocollo tus per upload resumable per upload più affidabili di bundle di grandi dimensioni o su connessioni di rete instabili. Se il tuo bundle supera i 10 MB o sei su una connessione instabile, valuta 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 la tua app utilizza una struttura non standard come un monorepo o un workspace npm. Passa il percorso alla root package.json e il --node_modules path:
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modulesCapgo ha bisogno di queste informazioni per bundlare correttamente le dipendenze della tua app.
Puoi combinare queste flag con altre opzioni come --channel se necessario. Consulta la documentazione di Capgo CLI per i dettagli completi sulle opzioni di upload disponibili.
Se hai ancora problemi con gli upload, contatta Supporto Capgo per ulteriore assistenza.
Se stai riscontrando problemi con Live Update, il comando di debug Capgo è uno strumento utile per la risoluzione dei problemi. Per utilizzarlo:
Esegui il seguente comando nella directory del progetto:
npx @capgo/cli@latest app debugAvvia l'app su un dispositivo o un emulatore ed esegui l'azione che dovrebbe attivare un aggiornamento (ad esempio, riapri l'app dopo aver caricato un nuovo bundle).
Monitora l'output del comando di debug. Registrerà informazioni sul processo di aggiornamento, tra cui:
Usa i log di debug per identificare dove si verifica il problema. Ad esempio:
CapacitorUpdater.notifyAppReady() e che l'app sia stata chiusa completamente e riaperta.Il comando debug è particolarmente utile per individuare problemi nel processo di download e installazione dell'aggiornamento. Se i log mostrano che la versione di aggiornamento prevista è stata trovata ma non applicata, concentra il troubleshooting sulle fasi successive al download.
Oltre al comando debug di Capgo, i log nativi su Android, iOS ed Electron possono fornire informazioni preziose per il troubleshooting, soprattutto per i problemi sul lato nativo del processo di aggiornamento.
Per accedere ai log di Android:
Capgo per trovare i log di SDKIn alternativa, puoi usare la adb logcat comando e usare grep per Capgo filtrare i log.
Il Capgo SDK logga gli eventi chiave durante il processo di aggiornamento, come:
I problemi comuni su Android che potresti trovare nei log includono:
Per accedere ai log iOS:
Capgo per trovare i log di SDKPuoi anche usare il log stream comando nel terminale e cerca con grep Capgo filtrare i log.
Come per Android, Capgo SDK registrerà gli eventi principali lato iOS:
I problemi specifici di iOS che potresti individuare nei log includono:
Per le app Electron, controlla l'output sia del main process che del renderer process:
bun run electron:dev oppure bun run electron:serve) e tieni d'occhio l'output del terminale per avvio, controlli degli update ed errori di rete.Console.app e filtra per il nome della tua appjournalctl per il processo della tua appDurante il debug degli aggiornamenti, confronta i messaggi dei log di main-process e renderer-process per distinguere i problemi di bootstrap di Electron dai problemi del ciclo di vita degli aggiornamenti Capgo.
Su tutte le piattaforme, i log nativi offrono una visione a livello inferiore del processo di aggiornamento, con maggiori dettagli sull'implementazione nativa. Sono particolarmente utili per identificare problemi che si verificano al di fuori dello strato JavaScript di Capgo.
Quando si risolvono problemi complessi di live update, è una buona idea catturare sia i log di debug di Capgo sia i log nativi per avere un quadro completo di ciò che sta accadendo. Insieme, i due log offrono la migliore possibilità di identificare e risolvere il problema.
Se hai caricato un bundle ma non vedi le modifiche sul dispositivo:
CapacitorUpdater.notifyAppReady() nella tua app code come mostrato nella quickstartConsulta la guida alla distribuzione degli aggiornamenti live per maggiori dettagli sul processo di aggiornamento. Se hai ancora problemi, usa il npx @capgo/cli@latest app debug comando e log nativi per avere maggiore visibilità su ciò che sta accadendo.
Se i tuoi log mostrano errori di backend come disable_auto_update_to_major, semver_error, o cannot_update_via_private_channel, usa la guida dedicata:
Spiega cosa significa ciascun code comune, perché si verifica e come risolverlo.
Se hai problemi con l'installazione di Capgo SDK, assicurati che:
Per problemi con il trigger degli upload Capgo dalla tua pipeline CI/CD:
Guarda il Integrazione CI/CD documentazione per ulteriori suggerimenti di troubleshooting. Puoi anche usare il npx @capgo/cli@latest app debug comando per verificare se gli aggiornamenti attivati da CI/CD vengono ricevuti dall'app.
Se stai usando Risoluzione problemi per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Utilizzo di @capgo/capacitor-file per la funzionalità nativa in Usare @capgo/capacitor-file, e @capgo/capacitor-uploader per i dettagli implementativi in @capgo/capacitor-uploader.