# Appium自动化测试入门：从零编写你的第一个Python测试脚本 移动应用测试领域正在经历一场效率革命，而Appium作为开源工具链中的明星产品，正在重新定义自动化测试的工作方式。不同于传统需要针对不同平台编写多套测试代码的方式，Appium的跨平台特性让开发者可以用同一套API同时测试iOS和Android应用。本文将带你从开发环境搭建开始，逐步完成第一个能实际运行的测试脚本，过程中会特别关注那些官方文档没有明确说明的"坑点"。 ## 1. 环境配置：搭建Appium测试基础架构 在开始编写任何测试代码之前，我们需要先搭建完整的测试环境。这个过程就像准备一个专业的厨房——缺少任何关键工具都会影响后续的"烹饪"体验。对于Appium测试来说，环境配置需要三个核心组件：Appium服务端、移动设备或模拟器，以及对应的平台SDK。 ### 1.1 安装Appium服务端 Appium提供了两种安装方式，各有利弊： - **Appium Desktop**：图形界面版本，适合初学者快速上手 - 下载地址：官网提供的[最新发布版本](https://github.com/appium/appium-desktop/releases) - 安装后会自动配置必要的环境变量 - 内置Inspector工具方便元素定位 - **命令行版本**：更适合持续集成环境 ```bash npm install -g appium ``` > 注意：需要提前安装Node.js环境，建议版本12以上 我个人的经验是，初次接触时先用Appium Desktop熟悉基本流程，等脚本稳定后再迁移到命令行版本以便自动化执行。 ### 1.2 配置Android开发环境 Android测试需要三个关键组件协同工作： | 组件名称 | 作用 | 安装方式 | |----------------|-----------------------------|---------------------------| | Android SDK | 提供adb等核心工具 | 通过Android Studio安装 | | 平台工具 | 包含设备连接相关工具 | SDK Manager中单独更新 | | 系统镜像 | 用于模拟器运行 | 根据测试需求下载对应版本 | 配置中最容易出问题的是环境变量设置。确保在系统PATH中添加了以下路径： ```bash export ANDROID_HOME=/path/to/android/sdk export PATH=$PATH:$ANDROID_HOME/platform-tools export PATH=$PATH:$ANDROID_HOME/tools ``` ### 1.3 设备连接配置 无论是真机还是模拟器，都需要确保设备可以被adb识别： ```bash adb devices ``` 这个命令应该列出已连接的设备。如果使用模拟器，推荐性能稳定的选择如Genymotion或官方模拟器。我曾在M1芯片的Mac上遇到过x86镜像兼容性问题，改用arm64镜像后解决。 ## 2. 编写第一个测试脚本：从Hello World开始 环境就绪后，我们可以开始编写第一个真正的测试脚本了。这个脚本将打开Android设置应用，验证特定界面元素是否存在。虽然简单，但包含了所有关键要素。 ### 2.1 创建Python虚拟环境 首先为项目创建独立的环境： ```bash python -m venv appium-env source appium-env/bin/activate # Linux/Mac appium-env\Scripts\activate # Windows pip install Appium-Python-Client selenium ``` ### 2.2 基础脚本结构剖析 下面是一个完整的测试脚本示例，我们分段解析： ```python from appium import webdriver from appium.webdriver.common.appiumby import AppiumBy desired_caps = { 'platformName': 'Android', 'platformVersion': '11', 'deviceName': 'Pixel_4_API_30', 'automationName': 'UiAutomator2', 'appPackage': 'com.android.settings', 'appActivity': '.Settings', 'noReset': True } driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps) try: # 定位"关于手机"菜单项 about_phone = driver.find_element( AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("关于手机")' ) about_phone.click() print("测试通过：成功找到并点击'关于手机'") finally: driver.quit() ``` 关键配置项说明： - `platformVersion`：必须与设备/模拟器的系统版本一致 - `appPackage`和`appActivity`：可以通过`adb shell dumpsys window | grep mCurrentFocus`获取 - `noReset`：避免每次测试都重置应用状态 ### 2.3 元素定位策略对比 Appium支持多种元素定位方式，各有适用场景： | 定位方式 | 示例代码 | 适用场景 | |-------------------------|-------------------------------------|----------------------| | ID定位 | `find_element(AppiumBy.ID, "com.example:id/btn")` | 元素有唯一ID时最佳 | | XPath | `find_element(AppiumBy.XPATH, "//android.widget.TextView[@text='确定']")` | 复杂层级结构 | | UI Automator | `find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("登录")')` | Android专属，性能较好 | | 可访问性ID | `find_element(AppiumBy.ACCESSIBILITY_ID, "login_button")` | 跨平台一致性高 | 在实际项目中，我倾向于优先使用ACCESSIBILITY_ID，因为它在iOS和Android上表现一致，有利于编写跨平台测试代码。 ## 3. 常见问题排查与调试技巧 即使按照步骤操作，Appium测试中仍会遇到各种意外情况。以下是几个典型问题及其解决方案。 ### 3.1 设备连接问题 **症状**：adb devices列表为空，或Appium无法识别设备 解决步骤： 1. 检查USB调试是否开启（开发者选项中） 2. 尝试重新插拔USB线 3. 重启adb服务： ```bash adb kill-server adb start-server ``` 4. 如果是模拟器，确保已完全启动 ### 3.2 元素定位失败 **症状**：测试报错找不到元素，但肉眼可见该元素存在 调试方法： 1. 使用Appium Inspector或uiautomatorviewer确认元素属性 2. 添加显式等待： ```python 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.ID, "com.example:id/btn")) ) ``` 3. 检查是否在正确的上下文（Context）中，特别是混合应用 ### 3.3 性能优化建议 当测试套件变大后，执行速度会成为瓶颈。以下是我在实践中总结的优化点： - **并行执行**：配置多个设备同时运行不同测试用例 - **智能等待**：替代固定的sleep，使用动态等待条件 - **截图策略**：只在失败时截图，避免不必要的IO操作 - **会话复用**：对于某些场景，可以保持会话而不是每个测试都重启 ## 4. 进阶技巧：构建健壮的测试框架 完成基础脚本后，我们需要考虑如何组织代码，使其易于维护和扩展。 ### 4.1 页面对象模式实现 页面对象模式（Page Object Pattern）将页面元素和操作封装成类，大幅提升代码可读性： ```python class SettingsPage: def __init__(self, driver): self.driver = driver self.about_phone = (AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("关于手机")') def go_to_about_phone(self): self.driver.find_element(*self.about_phone).click() return AboutPhonePage(self.driver) class AboutPhonePage: def __init__(self, driver): self.driver = driver def get_build_number(self): return self.driver.find_element( AppiumBy.ID, 'com.android.settings:id/build_number' ).text ``` ### 4.2 数据驱动测试 使用pytest的参数化功能实现数据驱动： ```python import pytest @pytest.mark.parametrize("menu_item", [ "关于手机", "系统", "电池" ]) def test_settings_menu(driver, menu_item): page = SettingsPage(driver) assert page.is_menu_item_present(menu_item) ``` ### 4.3 持续集成配置 在GitHub Actions中运行Appium测试的示例配置： ```yaml name: Appium Tests on: [push] jobs: test: runs-on: macos-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v2 - name: Install dependencies run: | pip install -r requirements.txt npm install -g appium - name: Start Appium run: | appium & - name: Run tests run: pytest ``` ## 5. 实际项目经验分享 在电商App的测试实践中，我发现几个特别有用的技巧值得分享。首先是处理权限弹窗的通用方法： ```python def handle_permission_popup(driver): try: allow_btn = WebDriverWait(driver, 3).until( EC.element_to_be_clickable( (AppiumBy.ID, "com.android.packageinstaller:id/permission_allow_button") ) ) allow_btn.click() except: pass # 没有弹窗则继续 ``` 其次是处理WebView的切换策略。当应用内嵌网页时，需要先获取所有上下文然后切换到WEBVIEW： ```python # 获取所有可用上下文 contexts = driver.contexts # 切换到WebView driver.switch_to.context('WEBVIEW_com.example.app') # 操作完成后切换回原生上下文 driver.switch_to.context('NATIVE_APP') ``` 最后是关于测试报告的优化。除了标准的pytest-html报告外，我还会在关键步骤添加带有时间戳的截图： ```python def take_screenshot(driver, name): timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") filename = f"screenshots/{name}_{timestamp}.png" driver.save_screenshot(filename) return filename ```