test-suite
2024.10
true
Test Suite 用户指南
本地 Android 设备
要设置本地设备以使用移动自动化活动，您需要运行 Appium 的本地实例，并拥有自动化 Android 设备所需的工具。
您可以自动化两种类型的本地 Android 设备：
- 物理 设备 - 可以通过 USB 数据线连接到本地计算机的 Android 物理设备。
- 模拟器 - 用于本地存储的 Android 设备的模拟器。
下表介绍了在移动设备自动化环境中设置 Appium 时最常用的命令：
appium driver list- 列出已安装的驱动程序（推荐用于 Appium 2.0）adb devices- 列出已连接的设备adb start-server- 开始调试服务器adb kill-server- 停止调试服务器ctrl + c- 终止 Appiumappium-doctor- 有助于调试 Appium。
请按照以下步骤完成配置本地物理 Android 设备的先决条件：
变量名称:
JAVA_HOME 。
变量 value：JDK 在计算机上的路径。 例如：
C:\Program Files\Java\jdk8 。
湾 ANDROID_HOME 变量。 指向安装 Android SDK 的文件夹。
变量名称：
ANDROID_HOME 变量值：Android SDK 在计算机上的位置。 例如： C:\Users\Username\AppData\Local\Android\Sdk 注意： 变量值 路径中的Username部分必须替换为在计算机上操作的用户的实际名称。
重要：如果 Java 是自动更新的，则需要使用更新后的路径手动配置此变量。
-
打开 Node.js 命令提示符并安装 Appium：
- 对于 Appium 1.0，运行以下命令：
npm install -g appium。 Appium 1.0 已安装所有驱动程序。 - 对于 Appium 2.0，运行以下命令：
npm install -g appium@next。
- 对于 Appium 1.0，运行以下命令：
Appium 2.0 未安装驱动程序。 因此，要安装所需的驱动程序，还要运行以下命令：
appium driver install uiautomator2 。
有关 Appium 1.0 配置的更多信息，请参阅 快速入门简介。
注意：我们建议将 Appium 2.0 与 Mobile Automation 22.10 或更高版本一起使用。
- 重新启动计算机以应用更改。
-
打开物理移动设备，然后启用“ 开发者选项”。
- 在手机上，导航至“设置”>“开发者选项”。
- 在“网络”部分下，打开“默认 USB 配置”并将其设置为“仅为手机充电”。
- 启用 USB 调试。
- 在手机上，导航至“设置”>“开发者选项”。
- 在“网络”部分下，打开“默认 USB 配置”并将其设置为“仅为手机充电”。
变量名称:
JAVA_HOME 。
变量 value：JDK 在计算机上的路径。 例如：
C:\Program Files\Java\jdk8 。
湾 ANDROID_HOME 变量。 指向安装 Android SDK 的文件夹。
- 变量名称：
ANDROID_HOME -
变量值：Android SDK 在计算机上的路径。例如：
C:\Users\Username\AppData\Local\Android\Sdk注意： 变量值 路径中的Username部分必须替换为在计算机上操作的用户的实际名称。- 打开 Node.js 命令提示符并安装 Appium：
- 对于 Appium 1.0，运行以下命令：
npm install -g appium。 Appium 1.0 已安装所有驱动程序。 - 对于 Appium 2.0，运行以下命令：
npm install -g appium@next。
Appium 2.0-beta 未安装驱动程序。因此，要安装所需的驱动程序，还要运行以下命令：
appium driver install uiautomator2。
有关 Appium 2.0 配置的更多信息，请参阅 快速入门简介。
注意：我们建议将 Appium 2.0 与 Mobile Automation 22.10 或更高版本一起使用。
- 重新启动计算机以应用更改。
在本地设备上启用 网页视图调试 ，以允许移动设备管理器识别应用程序中的大多数用户界面元素。
如果 Appium 未在您的 Android 上自动检测 Chrome 或 WebView 版本，请选择以下选项之一：
