跳到內容

安裝 UiAutomator2 驅動程式

除非您有 驅動程式,否則您無法對 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 Extension 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)。

注意事項

在此快速入門中,我們使用 Extension CLI 安裝 UiAutomator2 驅動程式,但如果您將 Appium 整合到 Node.js 專案中,您可能偏好使用 npm 來管理 Appium 及其連接的驅動程式。若要深入了解此技術,請參閱 管理 Appium 擴充功能 指南。

現在,再次啟動 Appium 伺服器(執行 appium),您應該會看到新安裝的驅動程式列為可用

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

完成 Android 設定並安裝 UiAutomator2 驅動程式後,您就可以撰寫您的第一個測試!現在選擇您偏好的語言並嘗試看看