Vikailmoitus sisältää laitteen lokitietoja, pinojälkiä ja muita diagnostiikkatietoja, jotka auttavat sinua löytämään ja korjaamaan sovelluksen virheet. Voit kaapata vikaraportin laitteesta käyttämällä joko laitteen Ota vikaraportti kehittäjävaihtoehtoa, Android-emulaattorin valikkoa tai adb bugreport-komentoa kehityskoneellasi.
Kuva 1. Kehittäjäasetukset
Virheraportin ottaminen edellyttää, että laitteessa on otettu käyttöön Kehittäjäasetukset, jotta voit käyttää Ota vikaraportti -vaihtoehtoa.
Virheraportin ottaminen laitteesta
Avio 2. Virheraportti on valmis
Tehdäksesi virheraportin suoraan laitteesta toimi seuraavasti:
- Varmista, että DeveloperOptions (Kehittäjäasetukset) on käytössäsi.
- Napauta Developer Options (Kehittäjäasetukset) -kohdassa Ota virheraportti.
- Valitse haluamasi vikailmoituksen tyyppi ja napauta Raportoi.
Hetken kuluttua saat ilmoituksen, että vikailmoitus on valmis (katso kuva 2).
- Jaa vikailmoitus napauttamalla ilmoitusta.
Vikailmoituksen tekeminen Android-emulaattorista
Android-emulaattorista voit käyttää laajennetuissa ohjaimissa olevaa Tiedosto vikailmoituksesta -ominaisuutta:
- Klikkaa Lisää
emulaattoripaneelissa. -
Vaihda laajennetut ohjaimet -ikkunassa vasemmalla olevasta valikosta vikailmoitus.
Tällöin avautuu näyttö, jossa näet vikailmoituksen yksityiskohdat, kuten kuvakaappauksen, AVD:n kokoonpanotiedot ja vikailmoituslokin. Voit myös kirjoittaa viestin toistovaiheineen, joka tallennetaan raportin mukana.
-
Odota, että vikaraportti on kerätty loppuun, ja valitse sitten Tallenna raportti.
Kerää vikaraportti käyttämällä adb
Jos vain yksi laite on liitetty, voit kerätä vikaraportin käyttämälläadb seuraavasti:
$ adb bugreport E:\Reports\MyBugReports
Jos et määritä vikaraportin polkua, se tallennetaan paikalliseen hakemistoon.
Jos useampi laite on liitetty, sinun on määriteltävä laite vaihtoehdolla-s. Suorita seuraavat adbkomennot saadaksesi laitteen sarjanumeron ja luodaksesi vikaraportin.
$ adb devicesList of devices attachedemulator-5554 device8XV7N15C31003476 device$ adb -s 8XV7N15C31003476 bugreport
Tarkista vikaraportin ZIP-tiedosto
Vakiossa ZIP-tiedoston nimi onbugreport-BUILD_ID-DATE.zip ja se voi sisältää useita tiedostoja, mutta tärkein tiedosto onbugreport-BUILD_ID-DATE.txt. Tämä on vikaraportti, ja se sisältää järjestelmän palveluiden diagnostiikkatulosteet (dumpsys), virhelokit (dumpstate) ja järjestelmäviestilokit (logcat). Järjestelmäviesteihin kuuluvat pinojäljet,kun laite heittää virheen, ja viestit, jotka on kirjoitettu kaikista sovelluksista, joilla on Log-luokka.
ZIP-tiedosto sisältää version.txt-metatietotiedoston, joka sisältääAndroidin julkaisukirjeen, ja kun systrace on käytössä, ZIP-tiedosto sisältää myös systrace.txt-tiedoston. Systrace-työkalu auttaa analysoimaan sovelluksen suorituskykyä kaappaamalla ja näyttämällä sovelluksen prosessien ja muiden Android-järjestelmän prosessien suoritusajat.
Työkalu dumpstate kopioi tiedostoja laitteen tiedostojärjestelmästä ZIP-tiedostoon FS-kansion alle, jotta voit viitata niihin. Esimerkiksi laitteessa oleva /dirA/dirB/fileC-tiedosto luoFS/dirA/dirB/fileC-merkinnän ZIP-tiedostoon.
Kuva 3. Virheraporttitiedoston rakenne
Lisätietoja on kohdassa Virheraporttien lukeminen.
Hae raportteja käyttäjiltäsi
Virheraporttien kerääminen edellä kuvatulla tavalla on hyödyllistä, kun käytät sovellusta itse, mutta loppukäyttäjät eivät voi helposti jakaa tämäntyyppisiä virheraportteja kanssasi. Saadaksesi kaatumaraportteja ja pinojälkiä todellisilta käyttäjiltä,kannattaa hyödyntää Google Playn ja Firebasen kaatumaraportointiominaisuuksia.
Google Play Console
Voit hakea raporttejaGoogle Play Consolesta nähdäksesi kaatumisia ja ANR-virheitä (application notresponding) koskevat tiedot käyttäjiltä, jotka ovat asentaneet sovelluksesi Google Playsta.Tietoja on saatavissa kuudelta edelliseltä kuukaudelta.
Lisätietoja on kohdassa Katsele kaatumisia & sovellus ei vastaa (ANR) -virheitä Play-konsolin ohjeessa.
Firebase-kaatumisraportointi
Firebase Crashlytics -raportointi luo yksityiskohtaisia raportteja sovelluksesi virheistä.Virheet ryhmitellään ongelmiin sen perusteella, että niillä on samankaltaisia pinojälkiä, ja ne lajitellaan käyttäjiin kohdistuvien vaikutusten vakavuuden mukaan. Automaattisten raporttien lisäksi voit kirjata mukautettuja tapahtumia, joiden avulla voit tallentaa kaatumiseen johtavat vaiheet.
Voit aloittaa kaatumisraporttien vastaanottamisen miltä tahansa käyttäjältä lisäämälläFirebase-riippuvuudet build.gradle-tiedostoosi. Lisätietoja on kohdassaFirebase Crashlytics.