Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Membuat profil penggunaan baterai dengan Batterystats dan Battery Historian

Panduan ini menunjukkan langkah-langkah penyiapan dasar dan alur kerja untuk alat Batterystats dan skrip Battery Historian. Untuk mempelajari cara menggunakan Battery Historian untuk memeriksa pola penggunaan baterai, baca Menganalisis penggunaan daya dengan Battery Historian.

Batterystats adalah alat yang disertakan dalam framework Android yang mengumpulkan data baterai di perangkat. Anda dapat menggunakan adb untuk menghapus data baterai yang dikumpulkan ke mesin pengembangan dan membuat laporan yang dapat dianalisis menggunakan Battery Historian. Battery Historian mengonversi laporan dari Batterystats menjadi visualisasi dalam bentuk HTML yang dapat Anda lihat di browser.

Efektif untuk:

  • Menunjukkan di mana dan bagaimana proses menggunakan daya dari baterai.
  • Mengidentifikasi tugas di aplikasi Anda yang dapat ditangguhkan atau bahkan dihapus untuk meningkatkan masa pakai baterai.

Menginstal Battery Historian

Cara termudah untuk menginstal Battery Historian adalah dengan menggunakan Docker. Untuk metode penginstalan alternatif, termasuk mem-build dari sumber, lihat Read Me pada halaman GitHub project. Untuk menginstal menggunakan Docker, lakukan hal berikut:

  1. Instal Docker Community Edition dengan mengikuti petunjuk di situs Docker.

  2. Untuk mengonfirmasi Docker telah terinstal dengan benar, buka command line dan masukkan perintah berikut:

    docker run hello-world
        

    Jika Docker sudah terinstal dengan benar, Anda akan melihat output seperti ini:

    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. Jalankan image Battery Historian menggunakan perintah berikut:

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

    Battery Historian akan menggunakan port yang Anda pilih, seperti yang ditentukan menggunakan port_number.

  4. Buka Battery Historian di browser Anda untuk memastikannya berjalan. Alamat dapat bervariasi tergantung sistem operasi Anda:

    Untuk Linux dan Mac

    Battery Historian tersedia di http://localhost:port_number.

    Untuk Windows

    Docker akan memberi tahu alamat IP dari mesin yang digunakannya segera setelah aplikasi tersebut Anda mulai. Jadi, misalnya, jika alamat IP adalah 123.456.78.90, Battery Historian tersedia di http://123.456.78.90:port_number
    Anda akan melihat halaman awal baterai Historian, tempat Anda dapat mengupload dan melihat statistik baterai.

    Halaman awal Battery Historian
    Gambar 1. Halaman awal Battery Historian

Mengumpulkan data dengan Batterystats

Untuk mengumpulkan data dari perangkat menggunakan Batterystats dan membukanya di Battery Historian, lakukan hal berikut:

  1. Sambungkan perangkat seluler ke komputer.

  2. Dari jendela Terminal, nonaktifkan server adb yang sedang berjalan.

    adb kill-server
        
  3. Mulai ulang adb dan periksa perangkat yang terhubung.

    adb devices
        

    Anda akan melihat perangkat tercantum, persis dengan contoh output di bawah.

    Output perangkat adb
    Gambar 2. Output adb devices, menunjukkan satu perangkat yang terhubung

    Jika tidak melihat perangkat apa pun, pastikan ponsel terhubung, dan Proses Debug USB dalam status aktif, lalu nonaktifkan dan mulai ulang adb.

  4. Reset pengumpulan data baterai.

    adb shell dumpsys batterystats --reset
        

    Perangkat selalu mengumpulkan batterystats dan informasi proses debug lainnya di latar belakang. Reset akan menghapus data pengumpulan baterai yang lama. Jika tidak melakukan reset, outputnya akan sangat besar.

  5. Putuskan sambungan perangkat dari komputer sehingga Anda hanya menggunakan daya dari baterai perangkat.

  6. Gunakan beberapa aplikasi dan lakukan tindakan yang Anda inginkan datanya; misalnya, memutuskan sambungan dari Wi-Fi dan mengirim data ke cloud.

  7. Sambungkan kembali ponsel Anda.

  8. Pastikan ponsel dikenali:

    adb devices
        
  9. Hapus semua data baterai. Proses ini mungkin memerlukan waktu beberapa saat:

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

    File batterystats.txt dibuat di direktori yang Anda tentukan menggunakan argumen jalur opsional. Jika tidak menentukan jalur, file tersebut akan dibuat di direktori beranda.

  10. Buat laporan dari data mentah.

    Untuk perangkat yang menjalankan Android 7.0 dan yang lebih baru:

    adb bugreport > [path/]bugreport.zip

    Untuk perangkat yang menjalankan Android 6.0 dan yang lebih lama:

    adb bugreport > [path/]bugreport.txt

    Laporan bug mungkin perlu waktu beberapa menit untuk menyelesaikan proses. Jangan memutuskan sambungan perangkat Anda atau membatalkan prosesnya sampai selesai.

    Seperti halnya batterystats.txt di atas, file-file ini dibuat di direktori yang Anda tentukan menggunakan argumen path opsional. Jika tidak menentukan jalur, file tersebut dibuat di direktori beranda.

    Jika belum berjalan, jalankan Battery Historian menggunakan perintah berikut:

        docker --run -p port_number:9999 gcr.io/android-battery-historian:2.1 --port 9999
        
  11. Untuk melihat data Anda di Battery Historian, buka Battery Historian di browser. (Untuk Mac dan Linux, Battery Historian berjalan di http://localhost:port_number. Untuk Windows, Battery Historian berjalan di http://your_IP_address:port_number.)

  12. Klik Browse lalu pilih file laporan bug yang Anda buat di atas.

  13. Klik Submit. Battery Historian akan membuka diagram yang dibuat dari data batterystats Anda.

Melihat data dengan diagram Battery Historian

Diagram Battery Historian menampilkan peristiwa yang terkait dengan daya dari waktu ke waktu.

Setiap baris menampilkan segmen batang berwarna ketika komponen sistem aktif dan menggunakan daya dari baterai. Diagram tidak menunjukkan jumlah daya baterai yang digunakan oleh komponen tersebut, dan hanya menunjukkan bahwa aplikasi tersebut aktif. Diagram disusun berdasarkan kategori, menampilkan batang untuk setiap kategori dari waktu ke waktu, seperti yang ditampilkan pada sumbu X diagram.

Contoh diagram Battery Historian
Gambar 3. Contoh diagram Battery Historian

  1. Menambahkan metrik tambahan dari menu drop-down.
  2. Arahkan kursor ke ikon informasi untuk melihat informasi selengkapnya tentang setiap metrik, termasuk kunci untuk warna yang digunakan pada diagram.
  3. Arahkan kursor ke batang untuk melihat informasi yang lebih detail tentang metrik tersebut dan statistik baterainya pada titik tertentu di linimasa.

Output batterystats tambahan

Anda dapat melihat informasi tambahan dari file batterystats.txt di bagian statistik di bawah diagram Battery Historian.

Bagian statistik Battery Historian
Gambar 4. Bagian statistik Battery Historian

Tab 1 System Stats mencakup statistik seluruh sistem, seperti tingkat sinyal seluler dan kecerahan layar. Informasi ini memberikan gambaran keseluruhan tentang apa yang terjadi pada perangkat. Informasi tersebut sangat berguna untuk memastikan tidak ada peristiwa eksternal yang memengaruhi pengujian Anda.

Tab 2 App Stats mencakup informasi tentang aplikasi tertentu. Urutkan daftar aplikasi menggunakan menu drop-down 3 Sort apps by di panel App Selection di sebelah kiri. Anda dapat memilih aplikasi tertentu untuk melihat statistik penggunaan daftar drop-down 4 aplikasi di bawah.