ADB简单入门

发布于：2025-03-20 ⋅ 阅读:(18) ⋅ 点赞:(0)

ADB（Android Debug Bridge） 安装 APK 文件到 Android 设备或模拟器是一个常见的操作，尤其是在开发和测试过程中。

1. 准备工作

在安装 APK 之前，确保你已经完成以下准备工作：

1.1 安装 ADB 工具

如果你还没有安装 ADB，可以参考以下步骤：
1. 下载并安装 Android SDK Platform Tools。
2. 将 ADB 添加到系统环境变量中（方便在命令行中直接使用）：
  - Windows：
    1. 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    2. 在“系统变量”中找到 Path，点击“编辑”。
    3. 添加 ADB 的安装路径（如 C:\platform-tools）。
  - Mac/Linux：
    1. 打开终端，编辑 ~/.bash_profile 或 ~/.zshrc 文件。
    2. 添加以下内容：
```
export PATH=$PATH:/path/to/platform-tools
```
    3. 保存文件并运行 source ~/.bash_profile 或 source ~/.zshrc。

1.2 连接设备

使用 USB 数据线将 Android 设备连接到电脑。
确保设备已开启 USB 调试 模式：
1. 进入设备的“设置” -> “关于手机” -> 连续点击“版本号” 7 次，启用开发者模式。
2. 返回“设置” -> “系统” -> “开发者选项” -> 开启“USB 调试”。
在终端或命令提示符中运行以下命令，确认设备已连接：
```
adb devices
```
如果设备已连接，会显示设备的序列号，状态为 device。

2. 安装 APK 文件

2.1 使用 ADB 安装 APK

在终端或命令提示符中运行以下命令：

adb install <path_to_apk>

<path_to_apk> 是 APK 文件的路径。

示例：

adb install /Users/username/Downloads/app-debug.apk

如果安装成功，会显示 Success。
2.2 覆盖安装（更新 APK）
如果设备上已安装相同包名的 APK，可以使用 -r 参数进行覆盖安装：
```
adb install -r <path_to_apk>
```

3. 常见问题及解决方法

3.1 安装失败：INSTALL_FAILED_UPDATE_INCOMPATIBLE

原因：设备上已安装相同包名但签名不同的 APK。
解决方法：卸载旧版本 APK，然后重新安装：
```
adb uninstall <package_name>
adb install <path_to_apk>
```

3.2 安装失败：INSTALL_FAILED_INSUFFICIENT_STORAGE

原因：设备存储空间不足。
解决方法：清理设备存储空间，或安装到外部存储：

adb install -s <path_to_apk>

3.3 安装失败：INSTALL_PARSE_FAILED_NO_CERTIFICATES

原因：APK 文件未签名或签名损坏。
解决方法：重新签名 APK 文件，或使用调试签名。

3.4 设备未授权

原因：设备未授权 USB 调试。
解决方法：在设备上弹出的授权对话框中点击“允许”。

4. 其他常用命令

4.1 卸载 APK
使用以下命令卸载指定包名的 APK：
```
adb uninstall <package_name>
```
示例：
```
adb uninstall com.example.app
```
4.2 查看已安装的 APK
使用以下命令查看设备上已安装的 APK：
```
adb shell pm list packages
```

4.3 清除应用数据

使用以下命令清除指定应用的数据：
```
adb shell pm clear <package_name>
```

通过 ADB 安装 APK 文件是 Android 开发和测试中的常见操作。只需确保设备已连接并开启 USB 调试模式，然后使用 adb install 命令即可完成安装。如果遇到问题，可以根据错误信息进行排查和解决。掌握 ADB 的使用技巧，可以大大提高开发和测试的效率。