安裝 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 命令列工具 中包含的
sdkmanager
下載 Android SDK 平台 - Android SDK 平台工具
- 可以使用 Android 命令列工具 中包含的
- 設定
ANDROID_HOME
環境變數,指向安裝 Android SDK 的目錄。您通常可以在 Android Studio SDK 管理員中找到此目錄的路徑。它將包含platform-tools
和其他目錄。
Java JDK¶
- 安裝 Java JDK(對於最新的 Android API 等級,需要 JDK 9,否則需要 JDK 8)。您可以從 Oracle 或 Adoptium 下載。請務必取得 JDK,而不是 JRE。
- 設定
JAVA_HOME
環境變數,指向 JDK 主目錄。它將包含bin
、include
和其他目錄。
準備裝置¶
- 如果使用模擬器,請使用 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 輕鬆安裝它
它應該產生類似以下的輸出
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 驅動程式後,您就可以撰寫您的第一個測試!現在選擇您偏好的語言並嘗試看看