2025 最新 Appium Inspector 环境搭建教程

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 分析等场景。实际使用中需注意版本兼容性和设备授权，确保流程顺畅。