Battery-Historian工具使用

Battery-Historian⼯具使⽤
Battery-Historian⼯具使⽤
在Android官⽹上有这⼀个⼯具的使⽤⽅法，具体可以查看该官⽹。

开始
在开始使⽤这个软件之前，可能需要进⾏ Docker 这个容器软件的下载与安装。

下载 Docker 这个软件，可以在官⽹上找到详细的说明，此处使⽤⽐较简单的⽅法。

笔者系统为Mac OS 12.0.1，Intel芯⽚。

因为苹果系统的电脑分为Intel和苹果⾃研芯⽚两个系列，需要寻找对应的安装包。

否则可能安装不上。

安装Docker
点击下载，下载完成后，拖拽安装
安装完成后，打开docker，此时会在上⽅的任务栏中出现docker的图标，此时安装完成。

进⼊docker进⾏配置。

如果需要可以进⾏国内源的添加（该步骤是⾮必要的），点击上⽅任务栏的图标，选择perferences，选择docker engine，在右边的json配置中添加如下内容即可。

"registry-mirrors": [
"https://",
"https://",
"https://",
"https://"
]
添加的位置如下图所⽰，当添加完成后，点击下⽅的apply & restart，此时需要进⾏等待docker进⾏重启。

此时添加源完成。

在终端中间进⾏输⼊
docker run hello-world
以查询docker是否安装成功，如果成功，会在终端中输出如下的内容。

此时，恭喜你，安装docker成功。

安装Battery Historian
因为Battery Historian需要跑在Docker上，因此在安装Battery Historian前安装Docker是必不可少的。

此处默认安装完成Docker。

打开终端，输⼊
docker search battery
进⾏查找 Battery Historian 软件，此时终端中会显⽰多个 Battery Historian 软件，此时需要选择⼀个软件进⾏安装。

⼀般情况下，选择 runcare/battery-historian 即可，因为从该描述看，该软件是基于gcr.io的，与Android官⽅⽂档中所表⽰的⽐较接近。

在终端始终命令，输⼊
docker pull runcare/battery-historian
进⾏拉去镜像，从⽽在docker中进⾏安装。

当安装完成后，打开终端，输⼊命令
docker run --name=battery -d -p your-port :9999 runcare/battery-historian
your-port可以更改为⾃⼰喜欢的端⼝号
runcare/battery-historian更改为⾃⼰的安装的源。

安装完成后，就可以正常的使⽤了。

获取⼿机测试报告
平台搭建好了，那么可以开始进⾏⼿机的测试记录了。

打开shell，usb连接⼿机，然后开启⼿机的usb调试模式。

使⽤adb命令，进⾏查询是否电脑已经连接到⼿机设备。

输⼊命令：
adb devices
进⾏查询所连接的设备。

如果需要接⼊某⼀个特定的设备，需要使⽤adb进⾏制定特定的设备。

使⽤如下命令进⾏电池数据收集重置。

adb shell dumpsys batterystats --reset
如果⼀旦重置了电池的状态，那么请尽快拔掉电源，以确保准确性。

重置操作会清除旧的电池收集数据。

如果不重置，输出内容会⾮常⼤。

此时，可以使⽤⼿机进⾏对应的软件操作。

如果需要统计所有的唤醒锁的信息，需要进⾏设置，在终端输⼊
adb shell dumpsys batterystats --enable full-wake-history
统计完成之后，需要关闭这个功能
adb shell dumpsys batterystats --disable full-wake-history
直到所有的测试完成，或者您认为测试应该完成了。

使⽤数据线接上⼿机，打开终端。

输⼊如下的指令进⾏电池数据的存储。

adb shell dumpsys batterystats > [path/]batterystats.txt
如果⼿机版本是 Android 7.0以上版本，想要获取原始数据⽣成报告，那么可以使⽤如下的命令：
adb bugreport > [path/]bugreport.zip
进⾏导出报告。

path的部分可以指定对应的⽂件路径。

如果⼿机版本低于Android 6.0版本，那么使⽤如下的指令:
adb bugreport > [path/]bugreport.txt
进⾏报告的导出。