App 自动化到底怎么选我踩了三年的坑全在这了我跟你讲App 自动化的复杂度比 Web 高一个量级。环境搭建能劝退一半人用例稳定性能劝退剩下的一半。但选对工具和策略这条路能走通。一、App 自动化的尴尬现实先说一个真事。我第一次搭 Appium 环境满打满算搞了两天。第一天装 Node.js Appium Server Android SDK 模拟器——每一步都踩了坑最后 Appium Server 是跑起来了但连不上模拟器。第二天翻了一堆 GitHub Issue发现是ANDROID_HOME路径里多了个空格。这就是 App 自动化的真实状态它能做的事比 Web 自动化多但坑也比 Web 自动化多得多。多在哪设备碎片化你 Web 测 3 个浏览器App 要测 Android 13/14/15 各品牌定制系统 iOS 17/18排列组合几十种。系统权限Web 无所谓App 要弹相机权限、位置权限、通知权限——每个弹窗都可能卡住你的脚本。WebViewApp 里内嵌的网页定位方式跟原生控件完全不一样你得做上下文切换。真机 vs 模拟器模拟器快但有些场景不准真机准但贵且慢。iOS 签名苹果的证书体系能把新手折磨到怀疑人生。所以在你决定搞 App 自动化之前先问自己一个问题你真的需要 App 自动化吗如果你的 App 大部分逻辑是 H5 页面套壳的——直接用 Web 自动化测 H5 页面比 App 自动化省十倍力气。如果你的 App 是重度原生交互相机/蓝牙/地图/硬件调用——那下面这些内容就是为你写的。二、App 自动化工具全景图市面上的 App 自动化工具按出身分大概是这么个格局App 自动化工具 ├── 跨平台选手Android iOS │ ├── Appium — 跨平台扛把子基于 WebDriver 协议 │ ├── Airtest — 网易出品截图对比 图像识别 │ └── Maestro — 新秀选手YAML 写脚本 │ ├── Android 专项 │ ├── UIAutomator2 — Google 原生框架Appium 的 Android 驱动就是它 │ ├── Espresso — Google 的白盒框架需要源码 │ └── SoloPi — 阿里出品录制回放 │ ├── iOS 专项 │ ├── XCUITest — Apple 原生框架Appium 的 iOS 驱动就是它 │ └── WebDriverAgent — Facebook 出品Appium 在 iOS 上的底层代理 │ └── 性能专项 ├── PerfDog — 腾讯出品移动端性能监控 └── GT腾讯GT — 老牌性能工具这张图里我只挑几个有实战价值的拆。那些只见于论文和 PPT 的工具我就不列了。三、横向对比几个核心选手拆开了看3.1 Appium优点真·跨平台。Android iOS 用同一套 API。你写一套登录脚本Android 上跑完 iOS 上接着跑。不需要源码。你不需要 App 的开发权限给个 APK/IPA 就能测。这是它跟 Espresso/XCUITest 最本质的区别。多语言支持Python / Java / JS / Ruby / C#。有 Selenium 基础的话Appium 上手很快——它的 API 就是 WebDriver 协议的移动端扩展。社区最大。Appium 的 GitHub Issue、Stack Overflow 帖子、中文博客数量远超其他移动端工具。你踩的坑大概率有人踩过。缺点慢。你的指令要经过 Python 客户端 → Appium Server → 平台驱动 → 手机每个环节都有延迟。一个点击可能要 500ms-1s。环境搭建复杂。不像 Selenium 现在一行pip install搞定Appium 除了 Python 客户端还要装 Node.js Appium Server 平台驱动 Android SDK 或 Xcode。每一步都可能卡住。调试困难。脚本挂了之后你想定位是因为元素没找到还是网络超时还是手机卡了——三种可能排查成本高。Appium 3 破坏性变更多下面会细讲。我的评价如果你只能学一个 App 自动化工具学 Appium。不是因为它最好用是因为它最通用。你换公司、换项目、换平台Appium 都还在。3.2 Airtest网易优点入门门槛极低。录制回放 截图对比不写代码也能跑通。图像识别定位。不用管什么元素树、Accessibility ID截一张「登录按钮」的图脚本自动在屏幕上找。对游戏测试特别友好——游戏界面没有原生控件传统定位方式全部失效图片识别是唯一解法。IDE 比较成熟。AirtestIDE 能做录制、回放、报告生成一条龙。缺点图像识别的坑。分辨率一变按钮位置变了截图就匹不上了。你换一台不同分辨率的手机脚本全炸。复杂逻辑不行。录制的脚本很难做条件判断和循环。你想做成「如果有弹窗就关闭弹窗然后继续往下走」——Airtest 搞不定。跨语言开发能力弱。脚本是它的私有格式想在 pytest 框架里集成很难。iOS 支持拉胯。大部分功能是围绕 Android 设计的。我在一个小项目里用过半年 Airtest说实话前两周很爽录制跑通全流程只要半天。第三周需求改了UI 布局变了——我重录了 80% 的脚本。第五周又改了我放弃了换了 Appium。3.3 EspressoGoogle优点快。Google 亲儿子直接运行在 App 进程里没有网络通信开销。一个点击操作几乎是同步完成。稳定。因为是白盒测试可以直接访问 App 的内部状态不需要等 UI 渲染。Android 官方支持。和 Android Studio 深度集成Android 开发者学起来成本低。缺点必须有源码。如果你是第三方测试团队或者外包测试手上只有一个 APKEspresso 与你无关。Java/Kotlin only。你的团队如果是 Python 技术栈别想了。跨 App 测试很痛苦。你想测「从你的 App 跳转到系统相机拍照再回来」Espresso 跨进程操作很别扭。仅限 Android。我的评价如果你是 Android 开发团队并且在做单元/集成级别的自动化Espresso 是最佳选择。但如果你是一个独立的测试团队、没有源码、需要跨平台——它不适合你。3.4 XCUITestApple跟 Espresso 一毛一样的定位只不过是 iOS 端的。优点Apple 亲儿子稳定快。缺点必须有源码、Swift/ObjC only、仅限 iOS、跨 App 测试麻烦。不展开说了理由同上。适合 iOS 开发团队做白盒测试不适合独立的测试团队。3.5 UIAutomator2Google / Appium 底层驱动UIAutomator2 是 Google 的 Android 原生自动化框架。你如果用过 Appium 跑 Android底层就是它。单独用 UIAutomator2 的场景很有限——因为它本质上是 Appium 的一个驱动你没有 Appium Server 这层封装的话它提供的 API 非常底层写起来很痛苦。大部分情况下你不用纠结 UIAutomator2 怎么用——你用的是 Appium底层自动调它。3.6 Maestro2023 年冒出来的新选手画风和其他工具完全不同。优点不用写代码。写 YAML 配置文件描述操作流程像写 Docker Compose-tapOn:用户名-inputText:admin-tapOn:登录-assertVisible:首页环境搭建极简。一个二进制文件装完就能跑。执行速度快比 Appium 轻量得多。缺点复杂逻辑吃力。你让 Maestro 做个「循环输入 50 组数据」——不是不能但比写 Python 麻烦。iOS 支持有限。大部分精力在 Android。生态还小。社区、插件、第三方集成远不如 Appium。不适合大规模用例维护。当你有 500 个 YAML 文件的时候你会怀念 Python 的代码复用能力。我的评价如果你只需要做简单的回归冒烟测试并且不想写代码——Maestro 是个好选择。但如果你的自动化需要条件判断、循环、数据驱动——到头来还得写代码。总结对比工具跨平台不需源码编程语言稳定性社区录制回放执行速度适合谁Appium★★★★★★★★★★★★★★★★★★★★★★★★★★★★★全能选手Airtest★★★★★★★★★★★★★★★★★★★★★★★★★游戏测试、快速录制Espresso★★★★★★★★★★★★★★★★★★★★Android 白盒XCUITest★★★★★★★★★★★★★★★★★★★★iOS 白盒Maestro★★★★★★★★—★★★★★★—★★★★简单回归打星的时候我在 Appium 的稳定性上打了个 3 星。不是 Appium 本身不稳是它的「链路太长」导致不稳定因素多。手机卡了、WiFi 断了、adb 掉了、Server 崩了——任何一个环节出问题都会导致脚本失败而且报错信息经常看不出是谁的锅。四、Appium 到底怎么工作的——三句话讲清原理Appium 的原理比 Selenium 多一层中转但对学过 Selenium 的人来说很好理解你的 Python 脚本 → 发 HTTP 请求给 Appium ServerNode.js 服务 → Server 把指令翻译给平台驱动Android 用 UiAutomator2iOS 用 XCUITest→ 驱动在手机里执行操作 → 结果原路返回。跟 Selenium 对比看更清楚Web 自动化 你的代码 → 浏览器驱动 → 浏览器 App 自动化 你的代码 → Appium Server → 平台驱动 → 手机Web 自动化你少了一个中间层。App 自动化多了一个 Appium Server代价是速度好处是Server 层屏蔽了 Android/iOS 的差异。你用同一套 API 写脚本Server 负责把它翻译成平台能懂的指令。Server 层可以运行在任何机器上。你的脚本在 A 电脑Appium Server 在 B 电脑手机插在 C 电脑——可以的。这就是后面做分布式执行的基础。另外 Appium 完全继承了 WebDriver 协议。find_element、click、send_keys、WebDriverWait——这些你在 Selenium 里学过的 API在 Appium 里照用不误。名字一样参数一样用法一样。这也是为什么我建议先学 Selenium 再学 Appium你的 Selenium 技能在 Appium 里是直接可迁移的。五、十分钟搭环境你能跑通的第一条路我直接告诉你搭 Appium 环境大概是整个学习过程中最难的一步。Web 自动化你一行pip install selenium就搞定了App 自动化至少要装四五样东西。下面是最短路径。我不是奢望你看完就能配通——我让你知道要面对什么、最卡在哪一步。第 1 步装 Node.js# Windows 用户去 nodejs.org 下安装包# Mac 用户 brew install node22# 装完检查node-v# 必须 ≥ 20.19.0Appium 3 硬性要求低了直接报错npm-v# 必须 ≥ 10最容易卡在哪Node.js 版本太低。特别是公司电脑系统管理员装的 Node 可能是两年前的版本。Appium 2 要求 Node 14Appium 3 直接跳到 20.19。你网上搜到的教程如果让你装 Node 14 或 16那个教程已经过时了。第 2 步装 Appium Servernpminstall-gappium# 装完检查appium-v# 当前最新3.5.x一行搞定。但你还没装驱动所以现在跑appium只能启动 Server干不了活。第 3 步装平台驱动# Android装 UiAutomator2 驱动appium driverinstalluiautomator2# iOS装 XCUITest 驱动需要 Mac Xcodeappium driverinstallxcuitest# 查看已安装的驱动appium driver listAppium 3 的重大变化Server 内核不再自带驱动。以前 Appium 2 你装完 ServerAndroid 和 iOS 驱动是内置的。现在你必须手动装。这步漏了的话跑脚本的时候报「找不到驱动」你会一脸懵。第 4 步可选但推荐装 Inspector 插件appium plugininstallinspectorAppium 3 把 Inspector 内置成插件了。之前你得单独下载 Appium Inspector 桌面版现在从 Server 端就能启动。启动之后浏览器打开http://localhost:4723/inspector就能用图形界面看 App 的元素树不用写代码去找元素。第 5 步装 Android SDKAndroid 必须iOS 跳过最快方式装 Android Studio它会自动装好 SDK 模拟器或者单独装 Command Line Tools装完配环境变量Windows 举例ANDROID_HOME C:\Users\你的用户名\AppData\Local\Android\Sdk PATH 里加上 %ANDROID_HOME%\platform-tools最容易卡在哪环境变量配错了。ANDROID_HOME路径里不能有空格platform-tools路径拼错、权限不够。这步卡住太正常了不是你笨是 Android 开发环境本来就这么折腾。第 6 步装 Python 客户端pipinstallAppium-Python-Client环境验证脚本全部装完之后跑这个验证fromappiumimportwebdriverfromappium.options.androidimportUiAutomator2Options optionsUiAutomator2Options()options.platform_nameAndroidoptions.device_nameemulator-5554# 模拟器设备名options.app_packagecom.android.settings# 系统设置options.app_activity.Settingsdriverwebdriver.Remote(http://localhost:4723,optionsoptions)print(✅ Appium 环境配置成功)driver.quit()如果你看到那条绿字恭喜最难的一步过去了。六、一个完整自动化用例长什么样跟 Selenium 那篇的登录用例对比着看你会发现在 Appium 里写用例写法和 Selenium 几乎一模一样fromappiumimportwebdriverfromappium.options.androidimportUiAutomator2Optionsfromappium.webdriver.common.appiumbyimportAppiumByfromselenium.webdriver.support.uiimportWebDriverWaitfromselenium.webdriver.supportimportexpected_conditionsasEC# 1. 配置手机和目标 AppoptionsUiAutomator2Options()options.platform_nameAndroidoptions.device_nameemulator-5554options.app_packagecom.example.app# App 包名options.app_activity.MainActivity# 首页 Activity# 2. 连接 Appium Server默认端口 4723driverwebdriver.Remote(http://localhost:4723,optionsoptions)# 3. 找到用户名输入框输入driver.find_element(AppiumBy.ID,com.example.app:id/username).send_keys(admin)# 4. 找到密码输入框输入driver.find_element(AppiumBy.ID,com.example.app:id/password).send_keys(Test123)# 5. 找到登录按钮点击driver.find_element(AppiumBy.ID,com.example.app:id/login_btn).click()# 6. 等首页加载出来WebDriverWait(driver,10).until(EC.presence_of_element_located((AppiumBy.ID,com.example.app:id/home_title)))# 7. 断言首页标题可见assertdriver.find_element(AppiumBy.ID,com.example.app:id/home_title).is_displayed()print(✅ 登录成功)# 8. 关掉连接driver.quit()跟 Selenium 的区别在哪就三处启动方式不同Selenium 是webdriver.Chrome()直接起浏览器Appium 是webdriver.Remote()连到一个远程 Server。使用AppiumBy而不是By因为 App 里的 ID 格式是com.example.app:id/username包名全路径比 Web 的简单id或name复杂。多了一个 App 包名和 Activity 的配置告诉 Appium 你要打开哪个 App。其余的东西——find_element、send_keys、click、WebDriverWait、assert——跟你在 Selenium 里学的完全一样。这就是 WebDriver 协议的力量一套 API 通吃 Web 和 App。七、为什么这个系列教 Appium如果说 Web 自动化还有 Selenium 和 Playwright 可以争一争那 App 自动化——说实话Appium 几乎没有真正的对手。1. 跨平台。这不是加分项是及格线。你的 App 大概率要同时维护 Android 和 iOS 两个端。你用 Espresso XCUITest两套代码、两拨人、两个仓库。用 Appium一套代码。就这一条理由对大多数团队来说已经够了。2. 不需要源码。这是 Appium 和 Espresso/XCUITest 最本质的差异。如果你是个独立的测试团队手上只有 APK 和 IPA你选不了 Espresso 和 XCUITest。3. 生态和社区碾压级的。GitHub Star 18kStack Overflow 上 16000 问题你碰到的 80% 的问题有人碰到过、有人解决过。但 Appium 也有不擅长的事游戏测试。就算加上图像识别的插件Appium 做游戏自动化也很勉强。游戏自动化用 Airtest 更合适。白盒级别的单元测试。Appium 测的是 UI 层不是代码层。如果你的需求是「测一下这个 ViewModel 的返回值对不对」——用 Espresso/XCUITest。对速度有极端要求的场景。比如你要在 100 台设备上并发跑回归——Appium 的链路延迟会拖后腿。但话说回来——大部分 App 自动化需求就是 UI 层的业务流程验证。而这恰好是 Appium 最擅长的。八、Appium 3 在 2026 年的状态Appium 3 不是一个温和的升级。如果你之前用的是 Appium 2或者你看的教程是 Appium 2 写的——下面这些变化你必须知道。五个劝退级别的破坏性变更1. Node.js 必须 ≥ 20.19.0。低了直接报错没有任何警告。公司电脑里装的是 Node 14 或 16 的话第一步就得升级。2. 驱动不再内置。Appium 3 的 Server 内核和驱动完全解耦。appium driver install uiautomator2不是可选项是必选项。3. JSON Wire Protocol 彻底死了。Appium 2 时代你还能用旧的desiredCapabilities写法Appium 3 只认 W3C 标准格式。现在的正确写法是options UiAutomator2Options()然后用属性设置不是用一个 dict。4. 安全标志必须指定驱动范围。以前--allow-insecureadb_shell就行现在必须写--allow-insecureuiautomator2:adb_shell。不指定范围的写法直接导致 Server 启动崩溃。5. 超时参数格式变了。POST /session/:id/timeouts只接受script、pageLoad、implicit三个字段旧的type和ms字段不再支持。升级建议如果你已经有一套 Appium 2 的脚本不建议原地升级 Appium 3。我建议先在一台测试机上升级 Node.js 到 20.19装 Appium 3 新驱动跑一遍你的核心用例看哪些挂了排查完所有兼容性问题再全量推直接生产环境原地升级的后果——我经历过一次CI 挂了修了一天。九、这个系列你能学到什么这个系列同样是「一个痛点一章课」的结构从搭环境到搭框架每个阶段解决一个你会真实碰到的问题。章节解决什么痛点你会掌握总篇本篇「不知道该不该做 App 自动化、不知道用什么工具」全景选型第 0 章「Appium 环境搭建搞了两天没跑通」Node.js Appium 3 驱动 SDK 全链路第 1 章「连上了手机但不知道怎么操作」最小链路 元素定位方式速览第 2 章「元素定位老失败ID 又长又臭」Accessibility ID / ID / XPath / UIAutomator 定位深度拆解第 3 章「只会点按钮输文字滑动不会写」基础操作 W3C Actions API第 4 章「App 比 Web 慢太多用例老超时」等待策略 Toast 处理 网络等待第 5 章「遇到 H5 页面就懵了」Native ↔ WebView 上下文切换第 6 章「只会写单个步骤不会写完整业务流程」登录 → 下单全链路实战第 7 章「几十个用例全是复制粘贴」App 端 Page Object 设计第 8 章「不知道怎么把脚本变成正经测试框架」pytest Appium 集成 多设备并行第 9 章「Appium 2 的脚本升级 Appium 3 全炸了」Appium 3 迁移指南第 10 章「想让 AI 帮我写但不知道怎么配合」AI Appium Inspector 组合工作流下一篇《Appium 3 环境搭建避坑指南》——Node.js 版本、驱动安装、安全标志2026 年搭 Appium 环境的正确姿势。
App 自动化到底怎么选我踩了三年的坑全在这了我跟你讲App 自动化的复杂度比 Web 高一个量级。环境搭建能劝退一半人用例稳定性能劝退剩下的一半。但选对工具和策略这条路能走通。一、App 自动化的尴尬现实先说一个真事。我第一次搭 Appium 环境满打满算搞了两天。第一天装 Node.js Appium Server Android SDK 模拟器——每一步都踩了坑最后 Appium Server 是跑起来了但连不上模拟器。第二天翻了一堆 GitHub Issue发现是ANDROID_HOME路径里多了个空格。这就是 App 自动化的真实状态它能做的事比 Web 自动化多但坑也比 Web 自动化多得多。多在哪设备碎片化你 Web 测 3 个浏览器App 要测 Android 13/14/15 各品牌定制系统 iOS 17/18排列组合几十种。系统权限Web 无所谓App 要弹相机权限、位置权限、通知权限——每个弹窗都可能卡住你的脚本。WebViewApp 里内嵌的网页定位方式跟原生控件完全不一样你得做上下文切换。真机 vs 模拟器模拟器快但有些场景不准真机准但贵且慢。iOS 签名苹果的证书体系能把新手折磨到怀疑人生。所以在你决定搞 App 自动化之前先问自己一个问题你真的需要 App 自动化吗如果你的 App 大部分逻辑是 H5 页面套壳的——直接用 Web 自动化测 H5 页面比 App 自动化省十倍力气。如果你的 App 是重度原生交互相机/蓝牙/地图/硬件调用——那下面这些内容就是为你写的。二、App 自动化工具全景图市面上的 App 自动化工具按出身分大概是这么个格局App 自动化工具 ├── 跨平台选手Android iOS │ ├── Appium — 跨平台扛把子基于 WebDriver 协议 │ ├── Airtest — 网易出品截图对比 图像识别 │ └── Maestro — 新秀选手YAML 写脚本 │ ├── Android 专项 │ ├── UIAutomator2 — Google 原生框架Appium 的 Android 驱动就是它 │ ├── Espresso — Google 的白盒框架需要源码 │ └── SoloPi — 阿里出品录制回放 │ ├── iOS 专项 │ ├── XCUITest — Apple 原生框架Appium 的 iOS 驱动就是它 │ └── WebDriverAgent — Facebook 出品Appium 在 iOS 上的底层代理 │ └── 性能专项 ├── PerfDog — 腾讯出品移动端性能监控 └── GT腾讯GT — 老牌性能工具这张图里我只挑几个有实战价值的拆。那些只见于论文和 PPT 的工具我就不列了。三、横向对比几个核心选手拆开了看3.1 Appium优点真·跨平台。Android iOS 用同一套 API。你写一套登录脚本Android 上跑完 iOS 上接着跑。不需要源码。你不需要 App 的开发权限给个 APK/IPA 就能测。这是它跟 Espresso/XCUITest 最本质的区别。多语言支持Python / Java / JS / Ruby / C#。有 Selenium 基础的话Appium 上手很快——它的 API 就是 WebDriver 协议的移动端扩展。社区最大。Appium 的 GitHub Issue、Stack Overflow 帖子、中文博客数量远超其他移动端工具。你踩的坑大概率有人踩过。缺点慢。你的指令要经过 Python 客户端 → Appium Server → 平台驱动 → 手机每个环节都有延迟。一个点击可能要 500ms-1s。环境搭建复杂。不像 Selenium 现在一行pip install搞定Appium 除了 Python 客户端还要装 Node.js Appium Server 平台驱动 Android SDK 或 Xcode。每一步都可能卡住。调试困难。脚本挂了之后你想定位是因为元素没找到还是网络超时还是手机卡了——三种可能排查成本高。Appium 3 破坏性变更多下面会细讲。我的评价如果你只能学一个 App 自动化工具学 Appium。不是因为它最好用是因为它最通用。你换公司、换项目、换平台Appium 都还在。3.2 Airtest网易优点入门门槛极低。录制回放 截图对比不写代码也能跑通。图像识别定位。不用管什么元素树、Accessibility ID截一张「登录按钮」的图脚本自动在屏幕上找。对游戏测试特别友好——游戏界面没有原生控件传统定位方式全部失效图片识别是唯一解法。IDE 比较成熟。AirtestIDE 能做录制、回放、报告生成一条龙。缺点图像识别的坑。分辨率一变按钮位置变了截图就匹不上了。你换一台不同分辨率的手机脚本全炸。复杂逻辑不行。录制的脚本很难做条件判断和循环。你想做成「如果有弹窗就关闭弹窗然后继续往下走」——Airtest 搞不定。跨语言开发能力弱。脚本是它的私有格式想在 pytest 框架里集成很难。iOS 支持拉胯。大部分功能是围绕 Android 设计的。我在一个小项目里用过半年 Airtest说实话前两周很爽录制跑通全流程只要半天。第三周需求改了UI 布局变了——我重录了 80% 的脚本。第五周又改了我放弃了换了 Appium。3.3 EspressoGoogle优点快。Google 亲儿子直接运行在 App 进程里没有网络通信开销。一个点击操作几乎是同步完成。稳定。因为是白盒测试可以直接访问 App 的内部状态不需要等 UI 渲染。Android 官方支持。和 Android Studio 深度集成Android 开发者学起来成本低。缺点必须有源码。如果你是第三方测试团队或者外包测试手上只有一个 APKEspresso 与你无关。Java/Kotlin only。你的团队如果是 Python 技术栈别想了。跨 App 测试很痛苦。你想测「从你的 App 跳转到系统相机拍照再回来」Espresso 跨进程操作很别扭。仅限 Android。我的评价如果你是 Android 开发团队并且在做单元/集成级别的自动化Espresso 是最佳选择。但如果你是一个独立的测试团队、没有源码、需要跨平台——它不适合你。3.4 XCUITestApple跟 Espresso 一毛一样的定位只不过是 iOS 端的。优点Apple 亲儿子稳定快。缺点必须有源码、Swift/ObjC only、仅限 iOS、跨 App 测试麻烦。不展开说了理由同上。适合 iOS 开发团队做白盒测试不适合独立的测试团队。3.5 UIAutomator2Google / Appium 底层驱动UIAutomator2 是 Google 的 Android 原生自动化框架。你如果用过 Appium 跑 Android底层就是它。单独用 UIAutomator2 的场景很有限——因为它本质上是 Appium 的一个驱动你没有 Appium Server 这层封装的话它提供的 API 非常底层写起来很痛苦。大部分情况下你不用纠结 UIAutomator2 怎么用——你用的是 Appium底层自动调它。3.6 Maestro2023 年冒出来的新选手画风和其他工具完全不同。优点不用写代码。写 YAML 配置文件描述操作流程像写 Docker Compose-tapOn:用户名-inputText:admin-tapOn:登录-assertVisible:首页环境搭建极简。一个二进制文件装完就能跑。执行速度快比 Appium 轻量得多。缺点复杂逻辑吃力。你让 Maestro 做个「循环输入 50 组数据」——不是不能但比写 Python 麻烦。iOS 支持有限。大部分精力在 Android。生态还小。社区、插件、第三方集成远不如 Appium。不适合大规模用例维护。当你有 500 个 YAML 文件的时候你会怀念 Python 的代码复用能力。我的评价如果你只需要做简单的回归冒烟测试并且不想写代码——Maestro 是个好选择。但如果你的自动化需要条件判断、循环、数据驱动——到头来还得写代码。总结对比工具跨平台不需源码编程语言稳定性社区录制回放执行速度适合谁Appium★★★★★★★★★★★★★★★★★★★★★★★★★★★★★全能选手Airtest★★★★★★★★★★★★★★★★★★★★★★★★★游戏测试、快速录制Espresso★★★★★★★★★★★★★★★★★★★★Android 白盒XCUITest★★★★★★★★★★★★★★★★★★★★iOS 白盒Maestro★★★★★★★★—★★★★★★—★★★★简单回归打星的时候我在 Appium 的稳定性上打了个 3 星。不是 Appium 本身不稳是它的「链路太长」导致不稳定因素多。手机卡了、WiFi 断了、adb 掉了、Server 崩了——任何一个环节出问题都会导致脚本失败而且报错信息经常看不出是谁的锅。四、Appium 到底怎么工作的——三句话讲清原理Appium 的原理比 Selenium 多一层中转但对学过 Selenium 的人来说很好理解你的 Python 脚本 → 发 HTTP 请求给 Appium ServerNode.js 服务 → Server 把指令翻译给平台驱动Android 用 UiAutomator2iOS 用 XCUITest→ 驱动在手机里执行操作 → 结果原路返回。跟 Selenium 对比看更清楚Web 自动化 你的代码 → 浏览器驱动 → 浏览器 App 自动化 你的代码 → Appium Server → 平台驱动 → 手机Web 自动化你少了一个中间层。App 自动化多了一个 Appium Server代价是速度好处是Server 层屏蔽了 Android/iOS 的差异。你用同一套 API 写脚本Server 负责把它翻译成平台能懂的指令。Server 层可以运行在任何机器上。你的脚本在 A 电脑Appium Server 在 B 电脑手机插在 C 电脑——可以的。这就是后面做分布式执行的基础。另外 Appium 完全继承了 WebDriver 协议。find_element、click、send_keys、WebDriverWait——这些你在 Selenium 里学过的 API在 Appium 里照用不误。名字一样参数一样用法一样。这也是为什么我建议先学 Selenium 再学 Appium你的 Selenium 技能在 Appium 里是直接可迁移的。五、十分钟搭环境你能跑通的第一条路我直接告诉你搭 Appium 环境大概是整个学习过程中最难的一步。Web 自动化你一行pip install selenium就搞定了App 自动化至少要装四五样东西。下面是最短路径。我不是奢望你看完就能配通——我让你知道要面对什么、最卡在哪一步。第 1 步装 Node.js# Windows 用户去 nodejs.org 下安装包# Mac 用户 brew install node22# 装完检查node-v# 必须 ≥ 20.19.0Appium 3 硬性要求低了直接报错npm-v# 必须 ≥ 10最容易卡在哪Node.js 版本太低。特别是公司电脑系统管理员装的 Node 可能是两年前的版本。Appium 2 要求 Node 14Appium 3 直接跳到 20.19。你网上搜到的教程如果让你装 Node 14 或 16那个教程已经过时了。第 2 步装 Appium Servernpminstall-gappium# 装完检查appium-v# 当前最新3.5.x一行搞定。但你还没装驱动所以现在跑appium只能启动 Server干不了活。第 3 步装平台驱动# Android装 UiAutomator2 驱动appium driverinstalluiautomator2# iOS装 XCUITest 驱动需要 Mac Xcodeappium driverinstallxcuitest# 查看已安装的驱动appium driver listAppium 3 的重大变化Server 内核不再自带驱动。以前 Appium 2 你装完 ServerAndroid 和 iOS 驱动是内置的。现在你必须手动装。这步漏了的话跑脚本的时候报「找不到驱动」你会一脸懵。第 4 步可选但推荐装 Inspector 插件appium plugininstallinspectorAppium 3 把 Inspector 内置成插件了。之前你得单独下载 Appium Inspector 桌面版现在从 Server 端就能启动。启动之后浏览器打开http://localhost:4723/inspector就能用图形界面看 App 的元素树不用写代码去找元素。第 5 步装 Android SDKAndroid 必须iOS 跳过最快方式装 Android Studio它会自动装好 SDK 模拟器或者单独装 Command Line Tools装完配环境变量Windows 举例ANDROID_HOME C:\Users\你的用户名\AppData\Local\Android\Sdk PATH 里加上 %ANDROID_HOME%\platform-tools最容易卡在哪环境变量配错了。ANDROID_HOME路径里不能有空格platform-tools路径拼错、权限不够。这步卡住太正常了不是你笨是 Android 开发环境本来就这么折腾。第 6 步装 Python 客户端pipinstallAppium-Python-Client环境验证脚本全部装完之后跑这个验证fromappiumimportwebdriverfromappium.options.androidimportUiAutomator2Options optionsUiAutomator2Options()options.platform_nameAndroidoptions.device_nameemulator-5554# 模拟器设备名options.app_packagecom.android.settings# 系统设置options.app_activity.Settingsdriverwebdriver.Remote(http://localhost:4723,optionsoptions)print(✅ Appium 环境配置成功)driver.quit()如果你看到那条绿字恭喜最难的一步过去了。六、一个完整自动化用例长什么样跟 Selenium 那篇的登录用例对比着看你会发现在 Appium 里写用例写法和 Selenium 几乎一模一样fromappiumimportwebdriverfromappium.options.androidimportUiAutomator2Optionsfromappium.webdriver.common.appiumbyimportAppiumByfromselenium.webdriver.support.uiimportWebDriverWaitfromselenium.webdriver.supportimportexpected_conditionsasEC# 1. 配置手机和目标 AppoptionsUiAutomator2Options()options.platform_nameAndroidoptions.device_nameemulator-5554options.app_packagecom.example.app# App 包名options.app_activity.MainActivity# 首页 Activity# 2. 连接 Appium Server默认端口 4723driverwebdriver.Remote(http://localhost:4723,optionsoptions)# 3. 找到用户名输入框输入driver.find_element(AppiumBy.ID,com.example.app:id/username).send_keys(admin)# 4. 找到密码输入框输入driver.find_element(AppiumBy.ID,com.example.app:id/password).send_keys(Test123)# 5. 找到登录按钮点击driver.find_element(AppiumBy.ID,com.example.app:id/login_btn).click()# 6. 等首页加载出来WebDriverWait(driver,10).until(EC.presence_of_element_located((AppiumBy.ID,com.example.app:id/home_title)))# 7. 断言首页标题可见assertdriver.find_element(AppiumBy.ID,com.example.app:id/home_title).is_displayed()print(✅ 登录成功)# 8. 关掉连接driver.quit()跟 Selenium 的区别在哪就三处启动方式不同Selenium 是webdriver.Chrome()直接起浏览器Appium 是webdriver.Remote()连到一个远程 Server。使用AppiumBy而不是By因为 App 里的 ID 格式是com.example.app:id/username包名全路径比 Web 的简单id或name复杂。多了一个 App 包名和 Activity 的配置告诉 Appium 你要打开哪个 App。其余的东西——find_element、send_keys、click、WebDriverWait、assert——跟你在 Selenium 里学的完全一样。这就是 WebDriver 协议的力量一套 API 通吃 Web 和 App。七、为什么这个系列教 Appium如果说 Web 自动化还有 Selenium 和 Playwright 可以争一争那 App 自动化——说实话Appium 几乎没有真正的对手。1. 跨平台。这不是加分项是及格线。你的 App 大概率要同时维护 Android 和 iOS 两个端。你用 Espresso XCUITest两套代码、两拨人、两个仓库。用 Appium一套代码。就这一条理由对大多数团队来说已经够了。2. 不需要源码。这是 Appium 和 Espresso/XCUITest 最本质的差异。如果你是个独立的测试团队手上只有 APK 和 IPA你选不了 Espresso 和 XCUITest。3. 生态和社区碾压级的。GitHub Star 18kStack Overflow 上 16000 问题你碰到的 80% 的问题有人碰到过、有人解决过。但 Appium 也有不擅长的事游戏测试。就算加上图像识别的插件Appium 做游戏自动化也很勉强。游戏自动化用 Airtest 更合适。白盒级别的单元测试。Appium 测的是 UI 层不是代码层。如果你的需求是「测一下这个 ViewModel 的返回值对不对」——用 Espresso/XCUITest。对速度有极端要求的场景。比如你要在 100 台设备上并发跑回归——Appium 的链路延迟会拖后腿。但话说回来——大部分 App 自动化需求就是 UI 层的业务流程验证。而这恰好是 Appium 最擅长的。八、Appium 3 在 2026 年的状态Appium 3 不是一个温和的升级。如果你之前用的是 Appium 2或者你看的教程是 Appium 2 写的——下面这些变化你必须知道。五个劝退级别的破坏性变更1. Node.js 必须 ≥ 20.19.0。低了直接报错没有任何警告。公司电脑里装的是 Node 14 或 16 的话第一步就得升级。2. 驱动不再内置。Appium 3 的 Server 内核和驱动完全解耦。appium driver install uiautomator2不是可选项是必选项。3. JSON Wire Protocol 彻底死了。Appium 2 时代你还能用旧的desiredCapabilities写法Appium 3 只认 W3C 标准格式。现在的正确写法是options UiAutomator2Options()然后用属性设置不是用一个 dict。4. 安全标志必须指定驱动范围。以前--allow-insecureadb_shell就行现在必须写--allow-insecureuiautomator2:adb_shell。不指定范围的写法直接导致 Server 启动崩溃。5. 超时参数格式变了。POST /session/:id/timeouts只接受script、pageLoad、implicit三个字段旧的type和ms字段不再支持。升级建议如果你已经有一套 Appium 2 的脚本不建议原地升级 Appium 3。我建议先在一台测试机上升级 Node.js 到 20.19装 Appium 3 新驱动跑一遍你的核心用例看哪些挂了排查完所有兼容性问题再全量推直接生产环境原地升级的后果——我经历过一次CI 挂了修了一天。九、这个系列你能学到什么这个系列同样是「一个痛点一章课」的结构从搭环境到搭框架每个阶段解决一个你会真实碰到的问题。章节解决什么痛点你会掌握总篇本篇「不知道该不该做 App 自动化、不知道用什么工具」全景选型第 0 章「Appium 环境搭建搞了两天没跑通」Node.js Appium 3 驱动 SDK 全链路第 1 章「连上了手机但不知道怎么操作」最小链路 元素定位方式速览第 2 章「元素定位老失败ID 又长又臭」Accessibility ID / ID / XPath / UIAutomator 定位深度拆解第 3 章「只会点按钮输文字滑动不会写」基础操作 W3C Actions API第 4 章「App 比 Web 慢太多用例老超时」等待策略 Toast 处理 网络等待第 5 章「遇到 H5 页面就懵了」Native ↔ WebView 上下文切换第 6 章「只会写单个步骤不会写完整业务流程」登录 → 下单全链路实战第 7 章「几十个用例全是复制粘贴」App 端 Page Object 设计第 8 章「不知道怎么把脚本变成正经测试框架」pytest Appium 集成 多设备并行第 9 章「Appium 2 的脚本升级 Appium 3 全炸了」Appium 3 迁移指南第 10 章「想让 AI 帮我写但不知道怎么配合」AI Appium Inspector 组合工作流下一篇《Appium 3 环境搭建避坑指南》——Node.js 版本、驱动安装、安全标志2026 年搭 Appium 环境的正确姿势。
