一、 安装前准备

1. 系统要求

• Windows 10/11（推荐）
• Node.js 12+（推荐最新LTS版本）
• Python 3.7+（可选，用于Python客户端）
• Java JDK 8+（如果需要测试Android应用）

2. 安装Node.js

1. 访问 Node.js官网
2. 下载并安装 LTS版本
3. 验证安装
   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
查看可用驱动

安装驱动

四、 安装必要组件

1. 安装Appium Inspector（用于元素定位）

方法1：使用npm安装

npm install -g appium-inspector

方法2：下载可执行文件

从 https://github.com/appium/appium-inspector/releases 下载

2. 安装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
五、 环境配置

1. 配置系统环境变量
   · 将Node.js安装目录添加到PATH
   · 如果需要，配置ANDROID_HOME（Android测试）
   需要先安装Android SDK
   方式1：通过Android Studio安装（推荐）
2. 下载并安装 Android Studio
   https://developer.android.com/studio
3. 安装过程中选择安装Android SDK
4. 默认安装路径：
   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