1 環境搭建背景
- 版本升級：Appium 2.0 版本替代 1.x，原 Appium Desktop 因安全漏洞和功能廢棄不再適用。
- 需求痛點：Android Studio 僅支持 debug 程序元素定位，需通過 Appium Inspector 實現通用 APK 元素定位。
2 環境搭建步驟
2.1 環境變量
系統變量新增參數：ANDROID_HOME， 值是本地 Android SDK 的路徑：確保該路徑下有build-tools和platforms目錄。
設置后重啟計算機！！！
2.2 安裝 NPM
安裝 64 位 nodejs 最新 LTS 版本：
下載地址
2.3 安裝 Appium 相關依賴
# 設置全局模塊安裝路徑
npm config set prefix "D:\xxx\component"# 設置全局緩存路徑
npm config set cache "D:\xxx\cache"# 全局安裝 appium
npm install -g appium# 安裝 Android 驅動
appium driver install uiautomator2# （IOS 可選）安裝 IOS 驅動（需要 Mac 系統和 Xcode 開發環境）
appium driver install xcuitest
2.4 安裝 Appium Inspector
安裝最新版本 Appium Inspector ：目前最新是 2025.3.1
下載地址
展開下載列表后選擇 64 位的 Windows 版本：
2.5 使用 Appium Inspector
命令行啟動 Appium 服務：
appium
手機打開"USB 調試" 開關，通過命令查詢手機 SN：
打開 Appium Inspector，配置如下：deviceName 參數的值填上一步的 SN 號。
{"platformName": "Android","deviceName": "xxxxxx","automationName": "UiAutomator2"
}
- 連接參數：
- Remote Host：127.0.0.1
- Remote Port：4723（與 Appium 服務端口一致）
- 啟動會話：點擊
Start Session，成功后顯示手機界面元素樹。
-
界面展示：Appium Inspector 顯示手機當前界面的 XML 結構，支持通過
resource-id、text、xpath等定位元素。 -
示例元素：
android:id/title（文本 “WebView 實現”）com.android.settings:id/card_area（卡片區域布局）
3 總結
- 通過上述步驟可完成 Appium Inspector 2025.3.1 的環境搭建與元素定位，核心流程為：環境變量配置→依賴安裝→服務啟動→設備連接。
- 該方案解決了傳統 Appium Desktop 的廢棄問題，支持 Android 和 iOS 設備的元素定位，適用于自動化測試、UI 分析等場景。實際使用中需注意版本兼容性和設備授權，確保流程順暢。
