2024-07-18 • 猿知识点

深入理解ADB命令：Android开发与调试的利器

引言

ADB，全称为Android Debug Bridge，是Android开发中不可或缺的一个工具。通过ADB，开发者可以与Android设备进行通信，执行各种命令以进行应用的安装、调试、文件管理等多种操作。本文将详细介绍ADB的各种命令及其用法，帮助开发者更加高效地利用这一工具。

第一章：ADB基础

1.1 ADB简介

ADB是一个命令行工具，它充当了电脑与Android设备之间的桥梁。通过这个桥梁，开发者可以发送命令到设备，以执行各种操作。ADB在Android开发中扮演着重要角色，无论是应用开发还是系统调试，都离不开它。

1.2 ADB的安装与配置

要使用ADB，首先需要安装Android SDK（软件开发工具包）。安装完成后，ADB工具将位于SDK的 platform-tools目录下。将ADB的路径添加到系统的环境变量中，这样就可以在命令行中直接调用ADB命令了。

1.3 连接设备

在使用ADB之前，需要通过USB线将Android设备连接到电脑上，并确保设备已经开启了USB调试模式。连接成功后，可以通过 adb devices命令查看已连接的设备列表。

adb devices

如果设备连接成功，将在命令行中看到设备的序列号。

第二章：ADB常用命令

2.1 安装与卸载应用

安装应用：使用 adb install命令可以安装APK文件到Android设备上。例如：

adb install path_to_apk_file.apk

卸载应用：使用 adb uninstall命令可以卸载设备上的应用。需要提供应用的包名。例如：

adb uninstall com.example.app

2.2 启动与停止应用

启动应用：使用 adb shell am start命令可以启动设备上的应用。需要提供应用的包名和入口Activity的名称。例如：

adb shell am start -n com.example.app/com.example.app.MainActivity

停止应用：使用 adb shell am force-stop命令可以强制停止设备上的应用。需要提供应用的包名。例如：

adb shell am force-stop com.example.app

拓展：

adb install指令为开发者提供了丰富的选项，以满足不同场景下的应用安装需求。首先，让我们逐一了解这些指令的用法：

adb install -r：这个命令用于替换已存在的应用程序，也就是说，它会强制安装应用。即使目标设备上已经安装了同名的应用程序，这个命令也会覆盖原有的应用程序。
adb install -I：此命令用于锁定该应用程序。当应用被锁定后，用户无法卸载或更新它，除非通过adb命令进行解除锁定。
adb install -t：允许安装测试包。默认情况下，adb不允许安装测试包，但使用这个选项后，开发者可以轻松地安装测试版本的应用程序。
adb install -s：这个命令将应用程序安装到SD卡上。对于一些需要额外存储空间的应用来说，这是一个非常有用的选项。
adb install -d：允许安装比设备上已安装版本更低的应用。这在某些特殊情况下可能很有用，但请注意，安装低版本应用可能会导致不兼容问题。
adb install -g：为应用程序授予所有运行时的权限。这可以确保应用在运行时拥有足够的权限来执行其所需的操作。

PS：

除了上述基本用法外，adb还提供了更高级的功能，允许开发者根据具体需求为应用程序授予特定的权限。以下是一些常见的应用场景：

为应用程序授予所有运行时的权限：
当你想确保应用程序在运行时拥有所有必要的权限时，可以使用 adb install -g xxx.apk命令。这样，应用程序将能够在不请求用户许可的情况下访问各种系统资源和功能。
授予特定权限：

对于某些敏感权限，如“MANAGE_EXTERNAL_STORAGE”（管理外部存储设备），无法使用 -g选项直接授予。此时，你可以使用 adb shell appops set --uid com.company.name MANAGE_EXTERNAL_STORAGE allow命令来为应用程序授予此权限。这样，应用程序就能够访问和修改外部存储设备上的文件。

单独授予某个权限：
除了上述特殊权限外，你还可以使用 adb shell pm grant com.company.name android.permission.CAMERA命令为应用程序单独授予某个权限。请注意，这个命令可能不适用于所有类型的权限，特别是那些需要用户明确授权的敏感权限。

2.3 查看设备日志

ADB提供了强大的日志查看功能，通过 adb logcat命令可以查看设备的实时日志输出。这对于调试应用中的问题非常有帮助。例如：

adb logcat

此外，还可以使用各种选项对日志进行过滤和格式化，以便更容易找到关键信息。

2.4 文件管理

ADB还允许开发者通过命令行进行文件管理操作，如复制、移动、删除文件等。这些操作都在ADB Shell环境中进行。例如，要进入ADB Shell，可以执行以下命令：

adb shell

进入Shell后，就可以使用Linux命令行语法进行文件管理了。例如，使用 ls命令列出目录内容，使用 cp命令复制文件等。

第三章：ADB高级用法

3.1 端口转发

ADB支持端口转发功能，这意味着你可以将设备上的某个端口转发到电脑上的某个端口，从而实现通过电脑访问设备上的服务。例如：

adb forward tcp:8080 tcp:8080

这条命令将设备上的8080端口转发到电脑上的8080端口。现在，你可以通过访问电脑的8080端口来访问设备上的相应服务了。

3.2 模拟按键和触摸事件

ADB允许你模拟按键输入和触摸事件，这对于自动化测试非常有用。例如，你可以使用 adb shell input keyevent命令模拟按键事件：

adb shell input keyevent KEYCODE_MENU

这条命令将模拟按下菜单键。同样地，你也可以使用 adb shell input tap命令模拟屏幕点击事件：

adb shell input tap X Y

其中X和Y是点击位置的坐标。

3.3 截屏与录像

ADB还提供了截屏和录像功能。你可以使用 adb shell screencap命令截取设备屏幕的图像，并将其保存到电脑上。例如：

adb shell screencap -p /sdcard/screenshot.png  adb pull /sdcard/screenshot.png .

第一条命令将在设备上截取屏幕并保存到SD卡中，第二条命令将截图文件从设备拉取到电脑上。此外，你还可以使用 adb shell screenrecord命令进行屏幕录像。

第四章：常见问题与解决方案

在使用ADB时，可能会遇到一些问题。以下是一些常见的问题及其解决方案：

设备未连接或无法识别：确保USB调试模式已开启，检查USB线是否完好，尝试更换USB端口或电脑。
ADB命令无响应：确保ADB版本与设备兼容，检查命令语法是否正确，尝试重启ADB服务（adb kill-server后执行 adb start-server）。
日志输出过多难以查找问题：使用 adb logcat的过滤功能（如 :I TAG表示仅显示标记为TAG的日志）来缩小日志范围。
应用安装失败：检查APK文件是否完整且未损坏，确保设备上已卸载旧版本的应用以避免冲突。
端口转发失败：确保转发的端口在设备和电脑上都是可用的，且没有被其他程序占用。

结语

ADB是一个功能强大的工具，它为Android开发者提供了与设备进行通信和调试的桥梁。通过掌握ADB的各种命令和高级功能，你可以更加高效地进行Android应用的开发和调试工作。希望本文能帮助你更深入地了解和使用ADB。随着你对ADB的熟悉程度不断提高，你会发现它在Android开发中的巨大价值。