一、组件

Appium服务器：根据Node.js，负责接收测试指令并和设备通信

客户端库：编写测试脚本的语言支持（如Java、Python、JavaScript）

设备/模拟器：运行被测应用的Android/iOS设备

二、快速配置

1. 安装基础环境

Node.js (18+)，运行Appium，node -v

JDK (11+)，Android自动化，java -version

Android SDK，提供adb等工具，通过Android Studio安装

Xcode (仅macOS)，iOS自动化，xcode-select -p

环境变量配置（Windows示例）：

ANDROID_HOME = C:\Users\你的用户名\AppData\Local\Android\Sdk

PATH 添加 %ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\tools

2. 安装Appium服务器

bash

npm install -g appium          # 安装Appium

appium driver install uiautomator2   # 安装Android驱动（Appium 2.x必需）

appium driver install xcuitest       # iOS驱动（仅macOS）

3. 启动Appium

bash

appium

# 默认监听 0.0.0.0:4723

4. 准备测试设备

Android真机：

开启「开发者选项」和「USB调试」

连接电脑，运行 adb devices 确定设备已识别

Android模拟器：

通过Android Studio AVD Manager创建

启动模拟器：emulator -avd 你的模拟器名称

iOS真机/模拟器（需macOS + Xcode）：需开发者证书，建议参考官方文档。

5. 编写测试脚本（以JavaScript + WebdriverIO为例）

创建项目并安装依赖：

bash

mkdir my-appium-test && cd my-appium-test

npm init -y

npm install --save-dev @wdio/cli

npx wdio config -y  # 使用默认配置

编辑 wdio.conf.js，修改 capabilities：

javascript

capabilities: [{

  platformName: 'Android',

  'appium:deviceName': 'emulator-5554',

  'appium:appPackage': 'com.android.settings',

  'appium:appActivity': '.Settings',

  'appium:automationName': 'UiAutomator2'

}],

services: ['appium']

创建测试文件 test/specs/example.e2e.js：

javascript

describe('Settings', () => {

  it('should open', async () => {

    await driver.pause(3000);

    const title = await $('android.widget.TextView');

    await expect(title).toHaveText('Settings');

  });

});

运行测试：

bash

npx wdio run wdio.conf.js

三、常见问题

adb devices找不到设备，检查USB调试、驱动，重新插拔

Appium会话创建失败，核对包名/Activity，检查Appium驱动是不是安装

元素定位不到，使用Appium Inspector查看元素，增加等待时间

无法运行iOS测试，保证Xcode已安装，并配置开发者证书

如果只想快速证实环境，可使用Appium Desktop（GUI工具）：

下载安装 Appium Desktop

启动服务器，配置 desired capabilities（平台、设备名、应用包名等）

点击“启动会话”，即可查看设备屏幕并交互