原生移动开发 / 系统课时

用 adb 检查系统运行状态

用 adb 检查系统运行状态

这一课建立一套可重复的 Android 系统状态检查入口。遇到权限异常、Service 不工作、任务没有启动或闹钟没有触发时,不先猜代码,而是用 pm、am 和 dumpsys 从安装状态、组件状态、进程与系统服务几个层面逐步缩小范围。

学习目标

  • 使用 pm 检查应用是否安装、安装路径和包状态
  • 使用 am 与 dumpsys 检查组件、Service、任务和系统调度状态
  • 能根据命令输出判断下一步应该检查权限、组件、进程还是调度条件

先建立检查顺序

假设目标包名为 <PACKAGE_NAME>。排障时建议先确认“系统是否看得到这个应用”,再确认“组件是否存在”,最后确认“运行时到底发生了什么”。这样可以避免一上来就翻 Logcat,却连应用是否装对、当前组件是否存在都没有确认。

最常用的入口可以压缩成四层:pm 看包与安装信息,am 做 Activity、Service 等组件级操作,dumpsys 查看系统服务当前保存的运行状态,必要时再结合进程信息判断应用是否仍在运行。

用 pm 确认安装与权限状态

下面的命令假定设备已经通过 adb devices 连接,并且 <PACKAGE_NAME> 替换成真实包名。pm list packages 用于确认包存在,pm path 用于确认 APK 路径,dumpsys package 则适合进一步检查包和权限相关状态。Android 官方 ADB 文档将 pm 定义为用于查询和操作已安装应用包的工具。([Android Developers][5])

bash
adb shell pm list packages <PACKAGE_NAME>
adb shell pm path <PACKAGE_NAME>
adb shell dumpsys package <PACKAGE_NAME>

预期结果

text
package:<PACKAGE_NAME>
package:/data/app/<PACKAGE_NAME>/.../base.apk
Packages:
  <PACKAGE_NAME>
  ...

实际输出会随 Android 版本、安装方式和设备环境变化。只要第一条能找到包、第二条能返回 APK 路径,就已经确认“包存在且系统能定位安装产物”;第三条再用于继续检查权限、组件或其他包状态。

用 am 做受控触发

am 更适合做一次明确的组件操作。例如启动一个已导出的 Activity,或者强制停止应用后重新观察启动行为。排障时不要把它当成查看全部状态的工具,而是把它用于制造一个可重复的触发条件。

bash
adb shell am force-stop <PACKAGE_NAME>
adb shell am start -n <PACKAGE_NAME>/<ACTIVITY_CLASS>

预期结果

text
Stopping: <PACKAGE_NAME>
Starting: Intent { cmp=<PACKAGE_NAME>/<ACTIVITY_CLASS> }
Status: ok
Activity: <PACKAGE_NAME>/<ACTIVITY_CLASS>
ThisTime: <TIME>
TotalTime: <TIME>
WaitTime: <TIME>

其中 Activity 启动输出可能因系统版本而不同;重点是确认应用是否能被系统启动,以及启动失败时是否立即出现明确错误。若 force-stop 后仍无法启动,应继续检查 Manifest 中的 Activity 声明、组件状态以及安装包是否正确。

用 dumpsys 看 Service 和任务状态

dumpsys 的价值在于它展示系统服务当前保存的状态,因此特别适合排查“代码调用过,但系统最后是什么状态”。不同 Android 版本的字段和格式可能变化,不应把某一行固定输出当成跨版本契约。

检查 Service 时,可以先搜索目标包;检查 Activity 和任务时,可以查看 Activity 管理服务;排查系统闹钟时,再查看 Alarm Manager。

bash
adb shell dumpsys activity services | grep <PACKAGE_NAME>
adb shell dumpsys activity activities | grep <PACKAGE_NAME>
adb shell dumpsys alarm | grep <PACKAGE_NAME>
adb shell ps -A | grep <PACKAGE_NAME>

预期结果

text
<Service 相关状态,可能包含组件名和当前状态>
<Activity 或 Task 相关状态,可能包含包名和任务信息>
<Alarm 相关记录,若存在则包含目标包或触发信息>
<进程列表,若应用进程存在则会出现对应包名或进程名>

这个示例中的 <PACKAGE_NAME>、进程号、组件状态和时间信息都可能不同。命令返回空结果并不自动等于“功能坏了”:例如当前没有运行中的 Service、没有待触发闹钟,或应用进程已经退出,都可能得到空结果。真正要做的是把结果和你的复现步骤对应起来。

把四类输出连起来判断

当一个后台功能失效时,可以按以下顺序缩小范围:先用 pm 确认包和 APK 没问题,再用 am 制造一次明确触发;如果触发后功能仍异常,就用 dumpsys activity 看 Activity、Service 或任务状态,用 dumpsys alarm 看闹钟是否真的进入系统调度;最后用进程列表确认应用进程是否存在。

例如,Service 没有出现在 dumpsys activity services 中,而进程也没有运行,说明问题至少已经进入“组件没有被实际启动”的范围;如果 Service 存在但进程不断消失,则应继续结合系统日志、后台限制或进程回收原因调查,而不是重复调用启动代码。

用命令验证一个具体故障

假设现象是“点击操作后预期启动的 Service 不工作”。可以先运行下面一组检查:

bash
adb shell pm path <PACKAGE_NAME>
adb shell am force-stop <PACKAGE_NAME>
adb shell am start -n <PACKAGE_NAME>/<ACTIVITY_CLASS>
adb shell dumpsys activity services | grep <PACKAGE_NAME>
adb shell ps -A | grep <PACKAGE_NAME>

预期结果

text
package:/data/app/<PACKAGE_NAME>/.../base.apk
Stopping: <PACKAGE_NAME>
Starting: Intent { cmp=<PACKAGE_NAME>/<ACTIVITY_CLASS> }
<Service 相关状态>
<应用进程信息>

如果前两层都正常,但 Service 仍没有出现,就把检查重点放到 Service 的声明、启动时机和 Android 版本对应的后台限制;如果 Service 出现后很快消失,再继续检查它的生命周期、前台服务要求、异常退出或系统回收原因。这样做比单纯反复点击页面更容易获得可解释的证据。

这些命令的真正价值不是“记住几十个 dumpsys 子命令”,而是建立证据链:包是否存在、组件是否被触发、系统当前记录了什么、进程是否还在。遇到系统能力排障时,沿这条链逐层验证,通常能更快把问题从应用代码缩小到具体的系统边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 adb 检查系统运行状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通