Debugging
Comprendere i log del cloud:
Section titled “Comprendere i log del cloud:”Inviati dal backend
Section titled “Inviati dal backend”| codice | Descrizione |
|---|---|
| InvalidIp | L’utente si trova in un data center Google e l’aggiornamento ha meno di 4 ore. Questo serve a impedire che i dispositivi dei bot di Google vengano contati come dispositivi nel tuo account |
| needPlanUpgrade (precedentemente needUpgrade) | Indica che hai raggiunto il limite del tuo piano e il dispositivo non riceverà aggiornamenti fino a quando non effettuerai l’upgrade o fino al mese successivo |
| noNew | Il dispositivo ha la versione più recente disponibile |
| disablePlatformIos | Il dispositivo è sulla piattaforma iOS, ma è disabilitata nelle impostazioni del canale |
| disablePlatformAndroid | Il dispositivo è sulla piattaforma Android, ma è disabilitata nelle impostazioni del canale |
| disableAutoUpdate | ”major" |
| disableAutoUpdateUnderNative | Il dispositivo ha la versione (123), e il canale ha un aggiornamento (122) sotto la versione del dispositivo da inviare, ma è disabilitato nelle impostazioni del canale |
| disableDevBuild | Il dispositivo ha una build di sviluppo, ma è disabilitata nelle impostazioni del canale |
| disableEmulator | Il dispositivo è un emulatore, ma è disabilitato nelle impostazioni del canale |
Inviati dal dispositivo
Section titled “Inviati dal dispositivo”| codice | Descrizione |
|---|---|
| get | Le informazioni per scaricare la nuova versione sono state inviate al dispositivo |
| delete | Un bundle è stato eliminato sul dispositivo |
| set | Un bundle è stato impostato sul dispositivo |
| set_fail | Il bundle non è riuscito a impostarsi |
| reset | Il dispositivo è stato resettato al bundle builtin |
| download_XX | È stato scaricato un nuovo bundle - progresso indicato da XX% (incrementi del 10%) |
| download_complete | Il nuovo bundle ha terminato il download |
| download_fail | Il nuovo bundle non è riuscito a scaricarsi |
| update_fail | Il nuovo bundle è stato installato ma non è riuscito a chiamare notifyAppReady |
| checksum_fail | Il nuovo bundle non è riuscito a validare il checksum. Se stai usando Capgo Cloud e riscontri questo errore, di solito significa che la versione della tua app sta aspettando un tipo di checksum diverso. L’ultima versione della CLI e dei plugin (versione 6.25.0 o 7+) utilizza checksum SHA256, mentre i vecchi plugin utilizzavano CRC32. Se vedi un errore di checksum, controlla se il checksum è CRC32 (un hash più corto) anziché SHA256. Questo di solito indica che il bundle è stato caricato con una vecchia versione della CLI. Verifica la versione del tuo bundle nella dashboard Capgo - i bundle creati dalla versione 6.25.0/7 dovrebbero usare SHA256. Se vedi checksum CRC32, assicurati di avere l’ultima versione del plugin installata localmente (la CLI controlla la tua versione locale del plugin per determinare quale tipo di checksum caricare), quindi aggiorna la tua CLI e ricarica il bundle. |
| windows_path_fail | Lo zip contiene file con percorsi Windows non validi |
| canonical_path_fail | Il percorso dei file non è canonico |
| directory_path_fail | C’è un errore nel percorso dei file zip |
| unzip_fail | Decompressione fallita |
| low_mem_fail | Download fallito per memoria insufficiente nel dispositivo |
Stato del bundle
Section titled “Stato del bundle”SUCCESS: installazione bundle completataERROR: installazione o download fallitoPENDING: Download completato, in attesa di rilascioDELETED: Bundle eliminato, ancora presente per le statisticheDOWNLOADING: Attualmente in download di un bundle
Comprendere i log del dispositivo:
Section titled “Comprendere i log del dispositivo:”Comando debug:
Section titled “Comando debug:”Esiste un comando debug per gli utenti di Capgo cloud
npx @capgo/cli@latest app debugQuesto ti permetterà di controllare tutti gli eventi che accadono nell’app e trovare una soluzione se gli aggiornamenti non avvengono
per trovare i tuoi log su Xcode
Android:
Section titled “Android:”per trovare i tuoi log su Android studio
Spiegazioni Log
Section titled “Spiegazioni Log”Failed to download from=> uguale a download_failnotifyAppReady was not called, roll back current bundle=> uguale a update_fail
Trovare il bundle scaricato nel tuo dispositivo
Section titled “Trovare il bundle scaricato nel tuo dispositivo”Per fare debug su iOS, devi esportare l’app sul tuo computer, puoi farlo così:
Xcode ha una funzionalità integrata per ispezionare il file system delle app installate per sviluppatori su un dispositivo iOS
Per farlo:
- Collega il tuo dispositivo al Mac e seleziona Window > Devices nella barra dei menu di Xcode
- Seleziona il tuo dispositivo nel pannello sinistro sotto la sezione Devices
- Questo mostrerà una lista delle app installate per sviluppatori per quel dispositivo
- Seleziona l’app che vuoi ispezionare e poi seleziona l’icona dell’ingranaggio vicino al fondo dello schermo
- Qui puoi visualizzare il file system corrente selezionando Show Container o scaricare uno snapshot
Selezionando Download Container scaricherà ed esporterà uno snapshot del file system come file xcappdata che puoi sfogliare
Fai clic destro su questo file e seleziona Show Package Contents per aprire la cartella
Apri la cartella App Data, e dovresti vedere alcune cartelle come Documents, Library, tmp, ecc

Poi troverai una versione in 2 cartelle:
library/NoCloud/ionic_built_snapshots è necessario dopo il riavvio dell’app
e documents/versions per l’hot reload
Android
Section titled “Android”Per fare debug su Android, devi accedere al dispositivo da Android Studio:
- Clicca View > Tool Windows > Device File Explorer o clicca il pulsante Device File Explorer nella barra degli strumenti per aprire Device File Explorer
- Seleziona un dispositivo dal menu a tendina
- Apri il percorso data/data/APP_NAME/ dove APP_NAME è l’ID della tua app

Poi trova la cartella versions per vedere tutte le versioni