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:
Docker web sitesindeki talimatları izleyerek Docker'ı yükleyin. Ücretsiz Kişisel abonelik de dahil tüm abonelik türleri çalışır.
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
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.
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.
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.Ç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.
Ş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:
Mobil cihazınızı bilgisayarınıza bağlayın.
Bir Terminal penceresinden aşağıdaki komutu çalıştırarak çalışan
adb
sunucunuzu kapatın:adb kill-server
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.
Ş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.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.
Yalnızca cihazın pilinden elektrik akışı sağlamak için cihazınızın bilgisayarla olan bağlantısını kesin.
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.
Telefonunuzu tekrar bağlayın.
Telefonunuzun tanındığından emin olup aşağıdaki komutu çalıştırın:
adb devices
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.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
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
.Göz at'ı tıklayın ve oluşturduğunuz hata raporu dosyasını seçin.
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](https://developer.android.com/static/topic/performance/images/batteryhistorian_chart_2x.png?authuser=5&hl=tr)
- Açılır listeden başka metrikler ekleyin.
- 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.
- 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ü](https://developer.android.com/static/topic/performance/images/batteryhistorian_additionalstats_2x.png?authuser=5&hl=tr)
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.