Een bugrapport bevat apparaatlogboeken, stack traces en andere diagnostische informatie om u te helpen bugs in uw app te vinden en te repareren. U kunt een bugrapport van uw apparaat vastleggen met de ontwikkelaarsoptie Neem bugrapport op het apparaat, het Android-emulatormenu of de opdracht adb bugreport
op uw ontwikkelmachine.
Figuur 1. Ontwikkelaarsopties
Om een bugrapport op te nemen, moet u Ontwikkelaarsopties hebben ingeschakeld op uw apparaat, zodat u de optie Bugrapport opnemen kunt openen.
Een bugrapport van een apparaat opnemen
Figuur 2. Het bugrapport is klaar
Om een bugrapport rechtstreeks van uw apparaat te halen, doet u het volgende:
- Zorg ervoor dat u DeveloperOptions hebt ingeschakeld.
- Tik in Developer-opties op Neem bugrapport op.
- Selecteer het type bugrapport dat u wilt en tik op Melden.
Na een moment krijgt u een melding dat het bugrapport klaar is (zie figuur 2).
- Om het bugrapport te delen, tikt u op de melding.
Een bug-rapport vastleggen vanuit de Android Emulator
Vanuit de Android Emulator kunt u de File a bug-functie gebruiken in de uitgebreide besturingselementen:
- Klik op More in hetemulator paneel.
-
In het venster met uitgebreide besturingselementen, selecteert u Bug report aan de linkerkant.
Dit opent een scherm waarin u de details van het bugrapport kunt zien, zoals de schermafbeelding, de AVD-configuratie-info, en het logboek van het bugrapport. U kunt ook een bericht met reproductie-stappen typen om met het rapport op te slaan.
-
Wacht tot het bugrapport klaar is met verzamelen en klik dan op Rapport opslaan.
Vang een bugrapport op met adb
Als u slechts één apparaat hebt aangesloten, kunt u als volgt een bugrapport ophalen metadb
:
$ adb bugreport E:\Reports\MyBugReports
Als u geen pad voor het bugrapport opgeeft, wordt het in de lokale map opgeslagen.
Als u meerdere apparaten hebt aangesloten, moet u het apparaat opgeven met de optie-s
. Voer de volgende adb
commando’s uit om het serienummer van het apparaat te achterhalen en het bugrapport te genereren.
$ adb devicesList of devices attachedemulator-5554 device8XV7N15C31003476 device$ adb -s 8XV7N15C31003476 bugreport
Inspecteer het bugrapport ZIP-bestand
Het ZIP-bestand heet standaardbugreport-BUILD_ID-DATE.zip
en het kan meerdere bestanden bevatten, maar het belangrijkste bestand isbugreport-BUILD_ID-DATE.txt
. Dit is het bug report en het bevat diagnostische output voor systeem services (dumpsys
), error logs (dumpstate
),en system message logs (logcat
). De systeemberichten bevatten stack traces wanneer het apparaat een fout gooit, en berichten geschreven door alle apps met deLog
klasse.
Het ZIP-bestand bevat een version.txt
metadata bestand dat de Android release letter bevat, en wanneer systrace is ingeschakeld, bevat het ZIP-bestand ook een systrace.txt
bestand. DeSystrace tool helpt bij het analyseren van de prestaties van uw applicatie door het vastleggen en weergeven van uitvoeringstijden van uw applicatie processen en andere Android systeem processen.
De dumpstate
tool kopieert bestanden van het bestandssysteem van het apparaat naar het ZIP-bestand onder de FS
map, zodat u ernaar kunt verwijzen. Bijvoorbeeld, een /dirA/dirB/fileC
bestand in het apparaat zou eenFS/dirA/dirB/fileC
item genereren in het ZIP-bestand.
Figuur 3. Voor meer informatie, zieBugrapporten lezen.
Ontvang rapporten van uw gebruikers
Het vastleggen van bugrapporten zoals hierboven beschreven is nuttig als u de app zelf gebruikt, maar uw eindgebruikers kunnen dit soort bugrapporten niet gemakkelijk met u delen. Om crashrapporten met stack traces van echte gebruikers te krijgen, moet u profiteren van de crashrapportagefuncties van Google Play en Firebase.
Google Play Console
U kunt rapporten ophalen uit de Google Play Console om gegevens te bekijken voor crashes en ANR-fouten (application notresponding) van gebruikers die uw app hebben geïnstalleerd via Google Play.Gegevens zijn beschikbaar voor de afgelopen zes maanden.
Voor meer informatie, zieBekijk crashes & toepassing reageert niet (ANR) fouten in Play Console help.
Firebase crash rapportage
Firebase Crashlytics rapportage creëert gedetailleerde rapporten van de fouten in uw app.Fouten worden gegroepeerd in problemen op basis van het hebben van soortgelijke stack traces, en triaged door de ernst van de impact op uw gebruikers. Naast automatische rapporten kunt u ook aangepaste gebeurtenissen loggen om de stappen die leiden tot een crash vast te leggen.
U kunt beginnen met het ontvangen van crashrapporten van elke gebruiker door eenvoudig deFirebase-afhankelijkheden toe te voegen aan uw build.gradle
-bestand. Voor meer informatie, zieFirebase Crashlytics.