ADB应用管理实战：从安装到调试的完整流程
项目地址: https://gitcode.com/gh_mirrors/aw/awesome-adb 文章详细介绍了ADB在Android应用管理中的全面应用，涵盖了应用列表查看与包名过滤技巧、APK安装与卸载的多种方式、应用状态控制（启用、禁用与数据清理）以及应用信息深度查看与调试技巧。通过丰富的命令示例、参数详解和实战场景，为开发者提供了从基础到高级的完整ADB应用管理指南。
应用列表查看与包名过滤技巧
在Android应用开发和管理过程中，高效地查看和筛选应用列表是开发者必备的技能。ADB提供了强大的包管理命令，让开发者能够精准地定位和管理设备上的应用。
基础应用列表查看命令
查看应用列表的基本命令格式如下：
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
这个命令的核心是adb shell pm list packages，在此基础上可以通过各种参数进行灵活的过滤和筛选。
常用过滤参数详解
下表详细列出了所有可用的过滤参数及其功能：
| 参数 | 功能描述 | 使用示例 |
|---|---|---|
| 无参数 | 显示所有已安装应用 | adb shell pm list packages |
-f | 显示应用关联的APK文件路径 | adb shell pm list packages -f |
-d | 只显示被禁用的应用 | adb shell pm list packages -d |
-e | 只显示已启用的应用 | adb shell pm list packages -e |
-s | 只显示系统应用 | adb shell pm list packages -s |
-3 | 只显示第三方应用 | adb shell pm list packages -3 |
-i | 显示应用的安装器信息 | adb shell pm list packages -i |
-u | 包含已卸载但保留数据的应用 | adb shell pm list packages -u |
FILTER | 包名包含指定字符串的应用 | adb shell pm list packages google |
包名过滤的高级技巧
1. 直接字符串匹配过滤
最简单的过滤方式是直接在命令后添加要匹配的字符串：
adb shell pm list packages google
这个命令会列出所有包名中包含"google"字符串的应用，输出格式如下：
package:com.google.android.apps.photos
package:com.google.android.gms
package:com.google.android.youtube
package:com.google.android.apps.maps
2. 使用grep进行复杂过滤
对于更复杂的过滤需求，可以结合Linux的grep命令：
adb shell pm list packages | grep -i camera
这个命令会列出所有包名中包含"camera"的应用，-i参数表示忽略大小写。
3. 正则表达式过滤
使用grep的正则表达式功能可以实现更精确的匹配：
adb shell pm list packages | grep '^package:com\.android\..*'
这个命令会列出所有以com.android.开头的包名，通常这些都是系统核心应用。
实战应用场景
场景1：查找特定开发者的应用
# 查找所有包含"tencent"的应用（腾讯系应用）
adb shell pm list packages tencent
# 或者使用grep进行更灵活的搜索
adb shell pm list packages | grep -E '(qq|wechat|tencent)'
场景2：系统应用与第三方应用分离
场景3：应用状态管理
# 查看所有被禁用的应用
adb shell pm list packages -d
# 查看所有已启用的应用
adb shell pm list packages -e
# 结合过滤查看特定开发者的启用应用
adb shell pm list packages -e | grep google
输出结果处理技巧
1. 统计应用数量
# 统计总应用数量
adb shell pm list packages | wc -l
# 统计Google应用数量
adb shell pm list packages | grep google | wc -l
# 统计系统应用数量
adb shell pm list packages -s | wc -l
2. 格式化输出
使用awk命令可以美化输出格式：
adb shell pm list packages | awk -F: '{print $2}' | sort
这个命令会去除"package:"前缀，并按字母顺序排序输出。
3. 导出到文件
# 导出所有应用到文本文件
adb shell pm list packages > all_apps.txt
# 导出系统应用到CSV文件
adb shell pm list packages -s | sed 's/package://' > system_apps.csv
高级过滤组合技巧
组合多个过滤条件
虽然pm list packages命令本身不支持多个参数组合，但可以通过管道连接多个命令：
# 先获取系统应用，再过滤包含"settings"的应用
adb shell pm list packages -s | grep settings
# 获取已启用的第三方应用
adb shell pm list packages -3 -e
使用复杂正则表达式
# 查找所有以com.google.android开头的应用
adb shell pm list packages | grep '^package:com\.google\.android'
# 查找包名长度为10-15个字符的应用
adb shell pm list packages | grep -E '^package:[a-z\.]{10,15}$'
实际案例分析
假设我们需要分析一个设备上的应用情况：
# 1. 查看总应用数
total_apps=$(adb shell pm list packages | wc -l)
# 2. 查看系统应用数
system_apps=$(adb shell pm list packages -s | wc -l)
# 3. 查看第三方应用数
third_party_apps=$(adb shell pm list packages -3 | wc -l)
# 4. 查看Google系应用数
google_apps=$(adb shell pm list packages | grep google | wc -l)
echo "总应用数: $total_apps"
echo "系统应用数: $system_apps"
echo "第三方应用数: $third_party_apps"
echo "Google应用数: $google_apps"
注意事项和最佳实践
-
权限要求：某些过滤操作可能需要root权限，特别是在查看系统应用详细信息时。
-
性能考虑：在设备应用数量较多时，使用grep过滤可能会稍微慢一些，建议先使用原生过滤参数。
-
跨设备兼容性：不同Android版本可能支持不同的pm命令参数，建议先测试兼容性。
-
输出处理：对于自动化脚本，建议总是处理命令输出，避免因为空输出或错误输出导致脚本异常。
通过掌握这些应用列表查看和包名过滤技巧，开发者可以更加高效地管理Android设备上的应用，无论是进行应用分析、故障排查还是自动化脚本编写，都能得心应手。
APK安装与卸载的多种方式
在Android应用开发与测试过程中，APK的安装与卸载是最基础且频繁的操作。ADB提供了丰富的命令选项来满足不同场景下的需求，从简单的单文件安装到复杂的批量处理，每种方式都有其特定的应用场景和优势。
基础安装命令详解
ADB安装APK的基本命令格式如下：
adb install [options] <path-to-apk>
常用安装选项参数表
| 参数 | 说明 | 使用场景 |
|---|---|---|
-l | 锁定应用 | 防止应用被意外卸载 |
-r | 替换现有应用 | 应用升级或重新安装 |
-t | 允许测试包 | 安装测试版本的APK |
-s | 安装到SD卡 | 节省设备内部存储空间 |
-d | 允许版本降级 | 回退到旧版本应用 |
-g | 授予所有权限 | 自动授予应用请求的所有权限 |
安装流程示意图
多种安装方式实战
1. 普通安装
最基本的安装方式，适用于大多数场景：
# 安装单个APK文件
adb install app-debug.apk
# 安装时指定设备（多设备情况下）
adb -s emulator-5554 install app-debug.apk
2. 覆盖安装（升级）
当应用已存在时，使用-r参数进行覆盖安装：
# 覆盖安装，保留数据
adb install -r app-update.apk
# 覆盖安装并授予所有权限
adb install -r -g app-update.apk
3. 多APK安装（Split APKs）
对于使用Android App Bundle生成的拆分APK：
# 安装基础APK
adb install-multiple base.apk
# 安装包含配置的拆分APK
adb install-multiple --abi armeabi-v7a base.apk config.armeabi_v7a.apk
# 安装完整拆分APK集合
adb install-multiple base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
4. 静默安装（需要root权限）
在已root的设备上实现无界面安装：
# 进入adb shell并以root权限执行
adb shell
su
pm install /sdcard/app.apk
# 或者使用一条命令
adb shell "su -c 'pm install /sdcard/app.apk'"
应用卸载的多种方式
基础卸载命令
adb uninstall [options] <package-name>
卸载选项参数表
| 参数 | 说明 | 使用场景 |
|---|---|---|
-k | 保留数据和缓存目录 | 重新安装时保留用户数据 |
| (无) | 完全卸载应用 | 清理所有应用相关文件 |
卸载操作示例
# 完全卸载应用（删除所有数据）
adb uninstall com.example.myapp
# 卸载但保留数据（仅删除应用本身）
adb uninstall -k com.example.myapp
# 卸载系统应用（需要root权限）
adb shell
su
pm uninstall -k --user 0 com.android.bluetooth
批量卸载操作
# 卸载多个应用
for package in com.app1 com.app2 com.app3; do
adb uninstall $package
done
# 卸载所有测试应用（匹配特定包名模式）
adb shell pm list packages | grep "test" | cut -d: -f2 | xargs -n1 adb uninstall
安装状态检测与错误处理
检查安装状态
# 查看已安装应用列表
adb shell pm list packages
# 检查特定应用是否已安装
adb shell pm list packages | grep "com.example"
# 获取应用安装路径
adb shell pm path com.example.myapp
常见安装错误及解决方案
| 错误代码 | 错误描述 | 解决方案 |
|---|---|---|
INSTALL_FAILED_ALREADY_EXISTS | 应用已存在 | 使用-r参数或先卸载 |
INSTALL_FAILED_INVALID_APK | APK文件损坏 | 重新构建或下载APK |
INSTALL_FAILED_INSUFFICIENT_STORAGE | 存储空间不足 | 清理设备存储空间 |
INSTALL_FAILED_UPDATE_INCOMPATIBLE | 版本不兼容 | 先完全卸载旧版本 |
INSTALL_PARSE_FAILED_NO_CERTIFICATES | 签名证书缺失 | 检查APK签名配置 |
高级安装技巧
1. 安装到特定用户
# 安装到用户0（主用户）
adb install --user 0 app.apk
# 安装到多用户环境
adb install --user 10 app.apk
2. 强制安装选项
# 强制安装（忽略某些警告）
adb install -f app.apk
# 安装并立即启动应用
adb install -r -g app.apk && adb shell am start -n com.example.myapp/.MainActivity
3. 安装状态监控
# 实时监控安装过程日志
adb logcat | grep "PackageManager"
# 检查安装结果
adb shell dumpsys package com.example.myapp | grep -E "versionName|versionCode"
实战案例：自动化安装脚本
#!/bin/bash
# 自动化安装脚本示例
APK_PATH="./app/build/outputs/apk/debug/app-debug.apk"
PACKAGE_NAME="com.example.myapp"
echo "开始安装应用..."
if adb install -r -g "$APK_PATH"; then
echo "✅ 应用安装成功"
# 检查应用是否正常运行
if adb shell pm list packages | grep -q "$PACKAGE_NAME"; then
echo "✅ 应用包存在"
# 启动应用
adb shell am start -n "$PACKAGE_NAME/.MainActivity"
echo "🚀 应用已启动"
else
echo "❌ 应用包未找到"
fi
else
echo "❌ 应用安装失败"
# 显示详细错误信息
adb logcat -d | grep "PackageManager" | tail -10
fi
通过掌握这些多种安装与卸载方式，开发者可以更加灵活地进行应用部署、测试和调试工作，大大提高开发效率。每种方法都有其适用的场景，在实际工作中应根据具体需求选择最合适的方式。
应用状态控制：启用、禁用与数据清理
在Android应用开发与测试过程中，对应用状态的有效控制是至关重要的技能。通过ADB的Package Manager（pm）命令，我们可以实现对应用的精确控制，包括启用、禁用以及清理应用数据等操作。这些功能不仅在日常开发调试中非常实用，在自动化测试和系统优化场景中也发挥着重要作用。
应用状态管理基础
Android系统通过Package Manager服务来管理所有已安装应用的状态。每个应用都有一个明确的状态标识，决定了它是否可以被用户启动和使用。理解这些状态对于有效管理应用至关重要。
查看应用状态列表
在进行状态管理之前，首先需要了解当前设备上应用的状态分布。使用以下命令可以查看所有已启用的应用：
adb shell pm list packages -e
这个命令会列出所有当前处于启用状态的应用包名。输出格式类似于：
package:com.android.settings
package:com.google.android.gms
package:com.example.myapp
如果需要查看所有应用（包括禁用状态），可以使用：
adb shell pm list packages
禁用应用操作
禁用应用是一个非常有用的功能，特别是在以下场景：
- 临时禁用系统预装的不需要的应用
- 测试应用在禁用状态下的行为
- 节省系统资源和电池寿命
禁用命令语法
adb shell pm disable-user <packagename>
其中 <packagename> 是要禁用的应用的完整包名。
实际操作示例
禁用360手机卫士应用：
adb shell pm disable-user com.qihoo360.mobilesafe
执行成功后，该应用将从启动器中消失，用户无法直接启动，同时系统也不会在后台运行该应用的任何组件。
禁用状态的影响
当应用被禁用时，系统会：
- 隐藏应用图标
- 停止所有后台服务
- 取消所有定时任务和警报
- 阻止广播接收器接收广播
- 保持应用数据完整（可后续启用恢复）
启用应用操作
启用操作是禁用的逆过程，用于恢复被禁用应用的功能。
启用命令语法
adb shell pm enable <packagename>
实际操作示例
启用之前禁用的360手机卫士应用：
adb shell pm enable com.qihoo360.mobilesafe
执行成功后，应用图标重新出现在启动器中，所有功能恢复正常。
应用数据清理
清理应用数据是开发和测试过程中经常需要的操作，特别是在以下场景：
- 测试应用首次启动流程
- 清除测试产生的脏数据
- 恢复应用到初始状态
清理命令语法
adb shell pm clear <packagename>
实际操作示例
清理360手机卫士的数据和缓存：
adb shell pm clear com.qihoo360.mobilesafe
这个命令的效果等同于在系统设置中的应用信息界面中点击"清除缓存"和"清除数据"按钮。
清理操作的影响
执行 pm clear 命令后：
- 应用的所有私有数据被删除
- 缓存文件被清理
- 共享偏好设置被重置
- 数据库被删除并重建
- 应用恢复到首次安装后的状态
高级应用状态管理
除了基本的状态控制，还可以使用更精细的控制命令：
查看应用详细信息
adb shell dumpsys package <packagename>
这个命令会输出应用的详细信息，包括：
- 当前启用状态
- 权限配置
- 组件信息（Activity、Service等）
- 安装路径和数据目录
强制停止应用
adb shell am force-stop <packagename>
这个命令会立即停止应用的所有进程，但不会改变应用的启用状态。
状态管理最佳实践
在实际使用中，建议遵循以下最佳实践：
- 备份重要数据：在执行禁用或清理操作前，确保重要数据已备份
- 谨慎操作系统应用：避免随意禁用系统核心应用，可能导致系统不稳定
- 批量操作脚本化：对于需要频繁执行的操作，可以编写shell脚本自动化
#!/bin/bash
# 批量禁用示例
PACKAGES=("com.example.app1" "com.example.app2" "com.example.app3")
for package in "${PACKAGES[@]}"; do
adb shell pm disable-user "$package"
echo "已禁用: $package"
done
- 状态验证：重要操作后验证状态是否按预期变化
# 验证应用是否已禁用
adb shell pm list packages | grep -q "com.example.app" && echo "应用仍存在" || echo "应用已禁用"
常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 禁用失败 | 应用是系统核心组件 | 使用 pm disable 而不是 pm disable-user |
| 清理后应用崩溃 | 数据依赖性强 | 检查应用的数据初始化逻辑 |
| 启用后功能异常 | 组件状态不同步 | 重启应用或设备 |
通过掌握这些应用状态控制命令，开发者可以更加高效地进行应用调试、测试和优化工作。这些命令的组合使用为Android应用开发提供了强大的管理能力。
应用信息深度查看与调试技巧
在Android应用开发和调试过程中，深入了解应用的内部状态和运行信息至关重要。ADB提供了强大的工具来帮助我们深入查看应用的各种信息，从包结构到运行时状态，从内存使用到权限配置。掌握这些调试技巧将极大提升开发效率和问题排查能力。
包信息深度分析
使用dumpsys package命令可以获取应用的完整详细信息，这是分析应用配置和状态的最强大工具之一：
# 查看应用的完整包信息
adb shell dumpsys package com.example.app
# 仅查看权限相关信息
adb shell dumpsys package com.example.app | grep -A 10 -B 10 "permission"
# 查看应用安装位置和数据目录
adb shell dumpsys package com.example.app | grep -E "(dataDir|codePath)"
该命令输出的信息非常丰富，包含以下关键部分：
| 信息类别 | 描述 | 示例输出 |
|---|---|---|
| 包基本信息 | 包名、版本号、UID等 | Package [com.example.app] (a1b2c3d4) |
| 权限信息 | 声明的和请求的权限 | requested permissions: |
| 组件信息 | Activity、Service、Receiver等 | Activities: Services: |
| 数据目录 | 应用数据存储路径 | dataDir=/data/user/0/com.example.app |
| 安装信息 | APK路径和安装时间 | codePath=/data/app/com.example.app-abc123 |
内存使用分析
内存分析是应用性能调优的关键环节，dumpsys meminfo命令提供了详细的内存使用情况：
# 查看指定应用的内存信息
adb shell dumpsys meminfo com.example.app
# 查看所有进程的内存使用排名
adb shell dumpsys meminfo --package -s
# 查看Native内存分配详情
adb shell dumpsys meminfo com.example.app -a
内存信息输出示例：
Applications Memory Usage (in Kilobytes):
Uptime: 1234567890 Realtime: 1234567890
** MEMINFO in pid 1234 [com.example.app] **
Pss Private Private SwapPss Heap Heap Heap
Total Dirty Clean Dirty Size Alloc Free
------ ------ ------ ------ ------ ------ ------
Native Heap 12345 12000 345 678 15000 14000 1000
Dalvik Heap 5678 5600 78 234 6000 5500 500
Dalvik Other 890 890 0 0
Stack 456 456 0 0
Ashmem 123 100 23 0
Other dev 5 0 5 0
.so mmap 2345 100 2245 0
.apk mmap 678 0 678 0
.ttf mmap 23 0 23 0
.dex mmap 3456 0 3456 0
Other mmap 456 456 0 0
Unknown 789 789 0 0
TOTAL 29240 20491 6853 912 21000 19500 1500
进程状态监控
了解应用的进程状态对于调试ANR（应用无响应）和性能问题非常重要：
# 查看应用进程的详细状态
adb shell dumpsys activity processes com.example.app
# 查看CPU使用情况
adb shell dumpsys cpuinfo | grep com.example.app
# 查看电池消耗统计
adb shell dumpsys batterystats --package com.example.app
组件状态调试
应用中的各个组件（Activity、Service、Receiver）的状态监控：
# 查看Activity堆栈信息
adb shell dumpsys activity activities | grep -A 20 -B 5 com.example.app
# 查看Service运行状态
adb shell dumpsys activity services com.example.app
# 查看广播接收器信息
adb shell dumpsys activity broadcasts | grep com.example.app
数据库和文件系统分析
应用的数据存储情况也是调试的重要方面：
# 查看应用的文件系统使用情况
adb shell dumpsys diskstats | grep com.example.app
# 查看数据库信息（需要root权限）
adb shell "run-as com.example.app ls -la /data/data/com.example.app/databases/"
性能 profiling 技巧
结合其他工具进行深度性能分析：
# 监控应用启动时间
adb shell am start -W -n com.example.app/.MainActivity
# 监控帧率（需要开发者选项中的GPU呈现模式分析）
adb shell dumpsys gfxinfo com.example.app
# 监控网络使用情况
adb shell dumpsys netstats | grep -A 10 -B 10 com.example.app
调试信息过滤技巧
由于dumpsys输出信息量大，掌握过滤技巧很重要：
# 使用grep进行关键词过滤
adb shell dumpsys package com.example.app | grep -E "(version|targetSdk|minSdk)"
# 查看特定权限的使用情况
adb shell dumpsys package com.example.app | grep -A 5 -B 5 "android.permission"
# 提取JSON格式的信息（如果输出包含JSON）
adb shell dumpsys package com.example.app | grep -o '{.*}' | jq .
自动化调试脚本
创建自动化脚本来定期收集应用状态信息：
#!/bin/bash
# app_debug_info.sh
PACKAGE_NAME="com.example.app"
OUTPUT_DIR="./debug_info_$(date +%Y%m%d_%H%M%S)"
mkdir -p $OUTPUT_DIR
# 收集各种调试信息
adb shell dumpsys package $PACKAGE_NAME > $OUTPUT_DIR/package_info.txt
adb shell dumpsys meminfo $PACKAGE_NAME > $OUTPUT_DIR/meminfo.txt
adb shell dumpsys cpuinfo | grep $PACKAGE_NAME > $OUTPUT_DIR/cpuinfo.txt
adb shell dumpsys activity processes $PACKAGE_NAME > $OUTPUT_DIR/processes.txt
echo "调试信息已保存到: $OUTPUT_DIR"
状态监控流程图
通过mermaid流程图展示应用状态监控的整体流程：
常见问题排查表
| 问题现象 | 相关调试命令 | 预期输出 |
|---|---|---|
| 应用崩溃 | adb logcat | grep -i fatal | 查看崩溃堆栈 |
| 内存泄漏 | adb shell dumpsys meminfo | 监控PSS值增长 |
| ANR问题 | adb shell dumpsys activity processes | 查看主线程状态 |
| 权限拒绝 | adb shell dumpsys package | 检查权限声明 |
| 启动缓慢 | adb shell am start -W | 查看启动时间 |
高级调试技巧
对于复杂的问题，可能需要组合多个调试命令：
# 实时监控应用状态变化
watch -n 2 "adb shell dumpsys meminfo com.example.app | head -20"
# 对比两个时间点的状态差异
adb shell dumpsys meminfo com.example.app > meminfo_before.txt
# 执行某些操作后
adb shell dumpsys meminfo com.example.app > meminfo_after.txt
diff meminfo_before.txt meminfo_after.txt
# 使用Python解析dumpsys输出（示例）
import subprocess
import re
def parse_meminfo(package_name):
result = subprocess.run(
['adb', 'shell', 'dumpsys', 'meminfo', package_name],
capture_output=True, text=True
)
# 使用正则表达式解析关键信息
patterns = {
'total_pss': r'TOTAL:\s+(\d+)',
'native_heap': r'Native Heap:\s+(\d+)',
'dalvik_heap': r'Dalvik Heap:\s+(\d+)'
}
info = {}
for key, pattern in patterns.items():
match = re.search(pattern, result.stdout)
if match:
info[key] = int(match.group(1))
return info
掌握这些深度查看和调试技巧，你将能够快速定位和解决Android应用开发中的各种复杂问题。记住，熟练使用dumpsys系列命令是成为Android开发调试高手的关键一步。
总结
本文系统性地讲解了ADB在应用管理方面的强大功能，从基础的应用列表查看、包名过滤，到复杂的APK安装卸载操作，再到精细的应用状态控制和深度信息调试。通过掌握这些技巧，开发者能够高效地进行应用部署、测试调试和性能优化工作。文章提供的实战案例、自动化脚本和问题排查方法，为Android应用开发提供了全面的工具支持，极大提升了开发效率和问题解决能力。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
