Log dei crash

Panoramica

I log dei crash sono strumenti diagnostici preziosi che aiutano gli sviluppatori a identificare e correggere problemi e bug che causano il crash o un comportamento inatteso dell'applicazione. È possibile condividere i log dal proprio dispositivo Android con il team di sviluppo di OsmAnd. Attualmente, gli utenti iOS hanno solo un tipo di opzione per l'invio dei log dei crash.

Log dei crash e Log dell'app

OsmAnd consente di inviare due tipi di dati agli sviluppatori:

• Log dei crash. Generati quando l'app OsmAnd incontra un errore critico o un'eccezione che ne causa il crash. Questi log forniscono informazioni dettagliate sullo stato dell'applicazione durante il guasto, inclusi dati di build, stack trace, messaggi di errore e altri dettagli rilevanti.
• Log della sessione/app corrente. Un registro del flusso di log di OsmAnd che cattura vari eventi e messaggi. Questi log aiutano gli sviluppatori a monitorare il comportamento dell'app, a tracciare il flusso di esecuzione, a tracciare azioni specifiche e a indagare su problemi non correlati ai crash. I logcat log di solito contengono registrazioni dell'attività dal momento in cui l'app è stata avviata l'ultima volta.

Le tue informazioni private

Fai attenzione quando invii i log dell'app, poiché potrebbero contenere informazioni private come la posizione del dispositivo, le query di ricerca, i risultati della creazione di percorsi e i dati di navigazione.

Invia log dall'app OsmAnd

Android

iOS

1. Vai a Menù → Aiuto → Invia rapporto errori o Invia registro logcat (Invia log dell'app corrente su iOS). A seconda della tua situazione, seleziona il tipo di log appropriato. Puoi fare riferimento alla sezione Log dei crash e Log dell'app per i dettagli sulle differenze tra i tipi di log.
2. Nel menu a comparsa, scegli Gmail o la tua app di posta elettronica preferita. Ti consigliamo di inviare i log a support@osmand.net.
3. Tocca il pulsante Send.

Invia file Tombstone (Android)

Cruciale

Solo per utenti avanzati!

In certi casi complessi o insoliti, potrebbero essere richiesti i file Tombstone. Questi file forniscono stack trace dettagliate per tutti i thread in un processo che si blocca (non solo quello che ha causato l'errore), una mappa di memoria completa e un elenco di tutti i descrittori di file aperti. I file Tombstone sono vitali per il debug e la diagnosi di problemi relativi al codice nativo sulla piattaforma Android.

Utilizzo del tuo dispositivo

Per esportare i file tombstone, è necessario generare un report di bug utilizzando le impostazioni di sistema Android:

1. Abilita le Opzioni sviluppatore (questa schermata è nascosta per impostazione predefinita).

   • Vai a Impostazioni → Informazioni sul telefono → Informazioni software (questo percorso è valido per i dispositivi Samsung).
   • Tocca Numero build sette volte finché un pop-up non conferma che la modalità sviluppatore è attiva.

2. Vai a Opzioni sviluppatore, solitamente situate in fondo all'elenco delle impostazioni. Puoi anche utilizzare la funzione di ricerca.

   • Tocca l'opzione Acquisisci report bug.
   • Seleziona il tipo di report bug e tocca Report.

Dopo che il report bug è pronto, riceverai una notifica. Tocca la casella di notifica per scaricare il report sul tuo dispositivo. Decomprimi il file e invia i file tombstone al team di sviluppatori di OsmAnd (email: support@osmand.net).

note

Si prega di notare che i report bug possono contenere dati privati, inclusi l'utilizzo dell'app o la posizione.

Utilizzo di ADB

L'Android Debugging Bridge (ADB) è uno strumento a riga di comando che consente agli sviluppatori di eseguire il debug delle proprie applicazioni. Per utilizzare ADB per esportare i file tombstone, dovrai prima scaricarlo e installarlo. Segui le istruzioni fornite sul sito ufficiale degli sviluppatori Android.

Prepara il tuo dispositivo

Assicurati che le Opzioni sviluppatore siano abilitate (questa schermata è nascosta per impostazione predefinita) e che il Debug USB sia attivato:

• Naviga in Impostazioni → Informazioni sul telefono → Informazioni software.
• Tocca Numero build sette volte finché un pop-up non conferma che la modalità sviluppatore è attiva.
• Nelle Opzioni sviluppatore, abilita il Debug USB.

Quindi, collega il tuo dispositivo alla tua workstation tramite USB. Se è la prima volta che ti connetti, apparirà un pop-up che chiede il permesso per consentire il debug.

Genera report bug

1. Apri un terminale a riga di comando. Su Mac o Linux, usa l'app Terminale, e su Windows, usa la Riga di comando.
2. Naviga nella cartella platform-tools dove si trova ADB usando il comando cd (ad esempio, ‘cd /Users/Username/Downloads/Tools’).
3. Genera il report bug:
   • Su Mac: adb bugreport
   • Su Windows: adb.exe bugreport
4. Attendi qualche minuto per la generazione del report. Il file risultante verrà salvato nella cartella platform tools.
5. Decomprimi il file.
6. Trova la cartella tombstones con file come tombstone_00, tombstone_01 e simili.
7. Invia i file tombstone a support@osmand.net.

Utilizzo di dispositivi rootati o Android Studio Emulator

• Con l'accesso root al tuo dispositivo, puoi aprire direttamente la cartella /data/tombstones.

• In Android Studio, usa l'emulatore per navigare in Device File Explorer e trovare la cartella /data/tombstones. All'interno, troverai file denominati come tombstone_00, tombstone_01 e altri. Scarica questi file e inviali a support@osmand.net.

Per maggiori dettagli sui report bug, fai riferimento alla documentazione Android.