Pil İstatistikleri ve Pil Geçmişi ile pil kullanımını profilleme

Bu dokümanda, Pil İstatistik Aracı ve Pil Geçmişi komut dosyası için temel kurulum adımları ve iş akışı gösterilmektedir. Pil tüketimi kalıplarını incelemek üzere Pil Geçmişi'ni nasıl kullanacağınızı öğrenmek için Pil Geçmişi ile güç kullanımını analiz etme bölümüne bakın.

Batterystats, cihazınızda pil verilerini toplayan Android çerçevesine dahil olan bir araçtır. Toplanan pil verilerini geliştirme makinenize aktarmak ve Pil Geçmişi Geçmişi özelliğini kullanarak analiz edebileceğiniz bir rapor oluşturmak için adb aracını kullanabilirsiniz. Pil Geçmişi raporu, Pil istatistiği raporunu tarayıcınızda görüntüleyebileceğiniz bir HTML görselleştirmesine dönüştürür.

Pil istatistikleri ve Pil Geçmişi şu durumlarda yararlıdır:

  • İşlemlerin pili nereden ve nasıl kullandığını gösterir.
  • Uygulamanızda, pil ömrünü uzatmak için ertelenebilecek veya kaldırılabilecek görevleri belirleme.

Pil Geçmişi Kurulumu

Pil Geçmişi'ni yüklemek için Docker'ı kullanabilirsiniz. Kaynaktan derleme gibi alternatif yükleme yöntemleri için projenin GitHub sayfasındaki BENİOKU bölümüne bakın. Docker kullanarak yüklemek için aşağıdakileri yapın:

  1. Docker web sitesindeki talimatları izleyerek Docker'ı yükleyin. Ücretsiz Kişisel abonelik de dahil tüm abonelik türleri çalışır.

  2. Docker'ın doğru şekilde yüklendiğini onaylamak için komut satırını açın ve aşağıdaki komutu girin:

    docker run hello-world
    

    Docker doğru şekilde yüklendiyse şunun gibi bir çıkış gösterir:

    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. Pil Geçmişi görüntüsünü çalıştırmadan önce Docker için GUI ön ucu olan Docker Masaüstü uygulamasını başlatın. Bunu çalıştırmak Docker araçlarını başlatır. Pil Geçmişi, bu işlemi en az bir kez yapana kadar çalışmaz.

  4. Pil Geçmişi'ni ilk kez çalıştırırken komut satırından çalıştırın. Docker Masaüstü uygulaması, web sunucusunun çalıştırılacağı bağlantı noktasını belirtmenize izin vermez. Bu işlemi yalnızca komut satırından yapabilirsiniz. Bununla birlikte, kapsayıcıyı komut satırından başarıyla çalıştırdıktan sonra Docker Masaüstü'nde bir giriş oluşturulur ve ardından Docker Masaüstü'ndeki aynı işleyici bağlantı noktasını kullanarak bu girişi başlatabilirsiniz.

  5. Aşağıdaki komutu kullanarak Pil Geçmişi görüntüsünü çalıştırın:

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

    Pil Geçmişi, port_number kullanılarak belirtildiği gibi istediğiniz bağlantı noktasını kullanır.

  6. Çalıştığını onaylamak için tarayıcınızda Pil Geçmişi'ne gidin. Adres, işletim sisteminize bağlı olarak değişiklik gösterir:

    Linux ve Mac için

    Pil Geçmişi'ni http://localhost:port_number bağlantısından inceleyebilirsiniz.

    Windows için

    Docker'ı başlattıktan sonra size kullandığı makinenin IP adresini söyler. Örneğin, IP adresi 123.456.78.90 ise Pil Geçmişi http://123.456.78.90:port_number adresinde kullanılabilir.

    Daha sonra, pil istatistiklerini yükleyip görüntüleyebileceğiniz Pil Geçmişi başlangıç sayfası görüntülenir.

    Pil Geçmişi için başlangıç sayfası
    Şekil 1. Pil Geçmişi için başlangıç sayfasıdır.

Batterystats ile veri toplama

Pil İstatistikleri'ni kullanarak cihazınızdan veri toplamak ve bu verileri Pil Geçmişi'nde açmak için aşağıdakileri yapın:

  1. Mobil cihazınızı bilgisayarınıza bağlayın.

  2. Bir Terminal penceresinden aşağıdaki komutu çalıştırarak çalışan adb sunucunuzu kapatın:

    adb kill-server
    
  3. adb uygulamasını yeniden başlatın ve aşağıdaki komutu çalıştırarak bağlı cihazları kontrol edin.

    adb devices
    

    Bu örnekte, aşağıdaki örnek çıkışa benzer şekilde cihazınız listelenir.

    Adb cihazlarının çıktısı
    Şekil 2. Bir bağlı cihazı gösteren adb devices çıkışı

    Herhangi bir cihaz listelenmiyorsa telefonunuzun bağlı olduğundan ve USB hata ayıklama'nın etkin olduğundan emin olun, ardından adb uygulamasını durdurup yeniden başlatın.

  4. Aşağıdaki komutu çalıştırarak pil verisi toplamayı sıfırlayın:

    adb shell dumpsys batterystats --reset
    

    Cihaz arka planda her zaman Pil istatistiği ve diğer hata ayıklama bilgilerini toplar. Sıfırlama işlemi, önceki pil toplama verilerini siler. Sıfırlamazsanız çıkış çok büyük olabilir.

  5. Yalnızca cihazın pilinden elektrik akışı sağlamak için cihazınızın bilgisayarla olan bağlantısını kesin.

  6. Uygulamanızı kullanın ve verilerini toplamak istediğiniz işlemleri gerçekleştirin. Örneğin, kablosuz bağlantıyı kesin ve verileri buluta gönderin.

  7. Telefonunuzu tekrar bağlayın.

  8. Telefonunuzun tanındığından emin olup aşağıdaki komutu çalıştırın:

    adb devices
    
  9. Aşağıdaki komutu çalıştırarak tüm pil verilerinin dökümünü alın. Bu işlem biraz zaman alabilir.

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

    batterystats.txt dosyası, isteğe bağlı path bağımsız değişkenini kullanarak belirttiğiniz dizinde oluşturulur. Yol belirtmezseniz dosya ana dizininizde oluşturulur.

  10. Ham verilerden rapor oluşturun.

    Android 7.0 ve sonraki sürümleri çalıştıran cihazlar için:

    adb bugreport [path/]bugreport.zip

    Android 6.0 ve önceki sürümleri çalıştıran cihazlar için:

    adb bugreport [path/]bugreport.txt

    Hata raporunun tamamlanması birkaç dakika sürebilir. İşlem tamamlanana kadar cihazınızın bağlantısını kesmeyin veya işlemi iptal etmeyin.

    batterystats.txt ürününde olduğu gibi, bu dosyalar isteğe bağlı path bağımsız değişkenini kullanarak belirttiğiniz dizinde oluşturulur. Bir yol belirtmezseniz bu yollar ana dizininizde oluşturulur.

    Pil Geçmişi halihazırda çalışmıyorsa aşağıdaki komutu kullanarak Pil Geçmişi'ni çalıştırın:

    docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
    
  11. Pil Geçmişi'ndeki verilerinizi görüntülemek için tarayıcınızda Pil Geçmişi'ni açın. Mac ve Linux'ta Pil Geçmişi şu hızda çalışır: http://localhost:port_number. Windows'da Pil Geçmişi şu şekilde çalışır: http://your_IP_address:port_number.

  12. Göz at'ı tıklayın ve oluşturduğunuz hata raporu dosyasını seçin.

  13. Gönder'i tıklayın. Pil Geçmişi, Pil istatistiği verilerinizden oluşturulmuş bir grafik açar.

Pil Geçmişi grafikleriyle verileri görüntüleme

Pil Geçmişi grafiği, zaman içinde güçle ilgili olayların grafiğini çizer.

Bir sistem bileşeni etkin olduğunda ve böylece pilden akım çektiğinde her satırda renkli bir çubuk segmenti gösterilir. Grafikte bileşenin ne kadar pil kullandığı gösterilir. Yalnızca uygulamanın etkin olup olmadığı gösterilir. Grafikler kategoriye göre düzenlenir ve grafiğin x ekseninde gösterildiği gibi, zaman içinde her kategori için bir çubuk gösterilir.

Pil Geçmişi grafiği örneği
Şekil 3. Pil Geçmişi grafiği örneği.
  1. Açılır listeden başka metrikler ekleyin.
  2. Grafikte kullanılan renklerle ilgili bir anahtar da dahil olmak üzere her metrik hakkında daha fazla bilgi görmek için işaretçiyi metrik adının üzerinde tutun.
  3. Bir metrik hakkında daha ayrıntılı bilgi ve zaman çizelgesinde belirli bir noktadaki pil istatistikleri için işaretçiyi çubuğun üzerinde tutun.

Ek Pil İstatistikleri çıkışı

batterystats.txt dosyasındaki ek bilgileri Pil Geçmişi grafiğinden sonra istatistikler bölümünde görüntüleyebilirsiniz.

Pil Geçmişi'nin istatistikler bölümü
Şekil 4. Pil Geçmişi'nin istatistikler bölümü.

1 Sistem İstatistikleri sekmesi, hücre sinyal düzeyleri ve ekran parlaklığı gibi sistem genelindeki istatistikleri içerir. Bu bilgiler cihazda neler olup bittiğine dair genel bir resim sunar. Bu, özellikle harici etkinliklerin testinizi etkilemediğinden emin olmak için yararlıdır.

2 Uygulama İstatistikleri sekmesi belirli uygulamalarla ilgili bilgiler içerir. Uygulama Seçimi bölmesindeki 3 Uygulamaları sıralama ölçütü açılır listesini kullanarak uygulama listesini sıralayın. İstatistikleri görüntülemek istediğiniz uygulamayı seçmek için 4 uygulama açılır listesini kullanabilirsiniz.