一、 安装前准备
- 系统要求
- Windows 10/11（推荐）
- Node.js 12+（推荐最新LTS版本）
- Python 3.7+（可选，用于Python客户端）
- Java JDK 8+（如果需要测试Android应用）
- 安装Node.js
- 访问 Node.js官网
- 下载并安装 LTS版本
- 验证安装
node --version
npm --version
二、Appium安装方式
使用npm安装Appium Server
全局安装
npm install -g appium
验证安装
appium --version
三、 安装驱动程序（Drivers）
Appium 2.0+ 需要单独安装驱动程序：
1. 查看可用的驱动
appium driver list
2. 安装Windows驱动（UiAutomator2）
appium driver install uiautomator2
3. 安装iOS驱动（如果需要）
appium driver install xcuitest
4. 安装Windows应用驱动
appium driver install windows
查看可用驱动
安装驱动
四、 安装必要组件
- 安装Appium Inspector（用于元素定位）
方法1：使用npm安装
npm install -g appium-inspector
方法2：下载可执行文件
从 https://github.com/appium/appium-inspector/releases 下载
- 安装Windows应用测试相关组件
安装WinAppDriver（必须）
从 https://github.com/Microsoft/WinAppDriver/releases 下载安装
或使用Chocolatey安装
choco install winappdriver
下载后双击exe文件安装即可，默认安装路径如下：
C:\Program Files\Windows Application Driver
⚠️注意事项：
-
开发人员模式
确保已开启：
WIN+I
· 设置 → 更新与安全 → 开发者选项 → 开启"开发人员模式"
-
管理员权限
WinAppDriver需要管理员权限运行：
以管理员运行
Start-Process "C:\Program Files\Windows Application Driver\WinAppDriver.exe" -Verb RunAs
- 防火墙设置
如果遇到连接问题，需要在防火墙中允许WinAppDriver。
验证安装
启动WinAppDriver（管理员权限）
cd "C:\Program Files\Windows Application Driver"
WinAppDriver.exe
或直接运行
Start-Process "C:\Program Files\Windows Application Driver\WinAppDriver.exe"
检查WinAppDriver是否运行
检查WinAppDriver是否运行
netstat -ano | findstr :4723
应该看到类似输出
TCP 0.0.0.0:4723 0.0.0.0:0 LISTENING
🐰配置为服务（可选）
安装为Windows服务
sc.exe create WinAppDriver binPath= "C:\Program Files\Windows Application Driver\WinAppDriver.exe" start= auto
启动服务
sc.exe start WinAppDriver
停止服务
sc.exe stop WinAppDriver
五、 环境配置
- 配置系统环境变量
· 将Node.js安装目录添加到PATH
· 如果需要，配置ANDROID_HOME（Android测试）
需要先安装Android SDK
方式1：通过Android Studio安装（推荐） - 下载并安装 Android Studio
https://developer.android.com/studio - 安装过程中选择安装Android SDK
- 默认安装路径：
C:\Users<用户名>\AppData\Local\Android\Sdk
方式2：单独安装Android SDK
使用命令行工具（需要Java）
sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.0"
配置用户变量
- 变量名: ANDROID_HOME
- 变量值: C:\Users<用户名>\AppData\Local\Android\Sdk
编辑path变量
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%ANDROID_HOME%\tools\bin
%ANDROID_HOME%\emulator
六、验证安装
安装WebDriver客户端（Python示例）
pip install Appium-Python-Client selenium
如果上面的安装不成功，可以考虑手动安装
1.下载包
https://pypi.org/project/Appium-Python-Client/
https://pypi.org/project/selenium/
2.手动安装
下载后，本地安装
pip install D:\software\appium_python_client-5.2.4-py3-none-any.whl
pip install .\selenium-4.25.0-py3-none-any.whl
验证版本
appium --version
