Debugging
Comprendere i log del cloud:
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
| 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 |
| 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
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:
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
IOS
per trovare i tuoi log su Xcode
Android:
per trovare i tuoi log su Android studio
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
iOS
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
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