Profil der Akkunutzung mit BatteryStats und Akkuhistorian

In diesem Dokument werden die grundlegenden Einrichtungsschritte und der Workflow für das Tool Batterystats beschrieben. und das Skript für Battery Historian. Hier erfahren Sie, wie Sie mit dem Untersuchen Sie die Akkuverbrauchsmuster siehe Stromverbrauch mit Akku analysieren. Historiker.

Batterystats ist ein im Android-Framework enthaltenes Tool, das Daten auf deinem Gerät. Mit adb können Sie den gesammelte Akkudaten an Ihr Entwicklungssystem senden und einen Bericht erstellen, mit dem Battery Historian. Battery Historian konvertiert den Bericht von Batterystats in eine HTML-Visualisierung um, die Sie in Ihrem Browser anzeigen können.

Batterystats und Battery Historian sind in folgenden Fällen nützlich:

  • Zeigt an, wo und wie Prozesse Strom aus dem Akku beziehen.
  • Aufgaben in Ihrer App identifizieren, die zur Verbesserung verschoben oder entfernt werden können Akkulaufzeit.

Battery Historian installieren

Sie können Battery Historian mit Docker installieren. Für eine alternative Installation einschließlich der Erstellung aus der Quelle, finden Sie README im auf der GitHub-Seite des Projekts. So installieren Sie Docker mithilfe von Docker:

  1. Installieren Sie Docker, indem Sie der Anleitung auf der Docker-Website Beliebig subscription funktioniert, einschließlich eines kostenlosen persönlichen Abonnements.

  2. Um zu prüfen, ob Docker korrekt installiert ist, öffnen Sie die Befehlszeile und geben Sie den folgenden Befehl ein:

    docker run hello-world
    

    Wenn Docker korrekt installiert ist, wird eine Ausgabe wie die folgende angezeigt:

    Unable to find image 'hello-world:latest' locally
    latest: Pulling from library/hello-world
    78445dd45222: Pull complete
    Digest:
    sha256:c5515758d4c5e1e838e9cd307f6c6a0d620b5e07e6f927b07d05f6d12a1ac8d7
    Status: Downloaded newer image for hello-world:latest
    
    Hello from Docker!
    This message shows that your installation appears to be working correctly.
    
    To generate this message, Docker took the following steps:
    1. The Docker client contacted the Docker daemon.
    2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
    4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal
    
  3. Starten Sie die Docker Desktop-App, die ein GUI-Front-End für Docker ist, bevor führen Sie das Battery Historian-Image aus. Dadurch wird der Docker initialisiert Werkzeuge. Der Akkuverlauf wird erst gestartet, wenn Sie dies mindestens einmal getan haben.

  4. Wenn Sie Battery Historian zum ersten Mal über die Befehlszeile ausführen, . Sie können in der Docker Desktop-App keinen Port zum Ausführen des Webs angeben Server aktiviert ist. Dies ist nur über die Befehlszeile möglich. Nachdem Sie um den Container erfolgreich über die Befehlszeile auszuführen, wird im Wenn Sie Docker Desktop aufrufen, können Sie es über denselben Listener-Port starten, über Docker Desktop.

  5. Führen Sie das Battery Historian-Image mit dem folgenden Befehl aus:

    docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
    

    Battery Historian verwendet den Port Ihrer Wahl, wie anhand der port_number

  6. Gehe in deinem Browser zu Battery Historian, um zu prüfen, ob er ausgeführt wird. Die Adresse variiert je nach Betriebssystem:

    Für Linux und Mac

    Der Akkuverlauf für
    ist verfügbar unter http://localhost:port_number

    Für Windows

    Nachdem Sie Docker gestartet haben, wird Ihnen die IP-Adresse der Maschine mitgeteilt, verwendet. Lautet die IP-Adresse beispielsweise 123.456.78.90, ist Historiker http://123.456.78.90:port_number

    Anschließend wird die Startseite von Battery Historian angezeigt, auf der Sie Akkustatistiken anzeigen.

    <ph type="x-smartling-placeholder">
    </ph> Die Startseite für Battery Historian
    Abbildung 1: Die Startseite für den Akku Historiker.

Daten mit Batterystats erfassen

So kannst du mithilfe von BatteryStats Daten von deinem Gerät erfassen und im Akku öffnen Historiker:

  1. Schließen Sie Ihr Mobilgerät an den Computer an.

  2. Fahren Sie in einem Terminalfenster den laufenden adb-Server herunter, indem Sie den folgenden Befehl:

    adb kill-server
    
  3. Starten Sie adb neu und prüfen Sie, ob verbundene Geräte vorhanden sind, indem Sie Folgendes ausführen: .

    adb devices
    

    Hier wird Ihr Gerät aufgelistet, ähnlich wie in der folgenden Beispielausgabe.

    <ph type="x-smartling-placeholder">
    </ph> Ausgabe von ADB-Geräten
    Abbildung 2: Die Ausgabe von adb devices Ein verbundenes Gerät wird angezeigt

    Wenn keine Geräte aufgeführt werden, vergewissern Sie sich, dass Ihr Telefon angeschlossen ist und USB- Debugging aktiviert ist, und dann Beenden Sie adb und starten Sie es neu.

  4. Setzen Sie die Akkudatensammlung zurück, indem Sie den folgenden Befehl ausführen:

    adb shell dumpsys batterystats --reset
    

    Das Gerät erhebt immer Batterystats und andere Debugging-Informationen im Hintergrund. Durch das Zurücksetzen werden die vorherigen Daten zur Akkuerfassung gelöscht. Wenn Sie nicht zurücksetzen, kann die Ausgabe sehr groß sein.

  5. Trennen Sie Ihr Gerät vom Computer, damit Sie nur des Akkus des Geräts.

  6. Verwenden Sie Ihre App und führen Sie Aktionen aus, für die Sie Daten erheben möchten. Für zum Beispiel die WLAN-Verbindung trennen und Daten in die Cloud senden.

  7. Verbinden Sie Ihr Smartphone wieder.

  8. Vergewissere dich, dass dein Smartphone erkannt wird, und führe den folgenden Befehl aus:

    adb devices
    
  9. Leeren Sie alle Akkudaten mit dem folgenden Befehl. Dies kann bis zu .

    adb shell dumpsys batterystats > [path/]batterystats.txt
    

    Die Datei batterystats.txt wird in dem Verzeichnis erstellt, das Sie mit das optionale Pfadargument. Wenn Sie keinen Pfad angeben, wird die Datei die in Ihrem Basisverzeichnis erstellt wurden.

  10. Erstellen Sie einen Bericht aus Rohdaten.

    Geräte mit Android 7.0 und höher:

    adb bugreport [path/]bugreport.zip

    Geräte mit Android 6.0 und niedriger:

    adb bugreport [path/]bugreport.txt

    Die Erstellung des Fehlerberichts kann einige Minuten dauern. Trenne nicht die Verbindung zu deinem Gerät an oder brechen Sie den Vorgang ab, bis er abgeschlossen ist.

    Wie bei batterystats.txt werden diese Dateien in dem Verzeichnis erstellt, mit dem optionalen Argument path angeben. Wenn Sie keinen Pfad angeben, werden sie in Ihrem Basisverzeichnis erstellt.

    Wenn er noch nicht ausgeführt wird, starten Sie den Battery Historian mithilfe der folgenden Schritte: Befehl:

    docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
    
  11. Wenn Sie Ihre Daten im Battery Historian sehen möchten, öffnen Sie den Battery Historian in der Browser. Für Mac und Linux läuft Battery Historian unter http://localhost:port_number Für Windows, Akku Historikerin http://your_IP_address:port_number

  12. Klicken Sie auf Durchsuchen und wählen Sie die von Ihnen erstellte Fehlerberichtsdatei aus.

  13. Klicken Sie auf Senden. Der Akkuverlauf öffnet ein Diagramm, BatteryStats-Daten

Daten in Akkuverlaufsdiagrammen ansehen

Im Battery Historian-Diagramm werden die für die Stromversorgung relevanten Ereignisse im Zeitverlauf grafisch dargestellt.

Jede Zeile zeigt ein farbiges Balkensegment, wenn eine Systemkomponente aktiv ist und somit Strom von der Batterie beziehen. Im Diagramm wird nicht angezeigt, wie viel Akkukapazität von der Komponente verwendet wird – nur, ob die App aktiv ist Diagramme sind nach Kategorie, also eine Leiste für jede Kategorie im Zeitverlauf, wie auf der x-Achse des Diagramms an.

<ph type="x-smartling-placeholder">
</ph> Beispiel für ein Diagramm zum Akkuverlauf
Abbildung 3: Beispiel eines Battery Historikers Diagramm.
  1. Fügen Sie weitere Messwerte aus der Drop-down-Liste hinzu.
  2. Bewegen Sie den Mauszeiger auf den Namen des Messwerts, um weitere Informationen jeden Messwert, einschließlich eines Schlüssels für die im Diagramm verwendeten Farben.
  3. Halte den Mauszeiger über einen Balken, um weitere Informationen dazu zu sehen und die Akkustatistiken an einem bestimmten Punkt auf der Zeitachse.

Zusätzliche BatteryStats-Ausgabe

Weitere Informationen aus der Datei batterystats.txt finden Sie in der nach dem „Akkuverlauf“-Diagramm ein.

<ph type="x-smartling-placeholder">
</ph> Der Bereich „Statistiken“ von Battery Historian
Abbildung 4: Der Bereich „Statistiken“ unter „Akku“ Historiker.

Der Tab 1 Systemstatistiken enthält systemweite wie die Signalstärke des Mobilfunkanbieters und die Bildschirmhelligkeit. Diese Informationen Sie erhalten einen Gesamteindruck davon, was auf dem Gerät passiert. Dies ist Dies ist besonders nützlich, um sicherzustellen, dass keine externen Ereignisse den Test beeinträchtigen.

Der Tab 2 App-Statistiken enthält Informationen zu für bestimmte Apps. Sortieren Sie die Liste der Apps mithilfe der 3 Drop-down-Liste Apps sortieren nach im Bereich App-Auswahl. Ich eine bestimmte App auswählen, um Statistiken zur Verwendung der 4 Apps aus der Drop-down-Liste.