Vai al contenuto

Debugging

Comprendere i log del cloud:

Inviati dal backend

codiceDescrizione
InvalidIpL’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
noNewIl dispositivo ha la versione più recente disponibile
disablePlatformIosIl dispositivo è sulla piattaforma iOS, ma è disabilitata nelle impostazioni del canale
disablePlatformAndroidIl dispositivo è sulla piattaforma Android, ma è disabilitata nelle impostazioni del canale
disableAutoUpdate”major"
disableAutoUpdateUnderNativeIl 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
disableDevBuildIl dispositivo ha una build di sviluppo, ma è disabilitata nelle impostazioni del canale
disableEmulatorIl dispositivo è un emulatore, ma è disabilitato nelle impostazioni del canale

Inviati dal dispositivo

codiceDescrizione
getLe informazioni per scaricare la nuova versione sono state inviate al dispositivo
deleteUn bundle è stato eliminato sul dispositivo
setUn bundle è stato impostato sul dispositivo
set_failIl bundle non è riuscito a impostarsi
resetIl dispositivo è stato resettato al bundle builtin
download_XXÈ stato scaricato un nuovo bundle - progresso indicato da XX% (incrementi del 10%)
download_completeIl nuovo bundle ha terminato il download
download_failIl nuovo bundle non è riuscito a scaricarsi
update_failIl nuovo bundle è stato installato ma non è riuscito a chiamare notifyAppReady
checksum_failIl nuovo bundle non è riuscito a validare il checksum
windows_path_failLo zip contiene file con percorsi Windows non validi
canonical_path_failIl percorso dei file non è canonico
directory_path_failC’è un errore nel percorso dei file zip
unzip_failDecompressione fallita
low_mem_failDownload fallito per memoria insufficiente nel dispositivo

Stato del bundle

  • SUCCESS: installazione bundle completata
  • ERROR: installazione o download fallito
  • PENDING: Download completato, in attesa di rilascio
  • DELETED: Bundle eliminato, ancora presente per le statistiche
  • DOWNLOADING: Attualmente in download di un bundle

Comprendere i log del dispositivo:

Comando debug:

Esiste un comando debug per gli utenti di Capgo cloud

Terminal window
npx @capgo/cli@latest app debug

Questo 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_fail
  • notifyAppReady 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

image

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

image

Poi trova la cartella versions per vedere tutte le versioni

Comprendere i log dei crash in produzione su iOS