Appium 移动端自动化测试：一套脚本跑通 iOS 和 Android

01 Appium 的核心架构：为什么它能跨平台

理解 Appium 之前，先搞清楚一个根本问题：为什么移动端自动化比 Web 端难？

Web 端有统一的 DOM 结构，Selenium 通过 WebDriver 协议操控浏览器。但 iOS 和 Android 是两套完全不同的系统：不同的渲染引擎、不同的控件体系、不同的交互方式。

Appium 的解决方案：**不直接操控设备，而是翻译指令**。

```

你的测试脚本

↓（WebDriver 协议）

Appium Server

↓（翻译为平台原生命令）

├── iOS：XCUITest（Apple 官方测试框架）

└── Android：UiAutomator2 / Espresso（Google 官方测试框架）

```

**Before**：用 Xcode Instruments 测 iOS，用 Espresso 测 Android，两套代码，两套维护。

**After**：用 Appium 写一套脚本，Server 自动翻译为各平台的原生命令。

Appium 2.0 的架构改进：

| 特性 | Appium 1.x | Appium 2.0 |

|------|-----------|-----------|

| 驱动安装 | 内置 | 插件化，按需安装 |

| 扩展性 | 有限 | 支持自定义插件 |

| 多会话 | 麻烦 | 原生支持 |

| 维护 | 整体升级 | 驱动独立升级 |

> Appium 不是另一套测试框架，是翻译官。你用一种语言表达，它翻译成两种系统都能听懂的指令。

---

02 环境搭建：2026年最省心的配置方案

Appium 环境搭建历来是新手噩梦。Appium 2.0 大幅简化了流程。

**Android 端准备**：

```bash

# 1. 安装 JDK 17

# 2. 安装 Android SDK（通过 Android Studio）

# 3. 安装 Appium Doctor 检查环境

npm install -g appium-doctor

appium-doctor --android

```

**iOS 端准备**（需要 Mac）：

```bash

# 1. 安装 Xcode

# 2. 安装 XCUITest 驱动

appium driver install xcuitest

# 3. 检查环境

appium-doctor --ios

```

**安装 Appium 2.0 Server**：

```bash

npm install -g appium

appium driver install uiautomator2 # Android 驱动

appium driver install xcuitest # iOS 驱动

appium server # 启动服务

```

**Python 客户端安装**：

```bash

pip install Appium-Python-Client

```

**验证环境**：

```python

from appium import webdriver

# Android 配置

android_caps = {

"platformName": "Android",

"appium:deviceName": "Pixel 7",

"appium:platformVersion": "14",

"appium:automationName": "UiAutomator2",

"appium:app": "/path/to/app.apk"

}

# iOS 配置（Mac 上运行）

ios_caps = {

"platformName": "iOS",

"appium:deviceName": "iPhone 15",

"appium:platformVersion": "17.0",

"appium:automationName": "XCUITest",

"appium:app": "/path/to/app.ipa"

}

# 切换平台只需要改配置

driver = webdriver.Remote("http://127.0.0.1:4723", android_caps)

```

**Before**：搭环境花3天，报错50个，查 StackOverflow 查到崩溃。

**After**：Appium 2.0 + Appium Doctor，30分钟搞定环境，哪里有问题 Doctor 直接告诉你。

> 环境问题不值得研究。工具能自动解决的，就不要手动折腾。

---

03 元素定位：移动端与 Web 端的核心差异

Web 端用 ID、CSS Selector、XPath 定位元素。移动端的定位方式有所不同，但也有规律可循。

**移动端常用定位方式**：

| 定位方式 | 说明 | Android | iOS |

|---------|------|---------|-----|

| Accessibility ID | 无障碍标识（推荐） | content-desc | accessibility-id |

| ID | 原生资源 ID | resource-id | name |

| XPath | 路径定位 | 支持 | 支持（较慢） |

| Class Name | 控件类名 | UI 组件类 | XCUIElementType |

| iOS Predicate | iOS 专属谓词 | 不支持 | 支持 |

| iOS Class Chain | iOS 专属链式 | 不支持 | 支持 |

```python

from appium.webdriver.common.appiumby import AppiumBy

# 1. Accessibility ID（跨平台推荐）

element = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_button")

# 2. Android 专用：resource-id

element = driver.find_element(AppiumBy.ID, "com.example.app:id/username")

# 3. XPath（跨平台，但慢）

element = driver.find_element(AppiumBy.XPATH, '//android.widget.EditText[@text="用户名"]')

# 4. iOS 专用：Predicate

element = driver.find_element(AppiumBy.IOS_PREDICATE, "label == '登录' AND type == 'XCUIElementTypeButton'")

# 5. iOS 专用：Class Chain

element = driver.find_element(AppiumBy.IOS_CLASS_CHAIN, "**/XCUIElementTypeButton[`label == '登录'`]")

```

**实战建议**：

- 优先使用 Accessibility ID，双平台通用且稳定

- 让开发给关键控件加 `content-desc`（Android）和 `accessibilityIdentifier`（iOS）

- 少用 XPath，移动端 DOM 渲染慢，XPath 遍历更慢

> 移动端定位的黄金法则：让开发加标识。你省一天，他只多5分钟。

---

04 跨平台测试策略：写一次跑两次

真正的跨平台不是"一套代码硬跑两个平台"，而是**合理的抽象层设计**。

**Page Object Model（页面对象模式）**：

```python

# base_page.py - 跨平台基类

class BasePage:

def __init__(self, driver):

self.driver = driver

def find(self, locator):

return self.driver.find_element(*locator)

def click(self, locator):

self.find(locator).click()

def type_text(self, locator, text):

self.find(locator).clear()

self.find(locator).send_keys(text)

# login_page.py - 登录页（平台差异在这里处理）

class LoginPage(BasePage):

# Android 定位器

ANDROID = {

"username": (AppiumBy.ID, "com.example.app:id/username"),

"password": (AppiumBy.ID, "com.example.app:id/password"),

"login_btn": (AppiumBy.ID, "com.example.app:id/login"),

}

# iOS 定位器

IOS = {

"username": (AppiumBy.ACCESSIBILITY_ID, "username_field"),

"password": (AppiumBy.ACCESSIBILITY_ID, "password_field"),

"login_btn": (AppiumBy.ACCESSIBILITY_ID, "login_button"),

}

def __init__(self, driver, platform):

super().__init__(driver)

self.locators = self.ANDROID if platform == "android" else self.IOS

def login(self, username, password):

self.type_text(self.locators["username"], username)

self.type_text(self.locators["password"], password)

self.click(self.locators["login_btn"])

```

**测试用例**：

```python

import pytest

@pytest.fixture(params=["android", "ios"])

def login_page(request):

platform = request.param

caps = ANDROID_CAPS if platform == "android" else IOS_CAPS

driver = webdriver.Remote(SERVER_URL, caps)

yield LoginPage(driver, platform)

driver.quit()

def test_login_success(login_page):

login_page.login("testuser", "password123")

# 验证登录成功（跨平台断言）

assert is_logged_in(login_page.driver)

```

**Before**：Android 和 iOS 各写一套测试用例，改业务逻辑要改两遍。

**After**：业务逻辑写一遍，定位器分开管理。改逻辑一处搞定，改定位器互不影响。

> 跨平台测试的核心不是技术，是抽象。把"变的部分"和"不变的部分"分开，维护成本降一半。

---

05 实战避坑：Appium 最常见的6个坑

**坑1**：元素定位不到 → 用 Appium Inspector 检查元素属性

```bash

# Appium 2.0 Inspector

appium inspector

```

**坑2**：隐式等待不够导致不稳定 → 用显式等待

```python

from appium.webdriver.common.appiumby import AppiumBy

from selenium.webdriver.support.ui import WebDriverWait

from selenium.webdriver.support import expected_conditions as EC

element = WebDriverWait(driver, 10).until(

EC.presence_of_element_located((AppiumBy.ACCESSIBILITY_ID, "submit"))

)

```

**坑3**：真机连接不稳定 → 检查 adb devices / idevice list

```bash

# Android

adb devices

# iOS

xcrun xctrace list devices

```

**坑4**：键盘弹不出来 → 使用 `send_keys` 前 `click` 输入框

```python

input_field.click() # 先点击获取焦点

input_field.send_keys("文本")

```

**坑5**：上下文切换（WebView 混合应用）

```python

# 获取所有上下文

contexts = driver.contexts

# 切换到 WebView

driver.switch_to.context("WEBVIEW_com.example.app")

# 切回原生

driver.switch_to.context("NATIVE_APP")

```

**坑6**：手势操作（滑动、长按）

```python

from appium.webdriver.common.touch_action import TouchAction

# 向上滑动

TouchAction(driver).press(x=500, y=1500).move_to(x=500, y=500).release().perform()

# 长按

TouchAction(driver).long_press(element).release().perform()

```

> 每个坑踩一次就够了。记下来，下次绕过去。经验是最贵的学费。

---

Appium 2.0 让移动端自动化比以前简单了多，但核心逻辑没变：**跨平台的关键是抽象层设计，稳定性的关键是显式等待，效率的关键是让开发配合加标识**。

掌握了架构理解、环境搭建、元素定位、跨平台策略和避坑技巧，你就能用一套代码覆盖 iOS 和 Android 两个平台。

**移动端自动化不是锦上添花，是标配。用户不会因为你说"我们只测了 Android"就原谅你 iOS 上的 bug。**

声明：本站部分稿件版权来源于网络，如有侵犯版权，请及时联系我们。