功耗分析工具battery-historian

battery-historian工具使用（安卓耗电分析）

battery-historian使用

电量消耗优化代码资源：https://download.csdn.net/download/wdx_1136346879/10918775

数据准备
battery-historian工具需要使用bugreport中的Battery History

1. 先断开adb服务，然后开启adb服务
   adb kill-server 这一步很重要，因为当我们开发时做电量记录时会打开很多可能造成冲突的东西。为了保险起见我们重启adb。

adb devices就会自动连接查找手机。当然也可以adb start-server

2. 重置电池数据收集数据，我们在开始的时候需要通过以下命令来打开电池数据的获取以及重置：

adb shell dumpsys batterystats --enable full-wake-history
adb shell dumpsys batterystats --reset

执行的效果如下：

上面的操作相当于初始化操作，如果不这么做会有一大堆的干扰的数据，看起来会比较痛苦。然后把数据线直接拔掉(防止数据线造成充放电数据干扰)，现在做一些测试，手动或者跑一些自动化的case都行。经过一段时间后，我们重新连接手机确认adb连上了，运行下面这条命令来将bugreport的信息保存到txt文档中，

adb bugreport > bugreport.txt

或者用下面的命令也可以：

adb shell dumpsys batterystats > batterystats.txt
adb shell dumpsys batterystats > com.example.android.sunshine.app > batterystats.txt

加上包名可以限制输出的数据是我们要检测的。

但是这个txt的数据可读性不强。接下来我们就要用到这个battery-historian工具了。

到此我们有两种方式分析这个文件：（historian-V1之前的版本 和historian-V2最新的版本）

historian-V1之前的版本分析方式:

将txt文档转化为html文件，命令如下。

python historian.py -a bugreport.txt > battery.html

上面的historian.py脚本是Python写的，所以需要python环境，然后从github上下载这个脚本。文件在github上面的scripts目录下面，需要下载到命令行所在的目录

上面两条命令执行成功后，会在目录下发现两个文件

bugreport.txt和battery.html，这个时候我们用google浏览器打开html文件，可以看到如下信息：

各个参数的意义
首先我们在bugreport.txt找到Battery History数据栏类似下面的信息：

DUMP OF SERVICE batterystats:

Battery History (2% used, 5980 used of 256KB, 45 strings using 2592):

                0 (9) RESET:TIME: 2015-03-05-15-21-56

                0 (2) 100 c0900422 status=discharging health=good plug=none temp=200 volt=4167 +running +wake_lock +sensor +screen data_conn=edge phone_signal_strength=great brightness=medium proc=u0a15:"android.process.acore"

                0 (2) 100 c0900422 proc=u0a7:"com.android.cellbroadcastreceiver"

                0 (2) 100 c0900422 proc=u0a53:"com.android.gallery3d"

你在html中信息都能从bugreport.txt中找到相应的信息。

现在来分析各个指标代表的意义：

横坐标

上面的10，20代表的就是秒的意思，它是以一分钟为周期，到第60秒的时候变为0。横坐标就是一个时间范围，咱们的例子中统计的数据是以重置为起点，获取bugreport内容时刻为终点。我们一共采集了多长时间的数据，图表下也有信息说明。（经其他人的反馈，这个坐标间隔是会随着时间的长度发生改变，所以要以你的实际情况为准。这个缩放级别可以调整的，如下图：）

纵坐标

纵坐标的数据就很麻烦了，数据量太多，一条一条来吧。

• battery_level

电量，可以看出电量的变化。比如上图中的数据显示刚开始电量是100%，然后在第11秒-12秒中间的某个时刻降到了99%。

• plugged

充电状态，这一栏显示是否进行了充电，以及充电的时间范围。例如上图反映了我们在第22s插入了数据线，然后一直持续了数据采集结束。

• screen

屏幕是否点亮，这一点可以考虑到睡眠状态和点亮状态下电量的使用信息。

• top

该栏显示当前时刻哪个app处于最上层，就是当前手机运行的app，用来判断某个app对手机电量的影响，这样也能判断出该app的耗电量信息。该栏记录了应用在某一个时刻启动，以及运行的时间，这对我们比对不同应用对性能的影响有很大的帮助。

• wake_lock*

wake_lock 该属性是记录wake_lock模块的工作时间。是否有停止的时候等

• running

界面的状态，主要判断是否处于idle的状态。用来判断无操作状态下电量的消耗。

• wake_lock_in

wake_lock有不同的组件，这个地方记录在某一个时刻，有哪些部件开始工作，以及工作的时间。

• gps

gps是否开启

• phone_in_call

是否进行通话

• Sync

是否跟后台同步.

可以把鼠标停在某一项上面。可以看到何时sync同步 启动的，持续时间Duration多久。

电池容量不会显示单一行为消耗的具体电量，这里只能显示使用电池的频率和时长，你可以看分时段的剩余电量来了解具体消耗了多少电量。

• Job

后台的工作，比如服务service的运行。从下面图中可以看到qihoo的AppStore和鲁大师都在运行后台服务。

• data_conn

数据连接方式的改变，上面的edge是说明采用的gprs的方式连接网络的。此数据可以看出手机是使用2g，3g，4g还是wifi进行数据交换的。这一栏可以看出不同的连接方式对电量使用的影响。
status

电池状态信息，有充电，放电，未充电，已充满，未知等不同状态。
这一栏记录了电池状态的改变信息。

• phone_signal_strength

手机信号状态的改变。
这一栏记录手机信号的强弱变化图，依次来判断手机信号对电量的影响。

• health

电池健康状态的信息，这个信息一定程度上反映了这块电池使用了多长时间。
这一栏记录电池状态在何时发生改变，上面的图中电池状态一直处于good状态。

• plug

充电方式，usb或者插座，以及显示连接的时间。
这一栏显示了不同的充电方式对电量使用的影响。

historian-V2最新的版本的方式：

将生成bugreport.txt文件在 http://localhost:9999 中上传文件生成报告（前提在本地或者某服务器上搭好了battery-historian项目环境）

其实在这里也可以看到两种版本分析模式：