Crash Logs

Overzicht

Crash logs zijn waardevolle diagnostische hulpmiddelen die ontwikkelaars helpen bij het identificeren en oplossen van problemen en bugs die ervoor zorgen dat de applicatie crasht of zich onverwacht gedraagt. Het is mogelijk om logs van uw Android-apparaat te delen met het OsmAnd-ontwikkelteam. Momenteel hebben iOS-gebruikers slechts één type crashlog-optie om te verzenden.

Crash- en Logcat-logs

Met OsmAnd kunt u twee soorten gegevens naar ontwikkelaars sturen:

• Crash logs. Worden gegenereerd wanneer de OsmAnd-app een kritieke fout of uitzondering tegenkomt die ervoor zorgt dat deze crasht. Deze logs bieden gedetailleerde informatie over de status van de applicatie tijdens de storing, inclusief buildgegevens, stack traces, foutmeldingen en andere relevante details.
• Logcat logs. Een record van de OsmAnd-logstroom die verschillende gebeurtenissen en berichten vastlegt. Deze logs helpen ontwikkelaars het gedrag van de app te monitoren, de uitvoeringsstroom te volgen, specifieke acties te traceren en niet-crashgerelateerde problemen te onderzoeken. Logcat-logs bevatten meestal records van activiteit vanaf het moment dat de app voor het laatst is gestart.

Uw privé-informatie

Wees voorzichtig bij het verzenden van logcat-logs, aangezien deze privé-informatie kunnen bevatten, zoals apparaatlocatie, zoekopdrachten, routebouwresultaten en navigatiegegevens.

Logs verzenden vanuit de OsmAnd-app (Android)

1. Ga naar Menu → Hulp → Crashrapport verzenden (Logcat log verzenden). Afhankelijk van uw situatie, selecteert u het juiste type log. U kunt de sectie Crash- en Logcat-logs raadplegen voor details over de verschillen tussen de logtypen.
2. Kies in het pop-upmenu Gmail of uw favoriete e-mailapp. De e-mail wordt automatisch gegenereerd.
3. Tik op de knop Verzenden.

Logs verzenden vanaf iOS-apparaten

1. Logs van iOS-apparaten kunnen worden verzonden:

   • Automatisch.

     • Navigeer naar de OsmAnd-app [object Object] → Hulp → Een probleem melden (Verzend log).
     • Stuur vervolgens, met behulp van uw e-mailapp, de logs naar crash@osmand.net.

   • Handmatig.

     • Navigeer naar de iOS-systeemapp Bestanden → Op mijn iPhone (of Op mijn iPad) → OsmAnd Maps → Logs.

   

2. Stuur IPS-formaat van logs en autorisatiegegevens:

   • Ga naar iOS Instellingen → Analyse → Analysegegevens → OsmAnd Maps ips-formaat bestand (tot iOS 17).
   • iOS Instellingen → Privacy & Beveiliging → Analyse & Verbeteringen → Analysegegevens → OsmAnd Maps ips-formaat bestand (vanaf iOS 18).
   • Stuur vervolgens, met behulp van uw e-mailapp, de logs naar crash@osmand.net.

   

Tombstone-bestanden verzenden (Android)

Cruciaal

Alleen voor gevorderde gebruikers!

In bepaalde complexe of ongebruikelijke gevallen kunnen Tombstone-bestanden vereist zijn. Deze bestanden bieden gedetailleerde stack traces voor alle threads in een crashend proces (niet alleen degene die de fout heeft veroorzaakt), een complete geheugenkaart en een lijst van alle open bestandsdescriptors. Tombstone-bestanden zijn essentieel voor het debuggen en diagnosticeren van problemen met native code op het Android-platform.

Uw apparaat gebruiken

Om tombstone-bestanden te exporteren, moet u een bugrapport genereren met behulp van de Android-systeeminstellingen:

1. Schakel Ontwikkelaarsopties in (dit scherm is standaard verborgen).

   • Ga naar Instellingen → Over de telefoon → Software-informatie (dit pad is geldig voor Samsung-apparaten).
   • Tik zeven keer op Buildnummer totdat een pop-up bevestigt dat de ontwikkelaarsmodus actief is.

2. Ga naar Ontwikkelaarsopties, meestal onderaan de lijst met instellingen. U kunt ook de zoekfunctie gebruiken.

   • Tik op de optie Bugrapport maken.
   • Selecteer het type bugrapport en tik op Rapporteren.

Nadat het bugrapport klaar is, ontvangt u een melding. Tik op het meldingsvak om het rapport naar uw apparaat te downloaden. Pak het bestand uit en stuur de tombstone-bestanden naar het OsmAnd-ontwikkelaarsteam (e-mail: crash@osmand.net).

notitie

Houd er rekening mee dat bugrapporten privé-gegevens kunnen bevatten, inclusief app-gebruik of locatie.

ADB gebruiken

De Android Debugging Bridge (ADB) is een opdrachtregelprogramma waarmee ontwikkelaars hun applicaties kunnen debuggen. Om ADB te gebruiken voor het exporteren van tombstone-bestanden, moet u het eerst downloaden en installeren. Volg de instructies op de officiële Android-ontwikkelaarssite.

Uw apparaat voorbereiden

Zorg ervoor dat Ontwikkelaarsopties zijn ingeschakeld (dit scherm is standaard verborgen) en USB-foutopsporing is ingeschakeld:

• Navigeer naar Instellingen → Over de telefoon → Software-informatie.
• Tik zeven keer op Buildnummer totdat een pop-up bevestigt dat de ontwikkelaarsmodus actief is.
• Schakel in de Ontwikkelaarsopties USB-foutopsporing in.

Verbind vervolgens uw apparaat via USB met uw werkstation. Als het de eerste keer is dat u verbinding maakt, verschijnt er een pop-up met de vraag om toestemming voor foutopsporing.

Bugrapport genereren

1. Open een opdrachtregelterminal. Gebruik op Mac of Linux de Terminal-app en op Windows de Opdrachtprompt.
2. Navigeer naar de platform-tools-map waar ADB zich bevindt met behulp van de cd-opdracht (bijvoorbeeld 'cd /Users/Gebruikersnaam/Downloads/Tools').
3. Genereer het bugrapport:
   • Op Mac: adb bugreport
   • Op Windows: adb.exe bugreport
4. Wacht een paar minuten totdat het rapport is gegenereerd. Het resulterende bestand wordt opgeslagen in de platform-tools-map.
5. Pak het bestand uit.
6. Zoek de map tombstones met bestanden zoals tombstone_00, tombstone_01 en dergelijke.
7. Stuur de tombstone-bestanden naar crash@osmand.net.

Geroote apparaten of Android Studio Emulator gebruiken

• Met roottoegang tot uw apparaat kunt u de map /data/tombstones direct openen.

• Gebruik in Android Studio de emulator om naar Device File Explorer te navigeren en de map /data/tombstones te vinden. Binnenin vindt u bestanden met namen zoals tombstone_00, tombstone_01 en andere. Download deze bestanden en stuur ze naar crash@osmand.net.

Voor meer details over bugrapporten, raadpleeg de Android-documentatie.