1. 项目概述为什么选择Appium进行Android UI自动化测试在移动应用开发与测试的日常工作中UI自动化测试是保障应用质量、提升回归测试效率的关键环节。面对市面上众多的自动化测试框架Appium凭借其“一次编写多端运行”的理念和强大的开源生态成为了众多测试工程师和开发者的首选尤其是在Android平台。我接触Appium已有多年从早期的1.x版本用到现在的2.x版本它解决的核心痛点非常明确如何用一套代码同时覆盖Android和iOS的UI自动化测试并且不依赖于特定的编程语言。对于Android应用而言UI自动化测试的难点往往在于元素定位的稳定性、测试脚本的维护成本以及测试环境的搭建复杂度。Appium通过封装标准的WebDriver协议并利用Android系统自带的UIAutomator2或更早的Espresso作为底层驱动为我们提供了一个相对统一和稳定的操作接口。这意味着只要你熟悉Selenium WebDriver上手Appium几乎没有任何障碍。更重要的是它支持使用Python、Java、JavaScript、Ruby等多种主流语言编写测试脚本团队可以根据自身的技术栈灵活选择降低了学习和协作门槛。在实际项目中无论是电商App的购物流程、金融App的转账操作还是社交App的消息收发UI自动化测试的核心都是模拟真实用户的操作路径。Appium不仅能完成点击、输入、滑动等基础操作还能获取元素属性、断言页面状态甚至处理弹窗、权限请求等复杂场景。接下来我将以一个典型的Android应用测试为例从头拆解如何使用Appium搭建环境、编写脚本并解决实际测试中遇到的各种“坑”。2. 环境搭建与核心组件解析开始编写第一行测试代码之前一个稳定、正确的测试环境是成功的基石。Appium的环境搭建涉及多个组件理解它们各自的作用和依赖关系能让你在遇到问题时快速定位。2.1 核心组件与依赖关系一个完整的Appium测试环境主要包含以下几部分Appium Server这是测试执行的核心服务端。它接收来自我们编写的测试脚本客户端的WebDriver协议请求并将其翻译成手机系统如Android的UIAutomator2能够理解的指令。从Appium 2.0开始官方推荐使用appium官方驱动并通过插件方式管理功能架构更加清晰。Android SDK这是与Android设备通信的基石。我们需要其中的adbAndroid Debug Bridge工具来连接设备、安装/卸载应用、获取设备信息。platform-tools是必须的同时建议安装对应测试应用目标API级别的system-images和platforms。Java Development Kit (JDK)因为Appium Server本身是Node.js应用但Android的底层驱动如UIAutomator2 Server是Java编写的所以需要JDK来运行这些Java组件。通常安装Java 8或Java 11即可。测试脚本客户端库根据你选择的编程语言需要安装对应的WebDriver客户端库。例如选择Python就需要安装Appium-Python-Client。被测应用APK你需要准备好待测试应用的APK文件用于安装到测试设备上。2.2 逐步搭建环境以Windows/macOS为例这里我以Python为例展示最简化的搭建流程。其他语言如Java的客户端库安装方式类似。第一步安装Node.js与Appium ServerAppium Server基于Node.js所以首先需要安装Node.js建议LTS版本。安装完成后打开终端或命令提示符使用npm全局安装Appium的核心包和驱动。# 安装Appium Server核心 npm install -g appium # 安装Appium官方UIAutomator2驱动用于Android appium driver install uiautomator2 # 安装Appium Doctor用于检查环境 npm install -g appium-doctor安装完成后运行appium-doctor --android可以检查Android环境是否完备。它会提示你缺少哪些组件比如ANDROID_HOME环境变量是否设置正确。注意很多新手卡在环境变量上。ANDROID_HOME需要指向你的Android SDK根目录例如C:\Users\YourName\AppData\Local\Android\Sdk或/Users/YourName/Library/Android/sdk并且需要将%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools或tools/bin添加到系统的PATH环境变量中。这一步没做对后续adb命令和Appium都无法正常工作。第二步配置Android SDK如果你没有Android Studio可以单独下载命令行工具SDK。更简单的方式是直接安装Android Studio在安装过程中勾选Android SDK。安装后打开Android Studio的SDK Manager确保安装了以下内容Android SDK Platform选择与你测试设备或模拟器Android版本对应的平台版本。Android SDK Build-Tools安装最新稳定版。Android SDK Platform-Tools包含adb等关键工具。Intel x86 Atom_64 System Image或Google Play ARM系统镜像如果你要使用模拟器需要安装对应的系统镜像。第三步准备测试设备你可以使用真机或模拟器。真机需要开启“开发者选项”和“USB调试”。模拟器可以通过Android Studio的AVD Manager创建。确保设备可以通过adb devices命令被识别。adb devices # 应输出类似内容List of devices attached emulator-5554 device第四步安装Python客户端库在你的Python项目环境中安装Appium的Python客户端。pip install Appium-Python-Client至此最基本的环境就准备好了。你可以通过命令appium来启动Appium Server默认监听http://127.0.0.1:4723。但在实际脚本中我们通常用程序来启动和管理Server。3. 编写第一个Appium测试脚本从元素定位到断言环境就绪后我们开始编写第一个测试脚本。这个脚本的目标是在一台Android设备上打开系统自带的“计算器”应用完成一次加法运算并验证结果。3.1 初始化驱动与Desired Capabilities所有Appium测试脚本的开始都是配置Desired Capabilities。它是一组键值对用于告诉Appium Server你想要如何启动这次测试会话比如测试哪个应用、在什么设备上、使用什么自动化引擎等。from appium import webdriver from appium.options.android import UiAutomator2Options import time # 定义Desired Capabilities options UiAutomator2Options() options.platform_name Android # 平台 options.device_name emulator-5554 # 设备名通过adb devices获取 options.automation_name UiAutomator2 # 自动化引擎 # 指定被测App。如果应用未安装appium会先安装。这里我们用系统计算器。 options.app_package com.android.calculator2 options.app_activity com.android.calculator2.Calculator # 初始化WebDriver连接至Appium Server driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions)关键参数解析platform_name和device_name指定测试平台和设备。对于真机device_name可以是任意字符串但更常见的做法是用udid参数指定设备的唯一序列号。automation_name必须指定为UiAutomator2对于Android 5.0这是目前Android上最稳定和功能全面的驱动。app_package和app_activity这是启动Android应用的关键。app_package是应用的包名app_activity是你要启动的Activity的完整类名。获取它们的方法有很多比如使用adb shell dumpsys window | findstr mCurrentFocusWindows或grep mCurrentFocusmacOS/Linux查看当前前台应用。3.2 元素定位测试脚本的“眼睛”UI自动化的核心是找到界面上的元素按钮、输入框、文本并与之交互。Appium支持多种定位策略与Selenium类似。# 假设我们要点击数字键“5”。首先需要找到这个元素。 # 方法1通过资源ID定位最稳定、首选 button_5 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_5) # 方法2通过Accessibility ID定位对应Android的contentDescription # 如果元素设置了contentDescription可以使用。计算器按钮通常没有。 # 方法3通过XPath定位功能强大但可能性能稍差、易变 # button_5 driver.find_element(byAppiumBy.XPATH, value//android.widget.Button[text5]) # 找到元素后进行点击操作 button_5.click()定位策略心得资源IDID优先这是最稳定、最快的定位方式。需要让开发同学在编写UI时为关键测试元素添加唯一的android:id。如果应用是你自己开发的这应该成为规范。慎用XPath虽然XPath非常灵活可以处理复杂的层级关系但它对UI布局的变化极其敏感。页面结构稍作调整XPath就可能失效导致测试脚本维护成本剧增。仅在元素没有唯一ID且其他方式无效时使用。利用UIAutomator Viewer或Appium Inspector这两个工具可以连接到设备实时查看UI的层级结构和元素属性是编写定位语句的“神器”。Appium Inspector更现代集成在Appium Desktop中可以直接生成代码片段。3.3 组合操作与断言完成测试用例让我们组合起来完成一个完整的“5 3 ”测试并验证结果是否为8。from appium import webdriver from appium.options.android import UiAutomator2Options from appium.webdriver.common.appiumby import AppiumBy import time # 初始化驱动 options UiAutomator2Options() options.platform_name Android options.device_name emulator-5554 options.automation_name UiAutomator2 options.app_package com.android.calculator2 options.app_activity com.android.calculator2.Calculator driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions) time.sleep(2) # 等待应用完全启动这是一个简单的隐式等待实际应用中建议使用显式等待 try: # 1. 点击数字5 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_5).click() # 2. 点击加号 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/op_add).click() # 3. 点击数字3 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_3).click() # 4. 点击等号 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/eq).click() # 5. 获取结果框的文本 result_element driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/result) actual_result result_element.text # 6. 断言结果是否为“8” expected_result 8 assert actual_result expected_result, f计算结果错误期望值{expected_result}实际值{actual_result} print(测试通过5 3 8) except Exception as e: print(f测试执行过程中发生错误{e}) # 这里可以加入截图功能便于排查问题 driver.save_screenshot(error_screenshot.png) finally: # 7. 关闭会话 driver.quit()这个脚本虽然简单但涵盖了Appium测试的核心流程启动 - 定位 - 操作 - 断言 - 清理。在实际项目中你需要用更健壮的等待机制显式等待来替代time.sleep并将定位符、操作步骤进行封装以提高脚本的可维护性和复用性。4. 高级技巧与稳定性实战编写出能运行的脚本只是第一步写出能在不同设备、网络环境和应用版本下稳定运行的脚本才是真正的挑战。下面分享几个提升脚本稳定性和效率的实战技巧。4.1 等待机制告别“NoSuchElementException”元素找不到是自动化测试中最常见的错误。粗暴地使用time.sleep不仅效率低下而且无法适应不同设备的性能差异。Appium推荐使用显式等待。from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC # 设置一个最长等待10秒的等待对象 wait WebDriverWait(driver, 10) # 等待“数字5”按钮出现并可点击然后再进行操作 button_5 wait.until(EC.element_to_be_clickable((AppiumBy.ID, com.android.calculator2:id/digit_5))) button_5.click() # 等待结果出现并且文本不为空 result_element wait.until(EC.presence_of_element_located((AppiumBy.ID, com.android.calculator2:id/result))) wait.until(lambda d: result_element.text ! ) # 自定义等待条件直到结果非空显式等待的原理是在指定的超时时间内每隔一段时间默认0.5秒去检查条件是否满足。一旦满足就立即返回否则超时抛出异常。这比固定休眠要智能得多。4.2 处理弹窗、权限请求和混合应用现代App交互复杂弹窗如升级提示、广告、系统权限请求如访问相册、位置层出不穷。系统权限弹窗这类弹窗属于系统UI不在你的应用包内。处理它们需要用到driver.switch_to.context(NATIVE_APP)如果当前在WebView中然后使用UIAutomator的定位方式或者更通用的使用adb命令模拟点击屏幕坐标不推荐兼容性差。更好的做法是在测试开始前通过adb命令预先授予所有必要权限adb shell pm grant package_name permission。应用内弹窗如果弹窗是你应用自己绘制的那么用常规的元素定位方式即可。关键在于在可能弹出弹窗的操作后加入判断逻辑。# 示例尝试处理一个可能的“确定”按钮弹窗 try: # 设置一个很短的显式等待尝试查找弹窗的确定按钮 confirm_btn WebDriverWait(driver, 3).until( EC.presence_of_element_located((AppiumBy.ID, 弹窗确定按钮ID)) ) confirm_btn.click() print(检测到并关闭了弹窗。) except: print(未检测到弹窗继续执行。) # 继续主流程混合应用H5页面如果App内嵌了WebView你需要切换上下文Context才能操作其中的网页元素。使用driver.contexts获取所有上下文然后切换到包含WEBVIEW_的那个。# 打印所有上下文 print(driver.contexts) # 例如[NATIVE_APP, WEBVIEW_com.example.app] # 切换到WebView上下文 driver.switch_to.context(WEBVIEW_com.example.app) # 此时可以使用Selenium的方式定位网页元素 driver.find_element(By.CSS_SELECTOR, .login-btn).click() # 操作完成后切回原生上下文 driver.switch_to.context(NATIVE_APP)4.3 Page Object模式让脚本可维护当测试用例越来越多直接在每个用例中编写定位和操作代码会导致大量重复且一旦UI变化修改点会非常多。Page Object (PO) 模式是解决这个问题的标准设计模式。其核心思想是将每个页面或页面片段封装成一个类页面的元素定位和基本操作作为这个类的方法。测试用例则通过调用这些页面对象的方法来完成业务逻辑。# page_objects/calculator_page.py from appium.webdriver.common.appiumby import AppiumBy from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC class CalculatorPage: def __init__(self, driver): self.driver driver self.wait WebDriverWait(driver, 10) # 元素定位器Locators _digit_5_locator (AppiumBy.ID, com.android.calculator2:id/digit_5) _digit_3_locator (AppiumBy.ID, com.android.calculator2:id/digit_3) _op_add_locator (AppiumBy.ID, com.android.calculator2:id/op_add) _eq_locator (AppiumBy.ID, com.android.calculator2:id/eq) _result_locator (AppiumBy.ID, com.android.calculator2:id/result) # 页面操作方法 def click_digit_5(self): element self.wait.until(EC.element_to_be_clickable(self._digit_5_locator)) element.click() return self # 支持链式调用 def click_add(self): self.wait.until(EC.element_to_be_clickable(self._op_add_locator)).click() return self def click_digit_3(self): self.wait.until(EC.element_to_be_clickable(self._digit_3_locator)).click() return self def click_equals(self): self.wait.until(EC.element_to_be_clickable(self._eq_locator)).click() return self def get_result(self): result_element self.wait.until(EC.presence_of_element_located(self._result_locator)) # 等待结果稳定非空 self.wait.until(lambda d: result_element.text ! ) return result_element.text# test_cases/test_addition.py import pytest from appium import webdriver from appium.options.android import UiAutomator2Options from page_objects.calculator_page import CalculatorPage class TestCalculator: pytest.fixture(scopeclass) def driver(self): options UiAutomator2Options() ... # 初始化配置 driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions) yield driver driver.quit() def test_addition(self, driver): calc_page CalculatorPage(driver) calc_page.click_digit_5().click_add().click_digit_3().click_equals() assert calc_page.get_result() 8采用PO模式后测试用例变得非常清晰只关注业务逻辑。当UI元素ID发生变化时你只需要修改CalculatorPage类中的定位器所有用到该元素的测试用例都会自动生效维护成本大大降低。5. 常见问题排查与实战心得即使按照最佳实践编写脚本在实际执行中依然会遇到各种问题。下面是我总结的一些高频问题及其排查思路。5.1 连接与会话问题问题Unable to create a new remote session. Could not start a new application。排查检查Appium Server日志启动Appium时加上--log-level debug查看详细的错误信息。常见原因有appPackage/appActivity写错APK路径无效或损坏设备udid不对或未连接。验证APK信息使用aapt dump badging path_to_apk | findstr package launchable-activityWindows或grepmacOS/Linux命令确认包名和主Activity。检查设备状态确保adb devices能列出设备且状态为device而不是offline或unauthorized。如果是真机检查是否授权了电脑的USB调试。问题An unknown server-side error occurred while processing the command. Original error: Could not find a connected Android device。排查这通常意味着Appium Server启动时指定的udid与已连接设备不匹配或者deviceName在Capabilities中配置有误。对于模拟器deviceName可以是emulator-5554对于真机建议使用udid参数指定设备的序列号通过adb devices获取。5.2 元素定位与交互问题问题脚本在某一台设备上运行正常换一台设备或系统版本后就找不到元素了。排查UI差异不同厂商的ROM如小米的MIUI、华为的EMUI可能会对系统控件或你的应用UI进行细微修改导致资源ID或层级变化。解决方法是尽量使用不随UI风格变化的定位方式如部分文本匹配的XPath或者为不同设备准备不同的定位器策略。屏幕尺寸与分辨率绝对坐标定位不推荐会因此失效。确保使用与布局相关的定位方式ID、XPath。使用UIAutomator2的备用定位策略有时元素在UIAutomator2的页面源中不可见可以尝试切换到Espresso驱动automationName: Espresso但需要注意两者支持的Capabilities和命令略有不同。问题Element is not clickable at point... Other element would receive the click。排查这是典型的元素被遮挡问题。可能是弹窗、加载层或者是另一个透明元素覆盖在上面。使用driver.page_source打印当前页面XML结构分析元素层级。尝试先处理掉遮挡物如关闭弹窗。使用driver.execute_script(mobile: scroll, {...})或driver.find_element().location_once_scrolled_into_view先将元素滚动到可视区域。作为最后手段可以考虑使用TouchAction或W3C ActionsAPI进行精确坐标点击但同样存在兼容性问题。5.3 性能与稳定性问题问题测试脚本运行速度慢尤其是连续执行多个用例时。优化复用Session不要每条用例都重启应用。可以在测试套件开始时启动一次应用所有用例在此Session内执行最后统一关闭。Pytest的fixturescopesession或scopemodule可以很好地管理这一点。优化等待用精确的显式等待替代固定的隐式等待和sleep。为不同的操作设置合理的超时时间。减少不必要的截图和日志虽然调试时需要但在稳定运行的CI/CD流水线中可以适当减少日志级别和截图频率。使用fastResetCapability在Capabilities中设置noResetTrue和fullResetFalse可以让Appium在测试间不清除应用数据加快启动速度需注意测试数据隔离。我的个人心得UI自动化测试三分在脚本七分在维护。不要追求100%的自动化覆盖率而是将自动化重点放在核心的、稳定的、高价值的业务流程上比如用户登录、主流程下单、关键数据展示等。对于频繁变动的UI和新功能可以暂时采用手工测试待其稳定后再补充自动化用例。建立一个清晰的测试用例目录结构、良好的日志记录和失败截图机制当脚本在CI/CD中失败时你能快速定位是脚本问题、环境问题还是真正的产品缺陷这才是自动化测试能持续创造价值的关键。 
长河君 · 2026/8/4 4:14:14 · 阅读 1.2k Appium Android UI自动化测试实战：从环境搭建到脚本编写与优化
1. 项目概述为什么选择Appium进行Android UI自动化测试在移动应用开发与测试的日常工作中UI自动化测试是保障应用质量、提升回归测试效率的关键环节。面对市面上众多的自动化测试框架Appium凭借其“一次编写多端运行”的理念和强大的开源生态成为了众多测试工程师和开发者的首选尤其是在Android平台。我接触Appium已有多年从早期的1.x版本用到现在的2.x版本它解决的核心痛点非常明确如何用一套代码同时覆盖Android和iOS的UI自动化测试并且不依赖于特定的编程语言。对于Android应用而言UI自动化测试的难点往往在于元素定位的稳定性、测试脚本的维护成本以及测试环境的搭建复杂度。Appium通过封装标准的WebDriver协议并利用Android系统自带的UIAutomator2或更早的Espresso作为底层驱动为我们提供了一个相对统一和稳定的操作接口。这意味着只要你熟悉Selenium WebDriver上手Appium几乎没有任何障碍。更重要的是它支持使用Python、Java、JavaScript、Ruby等多种主流语言编写测试脚本团队可以根据自身的技术栈灵活选择降低了学习和协作门槛。在实际项目中无论是电商App的购物流程、金融App的转账操作还是社交App的消息收发UI自动化测试的核心都是模拟真实用户的操作路径。Appium不仅能完成点击、输入、滑动等基础操作还能获取元素属性、断言页面状态甚至处理弹窗、权限请求等复杂场景。接下来我将以一个典型的Android应用测试为例从头拆解如何使用Appium搭建环境、编写脚本并解决实际测试中遇到的各种“坑”。2. 环境搭建与核心组件解析开始编写第一行测试代码之前一个稳定、正确的测试环境是成功的基石。Appium的环境搭建涉及多个组件理解它们各自的作用和依赖关系能让你在遇到问题时快速定位。2.1 核心组件与依赖关系一个完整的Appium测试环境主要包含以下几部分Appium Server这是测试执行的核心服务端。它接收来自我们编写的测试脚本客户端的WebDriver协议请求并将其翻译成手机系统如Android的UIAutomator2能够理解的指令。从Appium 2.0开始官方推荐使用appium官方驱动并通过插件方式管理功能架构更加清晰。Android SDK这是与Android设备通信的基石。我们需要其中的adbAndroid Debug Bridge工具来连接设备、安装/卸载应用、获取设备信息。platform-tools是必须的同时建议安装对应测试应用目标API级别的system-images和platforms。Java Development Kit (JDK)因为Appium Server本身是Node.js应用但Android的底层驱动如UIAutomator2 Server是Java编写的所以需要JDK来运行这些Java组件。通常安装Java 8或Java 11即可。测试脚本客户端库根据你选择的编程语言需要安装对应的WebDriver客户端库。例如选择Python就需要安装Appium-Python-Client。被测应用APK你需要准备好待测试应用的APK文件用于安装到测试设备上。2.2 逐步搭建环境以Windows/macOS为例这里我以Python为例展示最简化的搭建流程。其他语言如Java的客户端库安装方式类似。第一步安装Node.js与Appium ServerAppium Server基于Node.js所以首先需要安装Node.js建议LTS版本。安装完成后打开终端或命令提示符使用npm全局安装Appium的核心包和驱动。# 安装Appium Server核心 npm install -g appium # 安装Appium官方UIAutomator2驱动用于Android appium driver install uiautomator2 # 安装Appium Doctor用于检查环境 npm install -g appium-doctor安装完成后运行appium-doctor --android可以检查Android环境是否完备。它会提示你缺少哪些组件比如ANDROID_HOME环境变量是否设置正确。注意很多新手卡在环境变量上。ANDROID_HOME需要指向你的Android SDK根目录例如C:\Users\YourName\AppData\Local\Android\Sdk或/Users/YourName/Library/Android/sdk并且需要将%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools或tools/bin添加到系统的PATH环境变量中。这一步没做对后续adb命令和Appium都无法正常工作。第二步配置Android SDK如果你没有Android Studio可以单独下载命令行工具SDK。更简单的方式是直接安装Android Studio在安装过程中勾选Android SDK。安装后打开Android Studio的SDK Manager确保安装了以下内容Android SDK Platform选择与你测试设备或模拟器Android版本对应的平台版本。Android SDK Build-Tools安装最新稳定版。Android SDK Platform-Tools包含adb等关键工具。Intel x86 Atom_64 System Image或Google Play ARM系统镜像如果你要使用模拟器需要安装对应的系统镜像。第三步准备测试设备你可以使用真机或模拟器。真机需要开启“开发者选项”和“USB调试”。模拟器可以通过Android Studio的AVD Manager创建。确保设备可以通过adb devices命令被识别。adb devices # 应输出类似内容List of devices attached emulator-5554 device第四步安装Python客户端库在你的Python项目环境中安装Appium的Python客户端。pip install Appium-Python-Client至此最基本的环境就准备好了。你可以通过命令appium来启动Appium Server默认监听http://127.0.0.1:4723。但在实际脚本中我们通常用程序来启动和管理Server。3. 编写第一个Appium测试脚本从元素定位到断言环境就绪后我们开始编写第一个测试脚本。这个脚本的目标是在一台Android设备上打开系统自带的“计算器”应用完成一次加法运算并验证结果。3.1 初始化驱动与Desired Capabilities所有Appium测试脚本的开始都是配置Desired Capabilities。它是一组键值对用于告诉Appium Server你想要如何启动这次测试会话比如测试哪个应用、在什么设备上、使用什么自动化引擎等。from appium import webdriver from appium.options.android import UiAutomator2Options import time # 定义Desired Capabilities options UiAutomator2Options() options.platform_name Android # 平台 options.device_name emulator-5554 # 设备名通过adb devices获取 options.automation_name UiAutomator2 # 自动化引擎 # 指定被测App。如果应用未安装appium会先安装。这里我们用系统计算器。 options.app_package com.android.calculator2 options.app_activity com.android.calculator2.Calculator # 初始化WebDriver连接至Appium Server driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions)关键参数解析platform_name和device_name指定测试平台和设备。对于真机device_name可以是任意字符串但更常见的做法是用udid参数指定设备的唯一序列号。automation_name必须指定为UiAutomator2对于Android 5.0这是目前Android上最稳定和功能全面的驱动。app_package和app_activity这是启动Android应用的关键。app_package是应用的包名app_activity是你要启动的Activity的完整类名。获取它们的方法有很多比如使用adb shell dumpsys window | findstr mCurrentFocusWindows或grep mCurrentFocusmacOS/Linux查看当前前台应用。3.2 元素定位测试脚本的“眼睛”UI自动化的核心是找到界面上的元素按钮、输入框、文本并与之交互。Appium支持多种定位策略与Selenium类似。# 假设我们要点击数字键“5”。首先需要找到这个元素。 # 方法1通过资源ID定位最稳定、首选 button_5 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_5) # 方法2通过Accessibility ID定位对应Android的contentDescription # 如果元素设置了contentDescription可以使用。计算器按钮通常没有。 # 方法3通过XPath定位功能强大但可能性能稍差、易变 # button_5 driver.find_element(byAppiumBy.XPATH, value//android.widget.Button[text5]) # 找到元素后进行点击操作 button_5.click()定位策略心得资源IDID优先这是最稳定、最快的定位方式。需要让开发同学在编写UI时为关键测试元素添加唯一的android:id。如果应用是你自己开发的这应该成为规范。慎用XPath虽然XPath非常灵活可以处理复杂的层级关系但它对UI布局的变化极其敏感。页面结构稍作调整XPath就可能失效导致测试脚本维护成本剧增。仅在元素没有唯一ID且其他方式无效时使用。利用UIAutomator Viewer或Appium Inspector这两个工具可以连接到设备实时查看UI的层级结构和元素属性是编写定位语句的“神器”。Appium Inspector更现代集成在Appium Desktop中可以直接生成代码片段。3.3 组合操作与断言完成测试用例让我们组合起来完成一个完整的“5 3 ”测试并验证结果是否为8。from appium import webdriver from appium.options.android import UiAutomator2Options from appium.webdriver.common.appiumby import AppiumBy import time # 初始化驱动 options UiAutomator2Options() options.platform_name Android options.device_name emulator-5554 options.automation_name UiAutomator2 options.app_package com.android.calculator2 options.app_activity com.android.calculator2.Calculator driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions) time.sleep(2) # 等待应用完全启动这是一个简单的隐式等待实际应用中建议使用显式等待 try: # 1. 点击数字5 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_5).click() # 2. 点击加号 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/op_add).click() # 3. 点击数字3 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/digit_3).click() # 4. 点击等号 driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/eq).click() # 5. 获取结果框的文本 result_element driver.find_element(byAppiumBy.ID, valuecom.android.calculator2:id/result) actual_result result_element.text # 6. 断言结果是否为“8” expected_result 8 assert actual_result expected_result, f计算结果错误期望值{expected_result}实际值{actual_result} print(测试通过5 3 8) except Exception as e: print(f测试执行过程中发生错误{e}) # 这里可以加入截图功能便于排查问题 driver.save_screenshot(error_screenshot.png) finally: # 7. 关闭会话 driver.quit()这个脚本虽然简单但涵盖了Appium测试的核心流程启动 - 定位 - 操作 - 断言 - 清理。在实际项目中你需要用更健壮的等待机制显式等待来替代time.sleep并将定位符、操作步骤进行封装以提高脚本的可维护性和复用性。4. 高级技巧与稳定性实战编写出能运行的脚本只是第一步写出能在不同设备、网络环境和应用版本下稳定运行的脚本才是真正的挑战。下面分享几个提升脚本稳定性和效率的实战技巧。4.1 等待机制告别“NoSuchElementException”元素找不到是自动化测试中最常见的错误。粗暴地使用time.sleep不仅效率低下而且无法适应不同设备的性能差异。Appium推荐使用显式等待。from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC # 设置一个最长等待10秒的等待对象 wait WebDriverWait(driver, 10) # 等待“数字5”按钮出现并可点击然后再进行操作 button_5 wait.until(EC.element_to_be_clickable((AppiumBy.ID, com.android.calculator2:id/digit_5))) button_5.click() # 等待结果出现并且文本不为空 result_element wait.until(EC.presence_of_element_located((AppiumBy.ID, com.android.calculator2:id/result))) wait.until(lambda d: result_element.text ! ) # 自定义等待条件直到结果非空显式等待的原理是在指定的超时时间内每隔一段时间默认0.5秒去检查条件是否满足。一旦满足就立即返回否则超时抛出异常。这比固定休眠要智能得多。4.2 处理弹窗、权限请求和混合应用现代App交互复杂弹窗如升级提示、广告、系统权限请求如访问相册、位置层出不穷。系统权限弹窗这类弹窗属于系统UI不在你的应用包内。处理它们需要用到driver.switch_to.context(NATIVE_APP)如果当前在WebView中然后使用UIAutomator的定位方式或者更通用的使用adb命令模拟点击屏幕坐标不推荐兼容性差。更好的做法是在测试开始前通过adb命令预先授予所有必要权限adb shell pm grant package_name permission。应用内弹窗如果弹窗是你应用自己绘制的那么用常规的元素定位方式即可。关键在于在可能弹出弹窗的操作后加入判断逻辑。# 示例尝试处理一个可能的“确定”按钮弹窗 try: # 设置一个很短的显式等待尝试查找弹窗的确定按钮 confirm_btn WebDriverWait(driver, 3).until( EC.presence_of_element_located((AppiumBy.ID, 弹窗确定按钮ID)) ) confirm_btn.click() print(检测到并关闭了弹窗。) except: print(未检测到弹窗继续执行。) # 继续主流程混合应用H5页面如果App内嵌了WebView你需要切换上下文Context才能操作其中的网页元素。使用driver.contexts获取所有上下文然后切换到包含WEBVIEW_的那个。# 打印所有上下文 print(driver.contexts) # 例如[NATIVE_APP, WEBVIEW_com.example.app] # 切换到WebView上下文 driver.switch_to.context(WEBVIEW_com.example.app) # 此时可以使用Selenium的方式定位网页元素 driver.find_element(By.CSS_SELECTOR, .login-btn).click() # 操作完成后切回原生上下文 driver.switch_to.context(NATIVE_APP)4.3 Page Object模式让脚本可维护当测试用例越来越多直接在每个用例中编写定位和操作代码会导致大量重复且一旦UI变化修改点会非常多。Page Object (PO) 模式是解决这个问题的标准设计模式。其核心思想是将每个页面或页面片段封装成一个类页面的元素定位和基本操作作为这个类的方法。测试用例则通过调用这些页面对象的方法来完成业务逻辑。# page_objects/calculator_page.py from appium.webdriver.common.appiumby import AppiumBy from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC class CalculatorPage: def __init__(self, driver): self.driver driver self.wait WebDriverWait(driver, 10) # 元素定位器Locators _digit_5_locator (AppiumBy.ID, com.android.calculator2:id/digit_5) _digit_3_locator (AppiumBy.ID, com.android.calculator2:id/digit_3) _op_add_locator (AppiumBy.ID, com.android.calculator2:id/op_add) _eq_locator (AppiumBy.ID, com.android.calculator2:id/eq) _result_locator (AppiumBy.ID, com.android.calculator2:id/result) # 页面操作方法 def click_digit_5(self): element self.wait.until(EC.element_to_be_clickable(self._digit_5_locator)) element.click() return self # 支持链式调用 def click_add(self): self.wait.until(EC.element_to_be_clickable(self._op_add_locator)).click() return self def click_digit_3(self): self.wait.until(EC.element_to_be_clickable(self._digit_3_locator)).click() return self def click_equals(self): self.wait.until(EC.element_to_be_clickable(self._eq_locator)).click() return self def get_result(self): result_element self.wait.until(EC.presence_of_element_located(self._result_locator)) # 等待结果稳定非空 self.wait.until(lambda d: result_element.text ! ) return result_element.text# test_cases/test_addition.py import pytest from appium import webdriver from appium.options.android import UiAutomator2Options from page_objects.calculator_page import CalculatorPage class TestCalculator: pytest.fixture(scopeclass) def driver(self): options UiAutomator2Options() ... # 初始化配置 driver webdriver.Remote(http://127.0.0.1:4723, optionsoptions) yield driver driver.quit() def test_addition(self, driver): calc_page CalculatorPage(driver) calc_page.click_digit_5().click_add().click_digit_3().click_equals() assert calc_page.get_result() 8采用PO模式后测试用例变得非常清晰只关注业务逻辑。当UI元素ID发生变化时你只需要修改CalculatorPage类中的定位器所有用到该元素的测试用例都会自动生效维护成本大大降低。5. 常见问题排查与实战心得即使按照最佳实践编写脚本在实际执行中依然会遇到各种问题。下面是我总结的一些高频问题及其排查思路。5.1 连接与会话问题问题Unable to create a new remote session. Could not start a new application。排查检查Appium Server日志启动Appium时加上--log-level debug查看详细的错误信息。常见原因有appPackage/appActivity写错APK路径无效或损坏设备udid不对或未连接。验证APK信息使用aapt dump badging path_to_apk | findstr package launchable-activityWindows或grepmacOS/Linux命令确认包名和主Activity。检查设备状态确保adb devices能列出设备且状态为device而不是offline或unauthorized。如果是真机检查是否授权了电脑的USB调试。问题An unknown server-side error occurred while processing the command. Original error: Could not find a connected Android device。排查这通常意味着Appium Server启动时指定的udid与已连接设备不匹配或者deviceName在Capabilities中配置有误。对于模拟器deviceName可以是emulator-5554对于真机建议使用udid参数指定设备的序列号通过adb devices获取。5.2 元素定位与交互问题问题脚本在某一台设备上运行正常换一台设备或系统版本后就找不到元素了。排查UI差异不同厂商的ROM如小米的MIUI、华为的EMUI可能会对系统控件或你的应用UI进行细微修改导致资源ID或层级变化。解决方法是尽量使用不随UI风格变化的定位方式如部分文本匹配的XPath或者为不同设备准备不同的定位器策略。屏幕尺寸与分辨率绝对坐标定位不推荐会因此失效。确保使用与布局相关的定位方式ID、XPath。使用UIAutomator2的备用定位策略有时元素在UIAutomator2的页面源中不可见可以尝试切换到Espresso驱动automationName: Espresso但需要注意两者支持的Capabilities和命令略有不同。问题Element is not clickable at point... Other element would receive the click。排查这是典型的元素被遮挡问题。可能是弹窗、加载层或者是另一个透明元素覆盖在上面。使用driver.page_source打印当前页面XML结构分析元素层级。尝试先处理掉遮挡物如关闭弹窗。使用driver.execute_script(mobile: scroll, {...})或driver.find_element().location_once_scrolled_into_view先将元素滚动到可视区域。作为最后手段可以考虑使用TouchAction或W3C ActionsAPI进行精确坐标点击但同样存在兼容性问题。5.3 性能与稳定性问题问题测试脚本运行速度慢尤其是连续执行多个用例时。优化复用Session不要每条用例都重启应用。可以在测试套件开始时启动一次应用所有用例在此Session内执行最后统一关闭。Pytest的fixturescopesession或scopemodule可以很好地管理这一点。优化等待用精确的显式等待替代固定的隐式等待和sleep。为不同的操作设置合理的超时时间。减少不必要的截图和日志虽然调试时需要但在稳定运行的CI/CD流水线中可以适当减少日志级别和截图频率。使用fastResetCapability在Capabilities中设置noResetTrue和fullResetFalse可以让Appium在测试间不清除应用数据加快启动速度需注意测试数据隔离。我的个人心得UI自动化测试三分在脚本七分在维护。不要追求100%的自动化覆盖率而是将自动化重点放在核心的、稳定的、高价值的业务流程上比如用户登录、主流程下单、关键数据展示等。对于频繁变动的UI和新功能可以暂时采用手工测试待其稳定后再补充自动化用例。建立一个清晰的测试用例目录结构、良好的日志记录和失败截图机制当脚本在CI/CD中失败时你能快速定位是脚本问题、环境问题还是真正的产品缺陷这才是自动化测试能持续创造价值的关键。