续航鸽 · App 耗电授权说明
官网更新：2026-10-25 · Mac 真机复测补充

基础电量、功率、温度和计时不需要本页进阶授权。

手机授权 · Android 11 及以上，无需电脑

1. 连接 Wi-Fi，在手机设置中开启“开发者选项”。通常需要到“关于手机”连续点击系统版本或版本号；不同品牌的位置不同。
2. 从 Shizuku 官方网站下载安装 Shizuku，打开它。续航鸽通过 Shizuku 完成本次授权，不会读取其他应用的私人文件。
3. 在开发者选项打开“USB 调试”和“无线调试”。进入无线调试页面，选择“使用配对码配对设备”。
4. 按 Shizuku 的“通过无线调试启动”指引，在 Shizuku 通知里填写手机显示的配对码。不要提前关闭配对窗口；配对码变化后要重新填写。
5. 回到 Shizuku，点击“启动”，确认显示“正在运行”。
6. 回到续航鸽的授权页面，点击“通过 Shizuku 授权”。看到系统授权提示后选择允许。已拒绝时，可到 Shizuku 的授权应用管理里允许续航鸽。
7. 点击“打开使用情况访问”，找到续航鸽并允许。返回后点击“检查授权并试读”，显示“读取成功”才算完成。

授权只给续航鸽开启耗电统计所需的两项系统权限。授权成功后，续航鸽直接读取系统统计，不依靠 Shizuku 常驻来记录，也不增加无线调试采样。一般重启手机不需要重新授权；卸载重装、系统撤销权限后需要重做。需要重做时，Shizuku 本身可能要重新启动。

Android 8–10 没有这套系统无线配对入口，请使用电脑方式。部分厂商限制授权，不能保证每台手机都支持。黑阈等软件有自己的激活机制，开启它们不代表续航鸽已经获授权。

Shizuku 官网：https://shizuku.rikka.app/zh-hans/download/
官方步骤：https://shizuku.rikka.app/zh-hans/guide/setup/

电脑授权 · Windows / Mac

准备：电脑从 Google 官方页面下载 SDK Platform Tools 并解压。只需平台工具，不需要 Android Studio。
下载：https://developer.android.com/tools/releases/platform-tools

手机：先安装续航鸽，开启开发者选项和 USB 调试，用能传数据的 USB 线连接自己的电脑。手机保持解锁。出现“允许 USB 调试”时确认当前电脑。

小米 / Redmi / 部分 HyperOS 要分清三个开关：
• USB 调试：用于让电脑连接手机。
• USB安装：用于通过电脑安装 APK，不能代替统计授权。
• USB调试（安全设置）：允许通过 USB 调试修改权限或模拟点击。本次真机需要开启这一项，它位于 USB安装管理下面；不同系统位置可能不同。

打开安全设置后，阅读手机的风险提示，等待按钮倒计时结束再确认；若有后续“重要警告 / 请再次确认是否允许？”页面，也要完成确认。回到开发者选项，核对该开关实际已开启。只点过开关或只打开 USB安装不算完成。若手机要求账号或其他验证，需要在手机完成，电脑不能跳过。

Windows：打开解压后的 platform-tools 文件夹，空白处右键选择“在终端中打开”；Windows 10 可按住 Shift 再右键，选择 PowerShell。
先输入：
.\adb.exe devices
看到手机弹窗后允许，再执行一次。手机右边应显示 device。注意：device 只说明已连接，并不表示权限已开启。
然后逐行粘贴，每行按一次回车：
.\adb.exe shell pm grant com.xiaohan.batterytest android.permission.DUMP
.\adb.exe shell pm grant com.xiaohan.batterytest android.permission.PACKAGE_USAGE_STATS

Mac：打开“终端”，输入 cd 和一个空格，把解压后的 platform-tools 文件夹拖到窗口中，再按回车。这样终端才进入 adb 所在文件夹。
先输入：
./adb devices
在手机上允许后，确认手机右边是 device；这只说明已连接，还需要执行授权。然后逐行执行：
./adb shell pm grant com.xiaohan.batterytest android.permission.DUMP
./adb shell pm grant com.xiaohan.batterytest android.permission.PACKAGE_USAGE_STATS

命令正常执行通常不显示文字；出现 SecurityException / GRANT_RUNTIME_PERMISSIONS 则还没有授权成功，先处理报错。回到续航鸽 → 设置 → App 耗电 → 授权：
1. 系统统计权限：已开启。
2. 使用统计权限：已开启。
3. 使用情况访问：已允许；未允许时点“打开使用情况访问”完成。
4. 点击“检查授权并试读”，看到“读取成功”才算完成。
此后可以拔掉数据线，重新开始测试。之前没有记录的 App 耗电不能补算。

如果电脑同时连接了其他手机或模拟器，直接执行上面的命令会出现 more than one device/emulator。请在 devices 列表中找到目标手机左侧的编号，在官网展开“列表里有其他手机或模拟器？”并填入编号，页面会生成带 -s 的命令。

也可手动指定：以下 AB12CD34 是示例，必须替换成自己的手机编号；不要选择 emulator-…：
Mac：
./adb -s AB12CD34 shell pm grant com.xiaohan.batterytest android.permission.DUMP
./adb -s AB12CD34 shell pm grant com.xiaohan.batterytest android.permission.PACKAGE_USAGE_STATS
Windows：
.\adb.exe -s AB12CD34 shell pm grant com.xiaohan.batterytest android.permission.DUMP
.\adb.exe -s AB12CD34 shell pm grant com.xiaohan.batterytest android.permission.PACKAGE_USAGE_STATS

只连接一台目标设备时无需 -s。不要把 Windows 的命令前缀直接复制到 Mac，也不要把整段说明当成命令。

遇到问题怎么处理

• 提示“找不到 adb / adb 不是命令”：终端没有进入解压后的 platform-tools 文件夹，或命令前缀用错。Windows 用 .\adb.exe，Mac 用 ./adb。
• 设备列表为空：检查数据线、USB 调试和驱动；有些线只能充电。Windows 个别手机需要厂商 USB 驱动。
• unauthorized：解锁手机，确认“允许 USB 调试”，再执行 devices。
• offline：重新插线或关闭再开启 USB 调试，然后重新检查。
• more than one device/emulator：按上面的多设备说明指定手机编号，确认命令带 -s；不要猜测目标设备。
• SecurityException / GRANT_RUNTIME_PERMISSIONS：手机系统拒绝授予权限，并未授权成功。小米 / 部分 HyperOS 先按前文开启“USB调试（安全设置）”，完成全部倒计时与风险确认，回到列表核对开关状态。若已开启，可重新插拔数据线并确认连接后重试。仍被拒绝就保存报错，不要反复粘贴。记录手机型号、Android / 系统版本，并保存续航鸽授权日志排查。基础续航测试仍可使用；Shizuku 也受厂商调试权限限制，不保证绕过拒绝。
• Shizuku 未启动：先在 Shizuku 完成无线配对和启动；安装了不等于已经运行。
• Shizuku 已拒绝：在 Shizuku 的授权应用管理中允许续航鸽，再返回重试。
• 已授权但没有 App 耗电：先允许使用情况访问，再试读。系统可能未提供可解析的估算；成功后需重新开始测试，之前没记录的数据不能补算。
• 统计重置、少数 UID 回退：报告按有效数据展示，缺失或回退的部分不会编造成耗电数值。

诊断日志记录手机型号、Android 版本、续航鸽版本、授权状态与本次操作结果，不包含配对码、手机序列号、IP 地址、完整耗电明细或其他 App 的私人内容。日志只在本机，点击导出后由你选择保存位置，不会自动上传。

本轮验证边界（2026-10-25）：Mac + 一台小米 / HyperOS 手机，完成安全调试风险确认后，两项授权命令成功；续航鸽内三项权限均正常，真实试读显示“读取成功”。电脑同时有模拟器时，带 -s 指定手机的命令已验证。Windows 实机与本手机 Shizuku 无线配对未测；不以授权测试证明功率精度或长期后台稳定性。

授权后仍显示“请先开启读取权限”：先在授权页确认三项权限正常且试读成功，再更新到 0.8.1 或更新版本。旧版可能把授权前那次测试保存的失败原因当作当前提示。新版会分别显示当前权限与旧测试的问题，刷新会真正重读系统统计。缺少开始读数的旧测试仍无法补算，需要重新开始测试。

结束测试确认（0.8.2 起）：点击“结束测试”后，先核对弹窗中的已测时长。选择“继续测试”或返回会继续记录；只有点击“结束并保存”才会结束。通知栏的“结束测试”也会返回这个确认页面。