移动端自动化测试Appium，从入门到项目实战Python版

it技术
136 阅读4分钟

移动端自动化测试Appium，从入门到项目实战Python版---xingkeit.top/9219/

在移动应用开发领域，自动化测试是保障产品质量的核心环节。Appium作为一款开源的跨平台移动自动化测试工具，支持Android和iOS系统，且能与Python等主流语言无缝集成，成为开发者首选。本文将基于实际项目经验，系统讲解Appium+Python的技术实现路径，涵盖环境搭建、核心功能、项目实战及优化技巧。

一、环境搭建：从零到一的完整指南

1. 基础环境配置

  • JDK安装：Appium依赖Java环境，需安装JDK 11或更高版本。通过命令java -version验证安装成功。

  • Android SDK配置：

    • 下载Android Studio并安装SDK，配置环境变量ANDROID_HOME指向SDK根目录。

    • 在PATH中添加platform-tools和tools路径，例如：

      bash
export ANDROID_HOME=/Users/username/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools

    • 通过adb devices命令验证设备连接状态。

  • Node.js与Appium Server：

    • 安装Node.js（建议LTS版本），通过npm install -g appium全局安装Appium。
    • 启动服务：appium -a 127.0.0.1 -p 4723，访问http://127.0.0.1:4723/wd/hub/status验证服务状态。

2. Python环境与依赖库

  • 安装Python 3.8+，通过pip install Appium-Python-Client安装客户端库。
  • 推荐使用PyCharm作为IDE，创建虚拟环境隔离项目依赖。

3. 设备与模拟器配置

  • 真机测试：开启USB调试模式，连接电脑后通过adb devices确认设备序列号。
  • 模拟器：推荐Genymotion或Android Studio自带的AVD，启动后通过adb connect 127.0.0.1:5555连接。

二、核心功能实现：从基础操作到高级技巧

1. 创建Appium会话

通过Desired Capabilities配置设备和应用信息，示例代码如下：

python
from appium import webdriver
from appium.options.android import UiAutomator2Options
 
caps = {
    "platformName": "Android",
    "deviceName": "emulator-5554",
    "appPackage": "com.example.app",
    "appActivity": ".MainActivity",
    "automationName": "UiAutomator2",
    "noReset": True  # 保留应用数据
}
 
options = UiAutomator2Options().load_capabilities(caps)
driver = webdriver.Remote("http://localhost:4723/wd/hub", options=options)

2. 元素定位与操作

  • ID定位：优先使用resource-id，示例：

    python
from appium.webdriver.common.appiumby import AppiumBy
element = driver.find_element(by=AppiumBy.ID, value="com.example.app:id/btn_login")
element.click()

  • XPath定位：适用于动态元素，示例：

    python
element = driver.find_element(by=AppiumBy.XPATH, value="//android.widget.Button[@text='登录']")

  • UIAutomator定位：结合属性组合定位，示例：

    python
from selenium.webdriver.common.by import By
element = driver.find_element(by=By.ANDROID_UIAUTOMATOR, value='new UiSelector().text("密码")')

3. 显式等待机制

避免因元素未加载导致的异常，示例：

python
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
 
def wait_and_click(driver, locator, timeout=10):
    try:
        element = WebDriverWait(driver, timeout).until(EC.element_to_be_clickable(locator))
        element.click()
    except Exception as e:
        print(f"等待超时: {e}")
 
# 用法
login_btn = (AppiumBy.ID, "com.example.app:id/btn_login")
wait_and_click(driver, login_btn)

4. 滑动与手势操作

  • 垂直滑动：

    python
window_size = driver.get_window_size()
start_x = window_size['width'] / 2
start_y = window_size['height'] * 0.8
end_y = window_size['height'] * 0.2
driver.swipe(start_x, start_y, start_x, end_y, 500)

  • 长按元素：

    python
from appium.webdriver.common.touch_action import TouchAction
element = driver.find_element(by=AppiumBy.ID, value="com.example.app:id/item")
TouchAction(driver).long_press(element).perform()

三、项目实战：电商App自动化测试

1. 测试场景设计

以某电商App为例，设计以下测试用例：

  • 用户登录（账号密码/短信验证码）
  • 商品搜索与筛选
  • 加入购物车与结算
  • 订单状态验证

2. 代码实现（登录模块）

python
import unittest
from appium import webdriver
from appium.options.android import UiAutomator2Options
 
class ECommerceTest(unittest.TestCase):
    @classmethod
    def setUpClass(cls):
        caps = {
            "platformName": "Android",
            "deviceName": "emulator-5554",
            "appPackage": "com.example.ecommerce",
            "appActivity": ".SplashActivity",
            "noReset": False
        }
        options = UiAutomator2Options().load_capabilities(caps)
        cls.driver = webdriver.Remote("http://localhost:4723/wd/hub", options=options)
 
    def test_login_with_password(self):
        # 跳过引导页
        skip_btn = (AppiumBy.ID, "com.example.ecommerce:id/btn_skip")
        if self.driver.find_elements(*skip_btn):
            self.driver.find_element(*skip_btn).click()
 
        # 输入账号密码
        username = self.driver.find_element(AppiumBy.ID, "com.example.ecommerce:id/et_username")
        password = self.driver.find_element(AppiumBy.ID, "com.example.ecommerce:id/et_password")
        username.send_keys("testuser")
        password.send_keys("123456")
 
        # 点击登录
        login_btn = (AppiumBy.ID, "com.example.ecommerce:id/btn_login")
        self.driver.find_element(*login_btn).click()
 
        # 验证登录成功
        home_title = self.driver.find_element(AppiumBy.XPATH, "//android.widget.TextView[@text='首页']")
        self.assertTrue(home_title.is_displayed())
 
    @classmethod
    def tearDownClass(cls):
        cls.driver.quit()
 
if __name__ == "__main__":
    unittest.main()

3. 测试报告生成

结合Allure生成可视化报告：

  1. 安装依赖：pip install allure-pytest
  2. 运行测试：pytest test_ecommerce.py --alluredir=./report
  3. 生成报告：allure serve ./report

四、优化技巧与避坑指南

1. 性能优化

  • 并行测试：使用pytest-xdist插件实现多设备并行执行。
  • 元素缓存：对频繁使用的元素进行缓存，减少定位时间。
  • 日志管理：通过logging模块记录关键操作，便于问题排查。

2. 常见问题解决

  • 元素定位失败：

    • 检查元素属性是否动态生成（如时间戳后缀）。
    • 使用uiautomatorviewer或Appium Inspector分析界面层级。

  • 端口冲突：

    • 启动Appium时指定端口：appium -p 4724
    • 通过netstat -ano | findstr 4723查看占用进程并终止。

  • 应用崩溃处理：

    • 捕获异常并重启会话：

      python
from selenium.common.exceptions import WebDriverException
try:
    driver.find_element(AppiumBy.ID, "com.example.app:id/btn").click()
except WebDriverException as e:
    print(f"应用异常: {e}")
    driver.quit()
    # 重新初始化driver

五、未来趋势：智能化测试

  • AI元素识别：基于CV技术实现视觉定位，解决动态ID问题。
  • 自主探索测试：通过强化学习生成测试路径，覆盖更多边界场景。
  • 低代码平台：结合自然语言处理（NLP），实现测试用例自动生成。

结语

Appium+Python的自动化测试方案已广泛应用于电商、金融、社交等领域。通过系统化的环境搭建、核心功能实现和项目实战，开发者可快速构建高效的测试体系。建议结合持续集成（CI）工具（如Jenkins）实现自动化测试的常态化运行，为产品质量保驾护航。

avatar
文章
阅读
粉丝