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 端准备：

# 1. 安装 JDK 17

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

# 3. 安装 Appium Doctor 检查环境

npm install -g appium-doctor

appium-doctor --android

iOS 端准备（需要 Mac）：

# 1. 安装 Xcode

# 2. 安装 XCUITest 驱动

appium driver install xcuitest

# 3. 检查环境

appium-doctor --ios

安装 Appium 2.0 Server：

npm install -g appium

appium driver install uiautomator2  # Android 驱动

appium driver install xcuitest       # iOS 驱动

appium server                        # 启动服务

Python 客户端安装：

pip install Appium-Python-Client

验证环境：

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 专属链式 | 不支持 | 支持 |

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（页面对象模式）：

# 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"])

测试用例：

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 检查元素属性

# Appium 2.0 Inspector

appium inspector

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

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

# Android

adb devices



# iOS

xcrun xctrace list devices

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

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

input_field.send_keys("文本")

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

# 获取所有上下文

contexts = driver.contexts

# 切换到 WebView

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

# 切回原生

driver.switch_to.context("NATIVE_APP")

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

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。