1 数据准备

1.1 先断开adb服务，然后开启adb服务

（a）adb kill-server 

• 1

这一步很重要，因为当我们开发时做电量记录时会打开很多可能造成冲突的东西。为了保险起见我们重启adb。adb devices就会自动连接查找手机。

备注：mac可以直接使用adb命令；但是windows不行，需要进入到adt下：adt-bundle-windows-x86_64-20140702\adt-bundle-windows-x86_64-20140702\sdk\platform-tools 操作adb命令。

（b）adb start-server

• 1

重启adb。

1.2 重置电池数据收集数据

（c）adb shell dumpsys batterystats --enable full-wake-history（d）adb shell dumpsys batterystats --reset

• 1
• 2
• 3

我们通过以上命令来打开电池数据的获取以及重置，清除干扰的数据，执行的效果如下： 

1.3 获取电量报告

把数据线直接拔掉（防止数据线造成充放电数据干扰），现在做一些测试，手动或者跑一些自动化的case都行。经过一段时间后，我们重新连接手机确认adb连上了，运行下面这条命令来将bugreport的信息保存到txt文档中：

（e）adb bugreport > bugreport.txt

• 1

或者用下面的命令也可以，加上包名可以限制输出的数据是我们要检测的。：

（e.1）adb shell dumpsys batterystats > batterystats.txt（e.2）adb shell dumpsys batterystats > com.example.android.sunshine.app > batterystats.txt

• 1
• 2
• 3

注意： 
json: unsupported value: NaN 
有人用了描述：the problem started when reset the battery stats and enabled full-wake-history。 
解决：重启手机再试就好了。

1.4 使用battery-historian工具图形化报告

到此我们有两种方式分析这个文件：（historian-V1之前的版本 和historian-V2最新的版本），详细在第二、三章分析。

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

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

（f）python historian.py -a bugreport.txt > battery.html

• 1

2.2 环境配置

（1）python 未安装需要先安装python环境，并配置path，否则无法使用python命令。备注：mac可能不需要安装。

（2）historian.py脚本是Python写的，所以需要historian脚本，从github工具开源地址：上下载这个脚本。文件在github上面的scripts目录下面，需要下载到命令行所在的目录：

2.3 Google浏览器打开html文件

（1）注意：浏览器显示满屏的文字+英文，无法生成图形报告，或者打开生成的HTML显示错误如下，WARNING: Visualizer disabled. If you see this message, download the HTML then open it。

解决：需要使用vpn翻墙访问谷歌服务。

（2）上面两条命令执行成功后，会在目录下发现两个文件bugreport.txt和battery.html，这个时候我们用google浏览器打开html文件，可以看到如下信息：

2.4 Battery History报告各个参数的意义

重要的参数：WiFi、wake_lock、conn、mobile_ratio(蜂窝信号)

（1）横坐标 

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

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

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

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

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

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

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

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

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

（10）gps 
gps是否开启

（11）phone_in_call 
是否进行通话

（12）Sync 
是否跟后台同步. 
可以把鼠标停在某一项上面。可以看到何时sync同步 启动的，持续时间Duration多久。电池容量不会显示单一行为消耗的具体电量，这里只能显示使用电池的频率和时长，你可以看分时段的剩余电量来了解具体消耗了多少电量。 

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

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

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

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

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

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

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

备注：本方法由于翻墙等原因还没确定是否成功。

3.1 链接参考

（1）工具开源地址： https://github.com/google/battery-historian

（2）Install Docker安装路径：https://docs.docker.com/engine/installation/

（3）参考项目安装 Docker 
https://docs.docker.com/docker-for-windows/

http://wiki.jikexueyuan.com/project/docker/installation/mac.html

3.2 安装Docker环境来安装Battery History

（1）描述 
根据gitbub上面介绍，Battery History工具的安装有两种方式： 
A、通过安装Docker环境来安装。（这种方式很简单，Docker真心好用，太彪悍了！） 
B、安装GO环境、Git环境、Python、Java环境（不推荐）

（2）Docker环境 
Docker是一种容器，一般用于云计算和大数据平台。提倡的一种思想就是：软件即服务。这句话不是盖的，一句话就可以将别人发布的docker服务环境一次全部copy过来(注意是整个软件环境哦，相当于复制了一台一模一样的主机，连软件都不要安装了，全有了。彪悍吧！) 
Docker只支持Windows10（mac貌似也支持）

（3）Docker安装注意问题：翻墙

A、进部署好的服务器docker，显示错误如下： 
{“UploadResponse”:[{“sdkVersion”:23,”historianV2Cs… 
https://github.com/google/battery-historian/issues/64 
解决：You need a network connection.需要翻墙。 动脑的centos无法翻墙访问谷歌服务导致。

B、进部署好的动脑服务器docker，没有显示错误，但是最上面提示了红色的颜色块，表示访问出错。 
解决：无法翻墙访问谷歌服务导致。

（4）操作命令

Gitbub上面是这样的命令及地址：

docker -- run -p <port>:9999 gcr.io/android-battery-historian:2.1 --port 9999

• 1

这个里面的地址貌似不能用(可能是翻墙软件屏蔽了的原因)，然后找到了一个老外的镜像，是2.0版本的。（镜像地址：blystad/battery-historian或者bhaavan/battery-historian）

关键：

docker -- run -p 6666:9999 blystad/battery-historian --port 9999

• 1

或者命令如下(上面这种是临时开辟的程序服务，下面是开启了一个单独系统服务更正规的服务。)：

docker run -d –p 9999:9999 bhaavan/battery-historian

• 1
• 2

3.3 导出手机的Bugreport日志

输入指令 adb bugreport > bugreport.txt导出

3.4 上传bugreport.txt文件至 http://localhost:9999