ADB Shell 命令

AI 汇总，用于速查。

一、活动管理器

adb shell am（Activity Manager）命令用于在 Android 设备上管理 Activity、Service、Broadcast 等组件。其参数可划分为以下功能模块：

1. 组件启动与操作

• 启动 Activity
  start [options] <INTENT>
  示例：adb shell am start -n com.example/.MainActivity
• 启动 Service
  startservice [options] <INTENT>
  示例：adb shell am startservice -n com.example/.MyService
• 绑定 Service
  bindservice [options] <INTENT>
  示例：adb shell am bindservice -n com.example/.MyService
• 停止 Service
  stopservice [options] <INTENT>
  示例：adb shell am stopservice -n com.example/.MyService
• 发送广播
  broadcast [options] <INTENT>
  示例：adb shell am broadcast -a android.intent.action.BOOT_COMPLETED

2. 进程与应用管理

• 强制停止应用
  force-stop <PACKAGE>
  示例：adb shell am force-stop com.example.app
• 终止进程
  kill [options] <PACKAGE>
  示例：adb shell am kill com.example.app
• 清除应用数据
  clear-app-data <PACKAGE>
  示例：adb shell am clear-app-data com.example.app

3. 调试与性能分析

• 启动性能分析
  profile start <PROCESS> <FILE>
  示例：adb shell am profile com.example.app start /sdcard/profile.trace
• 停止性能分析
  profile stop <PROCESS>
  示例：adb shell am profile com.example.app stop
• 设置调试应用
  set-debug-app [options] <PACKAGE>
  示例：adb shell am set-debug-app -w com.example.app
• 清除调试应用设置
  clear-debug-app

4. Instrumentation 测试

• 运行测试用例
  instrument [options] <COMPONENT>
  示例：

  adb shell am instrument -w com.example.test/androidx.test.runner.AndroidJUnitRunner
  

5. 用户与多任务管理

• 切换用户
  switch-user <USER_ID>
  示例：adb shell am switch-user 1
• 启动用户
  start-user <USER_ID>
  示例：adb shell am start-user 1
• 停止用户
  stop-user [options] <USER_ID>
  示例：adb shell am stop-user -f 1
• 任务栈操作
  stack move-task <TASK_ID> <STACK_ID>
  示例：adb shell am stack move-task 1 2

6. 设备显示设置

• 修改显示尺寸
  display-size <WIDTH>x<HEIGHT>
  示例：adb shell am display-size 800x600
• 修改显示密度
  display-density <DPI>
  示例：adb shell am display-density 240

7. 其他工具

• 监控模式
  monitor
  示例：adb shell am monitor（监控 Activity/Service 生命周期）
• 模拟系统挂起（测试用）
  hang
  示例：adb shell am hang
• 重启设备
  restart
  示例：adb shell am restart

常用 Intent 参数选项

在启动组件时，可通过以下选项构建 Intent：

• -a <ACTION>：指定 Action（如 android.intent.action.VIEW）。
• -n <COMPONENT>：指定组件名（包名/类名）。
• -d <DATA_URI>：设置数据 URI（如 https://example.com）。
• -t <MIME_TYPE>：设置 MIME 类型（如 image/png）。
• -f <FLAGS>：添加 Intent Flags（如 0x10000000）。
• --es <EXTRA_KEY> <EXTRA_STRING_VALUE>：添加字符串 Extra。

二、包管理器

adb shell pm（Package Manager）命令用于管理 Android 设备上的应用包（APK）。其参数可划分为以下功能模块：

1. 包查询与列表

• 列出所有包
  list packages [options] [filter]
  示例：

  adb shell pm list packages -f  # 显示包关联的APK路径
  adb shell pm list packages -s  # 只显示系统应用
  

• 查看包安装路径
  path <PACKAGE>
  示例：adb shell pm path com.android.chrome
• 查看包详细信息
  dump <PACKAGE>
  示例：adb shell pm dump com.android.chrome

2. 包安装与卸载

• 安装APK
  install [options] <APK_PATH>
  示例：

  adb shell pm install /sdcard/app.apk
  adb shell pm install -t -g app.apk  # 允许测试并授予所有权限
  

• 卸载应用
  uninstall [options] <PACKAGE>
  示例：

  adb shell pm uninstall com.example.app
  adb shell pm uninstall -k com.example.app  # 卸载但保留数据
  

3. 权限管理

• 授予权限
  grant <PACKAGE> <PERMISSION>
  示例：

  adb shell pm grant com.example.app android.permission.CAMERA
  

• 撤销权限
  revoke <PACKAGE> <PERMISSION>
  示例：

  adb shell pm revoke com.example.app android.permission.ACCESS_FINE_LOCATION
  

• 重置权限
  reset-permissions
  示例：adb shell pm reset-permissions

4. 包状态控制

• 启用/禁用组件
  enable <PACKAGE/COMPONENT>
disable <PACKAGE/COMPONENT>
disable-user <PACKAGE>（仅对当前用户禁用）
  示例：

  adb shell pm disable com.example.app/.MainActivity
  

• 挂起/恢复应用（Android 9+）
  suspend <PACKAGE>
unsuspend <PACKAGE>
  示例：adb shell pm suspend com.example.app

5. 用户管理

• 创建用户
  create-user <USER_NAME>
  示例：adb shell pm create-user test_user
• 删除用户
  remove-user <USER_ID>
  示例：adb shell pm remove-user 10
• 列出用户
  list users
  示例：adb shell pm list users

6. 存储与数据管理

• 清除应用数据
  clear <PACKAGE>
  示例：adb shell pm clear com.example.app
• 设置安装位置
  set-install-location <0|1|2>
  （0=自动，1=内部存储，2=外部存储）
  示例：adb shell pm set-install-location 0
• 获取安装位置
  get-install-location

7. 编译与优化

• 编译应用（ART优化）
  compile [options] <PACKAGE>
  示例：

  adb shell pm compile -m speed com.example.app  # 速度优化
  

• 强制编译所有应用
  force-dex-opt
  示例：adb shell pm force-dex-opt

8. 验证与安全

• 验证安装包
  verify [options] <URI>
  示例：adb shell pm verify -r /sdcard/app.apk
• 设置应用链接行为
  set-app-links [options] <PACKAGE> <STATE>
  示例：adb shell pm set-app-links --package com.example.app 1（允许打开链接）

9. 其他工具

• 修复权限
  reset-permissions（重置运行时权限）
• 重置偏好设置
  reset-preferred-apps <USER_ID>
  示例：adb shell pm reset-preferred-apps 0

三、设备信息

getprop 和 setprop 是 Android 系统属性管理命令，用于读取/修改系统级配置参数。以下是详细的功能模块划分和参数说明：

1. 命令基础功能

2. 系统属性类型（按前缀分类）

a) 只读属性 (ro.*)

• 前缀：ro. (read-only)
• 特点：系统初始化后不可修改
• 常见属性：

  ro.build.version.release    # Android 版本号
  ro.product.model           # 设备型号 (e.g., "Pixel 6")
  ro.serialno                # 设备序列号
  

b) 持久化属性 (persist.*)

• 前缀：persist.
• 特点：重启后值保持不变（存储在 /data/property）
• 常见属性：

  persist.sys.timezone       # 系统时区 (e.g., "Asia/Shanghai")
  persist.sys.language       # 系统语言
  

c) 控制属性 (ctl.*)

• 前缀：ctl.
• 特点：用于启停系统服务
• 关键操作：

  setprop ctl.start <service>   # 启动服务 (e.g., "zygote")
  setprop ctl.stop <service>    # 停止服务
  

d) 调试属性 (debug.*, log.*)

• 前缀：debug. / log.
• 作用：控制调试行为
• 示例：

  setprop log.tag.GPS VERBOSE     # 开启GPS模块详细日志
  setprop debug.choreographer.skipwarning 1  # 禁用UI渲染警告
  

e) 网络属性 (net.*, dhcp.*)

• 前缀：net. / dhcp.
• 作用：管理网络配置
• 示例：

  getprop net.dns1            # 主DNS服务器IP
  setprop net.eth0.dns1 8.8.8.8  # 设置以太网DNS
  

3. 核心参数详解

getprop 参数

setprop 参数

4. 关键属性示例表

5. 操作示例

▶ 读取设备信息

adb shell getprop ro.product.model    # 输出: "Pixel 7 Pro"
adb shell getprop ro.build.version.sdk # 输出: "34" (Android 14)

▶ 修改时区（需重启）

adb shell setprop persist.sys.timezone Europe/Paris

▶ 控制服务启停

# 重启网络服务
adb shell setprop ctl.stop netd
adb shell setprop ctl.start netd

▶ 开启全局调试日志

adb shell setprop log.tag.* VERBOSE

▶ 检查系统启动状态

adb shell getprop sys.boot_completed  # 输出"1"表示启动完成

6. 注意事项

1. 权限要求：

   • 修改 ro.* 属性需要 Root 权限（需先 adb root）
   • persist.* 修改后需重启生效

2. 属性存储位置：

   • 临时属性：/dev/__properties__
   • 持久属性：/data/property/*

3. 危险操作：
   错误修改核心属性（如 ro. 前缀）可能导致 系统无法启动

4. 属性删除：
   无直接删除命令，可通过设置空值覆盖：

   setprop my.temp.property ""
   

7. 调试技巧

• 监视属性变化：

  adb shell watch -n 1 getprop | grep <属性名>
  

• 查看属性列表：

  adb shell getprop | grep -E "ro.|persist."  # 过滤关键属性
  

• 重置所有持久属性：
  删除 /data/property/* 文件（需 Root）

四、转储系统信息

dumpsys 是 Android 系统诊断工具，用于获取系统服务的详细状态信息。其功能模块按系统服务分类，以下是主要模块及其参数的详细解析：

1. 基础系统服务

2. 硬件与传感器

3. 网络与连接

4. 存储与多媒体

5. 进程与性能

核心参数详解

通用参数

模块专用参数

1. Activity 服务 (activity)

   dumpsys activity [options] [COMPONENT]
   

   • a：显示所有 Activity 信息
   • b：显示后台 Activity
   • s：显示栈信息
   • p [package]：过滤指定包名
   • 示例：dumpsys activity p com.android.chrome

2. 内存信息 (meminfo)

   dumpsys meminfo [options] [package|pid]
   

   • -a：显示所有进程
   • -d：显示 Dalvik 内存
   • -s：按重要性排序
   • 示例：dumpsys meminfo -s com.android.browser

3. 图形渲染 (gfxinfo)

   dumpsys gfxinfo [package] [framestats]
   

   • framestats：输出帧性能数据
   • reset：重置统计计数器
   • 示例：dumpsys gfxinfo com.android.chrome framestats

4. 电池统计 (battery)

   dumpsys battery [options]
   

   • set [ac|usb|wireless|status] [value]：模拟电池状态
   • reset：重置电池统计
   • 示例：dumpsys battery set level 50

五、monkey测试

monkey 是 Android 平台的压力测试工具，用于模拟用户随机操作事件。以下是完整的命令参数详解，按功能分类说明：

1、基础命令格式

adb shell monkey [options] <event-count>

• <event-count>：必需参数，指定要发送的随机事件数量（必须放在命令最后）

2、事件类型控制参数

控制不同类型事件的生成比例（默认比例见括号）：

3、测试对象约束参数

4、调试与日志参数

5、事件流控制参数

6、高级配置参数

7、完整命令示例

1. 基础稳定性测试

adb shell monkey -p com.example.app \
  --throttle 300 \
  --ignore-crashes \
  --ignore-timeouts \
  -v -v 10000

2. 精准复现测试场景

adb shell monkey -p com.android.chrome \
  -s 20240501 \          # 固定随机种子
  --pct-touch 40 \
  --pct-appswitch 30 \
  --throttle 500 \
  -v -v -v 5000

3. 带黑名单的多应用测试

adb shell monkey \
  --pkg-blacklist-file /sdcard/blacklist.txt \
  --ignore-security-exceptions \
  --monitor-native-crashes \
  -v 20000

4. 脚本化测试

adb shell monkey \
  -f /sdcard/gestures.mks \  # 手势脚本
  -f /sdcard/login.mks \     # 登录脚本
  --throttle 1000 \
  -v 1000

8、Monkey 脚本语法

Monkey 脚本（.mks 文件）支持精确控制事件：

# 基本命令
type= raw events
count= 10
speed= 1.0

# 触摸事件
DispatchPointer(0,0,0,500,800,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,500,800,0,0,0,0,0,0,0)

# 按键事件
DispatchKey(0,0,0,KEYCODE_HOME,0,0,0,0)

# 启动Activity
LaunchActivity(com.example,com.example.MainActivity)

# 等待
UserWait(2000)

9、调试技巧

1. 事件流重现
   使用 -s 参数固定随机种子重现问题场景：

   adb shell monkey -s 12345 -v 1000
   

2. 实时监控
   结合 logcat 过滤 Monkey 事件：

   adb logcat -s "Monkey"
   

3. 性能分析
   使用 --hprof 生成内存快照：

   adb shell monkey --hprof -p com.example.app 500
   

4. 网络控制
   通过端口远程控制 Monkey：

   adb shell monkey --port 1080 1000
   telnet localhost 1080  # 输入命令如：tap 100 200
   

六、自动化开发相关

1. 输入命令 (input)

用于模拟各种输入事件（按键、触摸、文本输入等）

主要参数：

高级用法：

# 长按操作（通过延长swipe时间）
input swipe 500 500 500 500 2000

# 组合按键（返回+菜单）
input keyevent KEYCODE_BACK && input keyevent KEYCODE_MENU

# 输入特殊字符
input text "邮箱地址\%40domain.com"  # @符号需转义

2. 屏幕截图与录制

(1) screencap 截图命令

(2) screenrecord 录屏命令

3. 设置提供程序 (settings)

管理系统/安全/全局设置

命令结构：

settings [--user <USER_ID>] <namespace> <command> <key> [value]

命名空间：

主要命令：

常用键值示例：

# 启用USB调试
settings put global adb_enabled 1

# 设置默认输入法
settings put secure default_input_method com.google.android.inputmethod.latin/.LatinIME

# 修改屏幕超时
settings put system screen_off_timeout 600000  # 10分钟

4. 窗口管理器 (wm)

管理显示设置和窗口属性

主要命令：

高级用法：

# 临时修改为720P分辨率
wm size 720x1280

# 恢复默认分辨率
wm size reset

# 右侧扩大显示区域100像素（游戏全屏常用）
wm overscan 0,0,-100,0

5. 输入法管理器 (ime)

管理输入法设置和状态

主要命令：

使用流程：

1. 获取输入法ID：

   adb shell ime list -a
   # 示例输出：com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME
   

2. 设置默认输入法：

   ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME
   

3. 切换输入法：

   # 禁用当前输入法
   ime disable com.current.ime/.Keyboard
   
   # 启用新输入法
   ime enable com.new.ime/.Keyboard
   

调试技巧：

# 查看当前输入法
settings get secure default_input_method

# 强制显示输入法
input keyevent KEYCODE_SETTINGS

综合使用示例

# 1. 修改分辨率
wm size 720x1280

# 2. 降低屏幕亮度
settings put system screen_brightness 30

# 3. 切换输入法
ime set com.google.android.inputmethod.latin/.LatinIME

# 4. 输入文本
input text "测试输入@123"

# 5. 截图保存
screencap /sdcard/test_screen.png

# 6. 恢复设置
wm size reset
settings put system screen_brightness 150