鸽子台 Studio
‹ 返回续航鸽

续航鸽 · 使用说明

开启 App 耗电统计。

想知道这次测试里各个 App 用了多少电,
先给续航鸽开启系统统计权限。

只看电量、功率、温度和时长,可以直接使用,不需要这里的授权。

先更新到续航鸽 0.8.2 或更新版本。应用内入口:设置 → App 耗电 → 授权。在手机的“关于手机”中可以查看 Android 版本;Android 8–10 请使用电脑方式。

方式一 · 手机授权

用 Shizuku 在手机上完成。

不需要 Root。Shizuku 是辅助授权应用,需要你在手机上完成配对;只安装它,还没有完成授权。

  1. 安装 Shizuku,连接 Wi-Fi

    从 Shizuku 官网下载并安装,打开它。手机连接 Wi-Fi,允许 Shizuku 显示配对通知。

  2. 打开开发者选项和无线调试

    进入手机“设置 → 关于手机”,连续点击系统版本或版本号,直到提示已进入开发者模式。回到设置找到“开发者选项”,开启“USB 调试”和“无线调试”。各品牌入口可能不同,也可以在设置中搜索。小米 / 部分 HyperOS 的无线授权同样可能需要额外的安全调试设置。

  3. 在 Shizuku 中配对

    在 Shizuku 里选择“通过无线调试启动”下的“配对”,按提示打开无线调试,点“使用配对码配对设备”。保持配对窗口打开,在 Shizuku 的通知中输入手机显示的配对码并发送。

    配对码会变化,不要使用旧码;通知里没有输入框时,先检查 Shizuku 的通知权限。详细页面可对照 Shizuku 官方步骤。

  4. 启动 Shizuku

    回到 Shizuku,点击“启动”,等它显示“正在运行”。如果配对成功但无法启动,保持无线调试开启,按它的提示检查网络和开发者设置。

  5. 回到续航鸽,允许授权

    打开“设置 → App 耗电 → 授权”,点击“通过 Shizuku 授权”,在弹窗中选择允许。页面上的“系统统计权限”和“使用统计权限”应变为“已开启”。

  6. 开启使用情况访问,试读一次

    点“打开使用情况访问”,在系统页面找到“续航鸽”并允许。返回后点“检查授权并试读”,出现“读取成功”后,重新开始一次测试。

授权完成后

续航鸽直接读取系统统计,不依靠 Shizuku 常驻采样。一般重启不用重新授权;卸载重装或系统撤销权限后需要重做。黑阈等应用有自己的激活机制,开启它们不会自动授权续航鸽。

方式二 · 电脑授权

连接电脑,执行两条命令。

Windows 和 Mac 都能操作,不需要安装 Android Studio。先连接要授权的手机。如果列表里还有其他手机或模拟器,可以在下方填写手机编号,生成只发给这台手机的命令。

  1. 下载并解压平台工具

    打开 Google 官方的 SDK Platform Tools 下载页,选择 Windows 或 Mac 对应的下载项,解压得到 platform-tools 文件夹。

  2. 准备手机和数据线

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

小米 / Redmi / 部分 HyperOS · 先检查这一项

这三个开关,用处不同。

USB 调试让电脑连接手机。
USB安装允许通过电脑安装 APK,不能代替统计授权。
USB调试(安全设置)允许通过 USB 调试修改权限或模拟点击。本次实测需要开启这一项。

进入“开发者选项”,找到 USB安装管理下面的“USB调试(安全设置)”。阅读系统风险提示,等按钮倒计时结束后确认;有后续确认页时继续按提示操作。最后回到列表,核对这一项的开关确实已开启。

只点了一次开关、打开“USB安装”或看到手机连接成功,都不算完成。若系统要求账号或其他验证,需在手机上完成;电脑不能替你跳过。确认后回电脑重试授权,仍被拒绝时先保存报错,停止反复执行。

相关系统限制可对照 Shizuku 官方说明 ↗。

Windows

先完成上方的工具下载与手机准备,再继续。

小米 / Redmi / 部分 HyperOS 手机,请先完成“USB调试(安全设置)”与全部风险确认,再执行授权。

在 platform-tools 文件夹中打开终端。

打开解压后的文件夹,在空白处右键选“在终端中打开”。Windows 10 可以按住 Shift 再右键,选择“在此处打开 PowerShell 窗口”。

先粘贴下面这一行,按回车:

.\adb.exe devices

在手机上允许 USB 调试后,再执行一次。手机右侧显示 device 才能继续;这只代表连接正常。如果是 unauthorized,先看手机弹窗。

下面两条命令,每次复制一条,粘贴后按回车:

列表里有其他手机或模拟器?

复制 .\adb.exe devices 输出中,你这台手机左侧的编号。示例中的 AB12CD34 仅为演示,请填写自己的手机编号,避开 emulator-…。

未指定编号:只连接一台设备时使用。

.\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

先完成上方的工具下载与手机准备,再继续。

小米 / Redmi / 部分 HyperOS 手机,请先完成“USB调试(安全设置)”与全部风险确认,再执行授权。

打开“终端”,进入 platform-tools 文件夹。

在 Mac 上搜索并打开“终端”。输入 cd,再输入一个空格,把解压后的 platform-tools 文件夹拖进终端,按回车。这样终端才进入工具所在的位置。

先粘贴下面这一行,按回车:

./adb devices

在手机上允许 USB 调试后,再执行一次。确认手机右侧显示 device。这只说明已连接,还没有获得 App 耗电权限。再逐条复制执行下面两条授权命令:

列表里有其他手机或模拟器?

复制 ./adb devices 输出中,你这台手机左侧的编号。示例中的 AB12CD34 仅为演示,请填写自己的手机编号,避开 emulator-…。

未指定编号:只连接一台设备时使用。

./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 等错误,就还没有授权成功,先按下方的报错说明处理。

  1. 续航鸽 → 设置 → App 耗电 → 授权。
  2. 核对“系统统计权限”“使用统计权限”均为“已开启”。
  3. 打开“使用情况访问”,允许续航鸽,返回后应显示“已允许”。
  4. 点击“检查授权并试读”,看到“读取成功”才算完成。

之后可以拔掉数据线,重新开始测试。之前未记录的 App 耗电无法补算。

2026.10.25 已用 Mac 和小米 / HyperOS 手机实测:完成安全调试确认后,两项授权成功,续航鸽显示“读取成功”。Windows 与手机无线配对尚未完成真机验证。

遇到问题

看提示,找到对应的处理方式。

找不到 adb,或提示“不是内部或外部命令”

确认终端进入了解压后的 platform-tools 文件夹。Windows 命令用 .\adb.exe 开头,Mac 用 ./adb 开头。不要在手机搜索框、浏览器地址栏或应用聊天框里输入命令。

devices 下方没有设备,或显示 unauthorized / offline

没有设备:检查 USB 调试、数据线和驱动;有些线只能充电。Windows 个别手机需要安装手机厂商提供的 USB 驱动。

unauthorized:解锁手机,允许 USB 调试,再检查一次。offline:重新插线,或重新开启 USB 调试。如果提示 more than one device,展开 Windows 或 Mac 步骤里的“列表里有其他手机或模拟器?”,填入目标手机编号,再复制新命令。

出现 SecurityException / GRANT_RUNTIME_PERMISSIONS

这表示手机系统拒绝了授予权限;命令已经执行到了手机,但授权尚未完成。设备显示 device、能安装 APK,都不能代替这项授权。

小米 / Redmi / 部分 HyperOS:回到上方三个开关的说明,确认开启的是“USB调试(安全设置)”,并完成全部风险确认。若开关已开启,可以重新插拔数据线、再次确认电脑连接后重试。

仍然拒绝时,保存终端报错,连同手机型号、Android / 系统版本和续航鸽授权页的诊断日志一起排查。先停止重复执行;基础电量、功率、温度和计时仍可使用。Shizuku 也受厂商调试权限限制,换成手机授权不保证绕过该限制。

Shizuku 未启动,或已经拒绝过授权

先在 Shizuku 完成配对和启动,确认“正在运行”。如果曾拒绝,在 Shizuku 的授权应用管理里找到续航鸽并允许,再回来重试。重启后需要再次使用 Shizuku 时,可能要重新启动它。

授权成功后,还显示“请先开启读取权限”?

先在授权页确认三项权限正常,并点击试读。如果显示“读取成功”,但旧版 App 耗电页仍提示开启权限,可能是页面显示了授权前那次测试保存的失败原因。

请更新至 0.8.1 或更新版本。新版会把当前权限和旧测试的失败原因区分开,刷新也会重新读取系统数据。这次测试若缺少开始读数,仍需重新开始测试,才能得到有效的本次耗电差值。

授权完成了,还是没有 App 耗电数据

确认使用情况访问已允许,再点击试读。数据来自手机系统的估算,部分系统不提供可解析的数据。试读成功后,需要重新开始测试:开始、每 5 分钟和结束各记录一次;已有测试里没采到的数据不会补造。

诊断与文本说明

把问题保存下来。

应用内打开“设置 → App 耗电 → 授权”,向下找到“说明与诊断”。

保存完整说明为 TXT

手机和电脑步骤、常见问题都放在一份文本里。选好保存位置,以后可以直接用文本阅读器打开。

保存诊断日志为 TXT

保存手机型号、Android 和应用版本、权限状态与授权操作结果。遇到问题时,先试一次授权或试读,再保存日志。

日志只保存在本机,不自动上传;不包含配对码、手机序列号、IP 地址、完整耗电明细或其他 App 的私人内容。是否分享,由你决定。

下载完整文本说明 ↓