跳至内容

安装 UiAutomator2 驱动

除非你拥有一个 驱动程序,否则你无法使用 Appium 做很多事情,驱动程序是一个接口,允许 Appium 自动化特定平台。

信息

对于本快速入门指南,我们将通过 Appium 自动化 Android 平台上的应用程序,因为通过 Appium 自动化 Android 的系统要求与 Appium 本身相同(而 iOS 驱动程序则需要你使用 macOS)。

我们将使用的驱动程序称为 UiAutomator2 驱动程序。值得访问该驱动程序的文档并将其添加为书签,因为它将在以后成为宝贵的参考。

设置 Android 自动化要求

根据驱动程序,除了一个正常工作的 Appium 服务器外,我们还需要设置以下内容

Android SDK

  • 设置 Android SDK 要求最简单的方法是下载 Android Studio。我们需要使用它的 SDK 管理器(设置 -> 外观和行为 -> 系统设置 -> Android SDK)下载以下项目
    • Android SDK 平台(选择我们要自动化的 Android 平台,例如 API 级别 30)
    • Android SDK 平台工具
  • 如果你愿意,也可以在没有 Android Studio 的情况下下载这些项目
  • 设置 ANDROID_HOME 环境变量以指向安装 Android SDK 的目录。你通常可以在 Android Studio SDK 管理器中找到此目录的路径。它将包含 platform-tools 和其他目录。

Java JDK

  • 安装 Java JDK(对于最新的 Android API 级别,需要 JDK 9,否则需要 JDK 8)。你可以从 OracleAdoptium 下载它。确保你获得的是 JDK 而不是 JRE。
  • 设置 JAVA_HOME 环境变量以指向 JDK 主目录。它将包含 bininclude 和其他目录。

准备设备

  • 如果使用模拟器,请使用 Android Studio 创建并启动 Android 虚拟设备 (AVD)。你可能需要下载要创建的模拟器 API 级别的系统映像。使用 Android Studio 中的 AVD 创建向导通常是完成所有这些操作的最简单方法。
  • 如果使用真实设备,你应该 为开发设置它并启用 USB 调试
  • 连接模拟器或设备后,你可以运行 adb devices(通过位于 $ANDROID_HOME/platform-tools/adb 的二进制文件)以验证你的设备是否显示为已连接。

一旦你的设备在 adb 中显示为已连接,并且你已验证环境变量已正确设置,你就可以开始了!如果你在这些步骤中遇到任何问题,请参考驱动程序文档,或根据需要参考各种 Android 或 Java 文档网站。

此外,恭喜你:无论你是否有意,你现在都已在你的系统上设置了 Android 开发工具链,因此如果你愿意,你可以开始制作 Android 应用程序!

安装驱动程序本身

由于 UiAutomator2 驱动程序由 Appium 核心团队维护,因此它有一个“官方”驱动程序名称,你可以使用它通过 Appium 扩展 CLI 轻松安装它

appium driver install uiautomator2

它应该生成类似于以下内容的输出

Attempting to find and install driver 'uiautomator2'
✔ Installing 'uiautomator2' using NPM install spec 'appium-uiautomator2-driver'
Driver [email protected] successfully installed
- automationName: UiAutomator2
- platformNames: ["Android"]

运行此命令将找到并安装最新版本的 UiAutomator2 驱动程序,使其可用于自动化。请注意,安装后,它会告诉你它适用于哪些平台(在本例中为 Android),以及必须使用什么自动化名称(appium:automationName 功能)在 Appium 会话期间选择此驱动程序以供使用(在本例中为 UiAutomator2)。

注意

在本快速入门中,我们使用了 扩展 CLI 来安装 UiAutomator2 驱动程序,但如果你将 Appium 集成到 Node.js 项目中,你可能更喜欢使用 npm 来管理 Appium 及其连接的驱动程序。要了解有关此技术的更多信息,请访问有关 管理 Appium 扩展 的指南。

现在,再次启动 Appium 服务器(运行 appium),你应该会看到新安装的驱动程序被列为可用

[Appium] Available drivers:
[Appium]   - [email protected] (automationName 'UiAutomator2')

完成 Android 设置并安装 UiAutomator2 驱动程序后,你就可以编写你的第一个测试了!现在选择你喜欢的语言并试一试