pytest-android 2019.1a5

This fixture provides a configured "driver" for Android Automated Testing, using uiautomator2.

pytest-android

[TOC]

pytest-android is a plugin for pytest that provides a configured 'driver' for Android Automated Testing, using uiautomator2.

pytest-android 是 pytest 的插件，它通过 uiautomator2 为 Android 自动化测试提供“驱动”。

功能

• 整合 uiautomator2，实现基于控件的自动化测试
• 依赖 pytest-variables 实现参数化配置
• 借助 allure 生成测试报告
• 借助 hook 机制，实现“点击、滑动时自动截图”、“异常时自动抓取控件信息和截图”等 fixture，减少重复工作
• 通过安装 pytest 插件，实现诸如“失败重试”、“分布式执行”、“用例分层”等

安装

强烈建议 使用 git 对代码进行版本控制，灵活运用分支开发的策略，并且将自动化整合进 DevOps 流程中。

推荐 本地开发使用基于virtualenv的工具实现环境隔离和解决各个模块之间的依赖，如pipenv。

建议 生产环境使用docker对各个设备之间进行“隔离”。

1. 安装 python

macOS、linux可以通过 pyenv 实现多个 python 版本的共存和切换，Windows上需要下载可执行文件、手动安装和配置环境变量。

因为使用了 python 3.6 的 f-string 特性，所以建议的 python 版本大于等于3.6。

具体安装过程略。

2. 创建工程

mkdir demo
cd demo

3. 安装插件和一些可选模块

推荐使用 pipenv 进行环境管理：

# macOS
brew install pipenv
# windows,linux
pip install --user pipenv

pipenv install pytest-android       # 必须(自动安装依赖模块 pytest 和 pytest-variables)
pipenv install uiautomator2>=0.1.7    # 必须，目前支持的驱动框架，后续可能还会添加 Appium 
# 必须，pytest-variables支持的配置文件格式，二选一即可
pipenv install PyYAML    # 推荐
pipenv install hjson


# 以下为可选模块，根据需要选择性安装
pipenv install --dev weditor		# uiautomator2 配套的录制工具
pipenv install allure-pytest pillow		# 使用 allure 生成报告
pipenv install pytest-rerunfailures		# 使 pytest 支持失败重试

使用

1. 创建配置文件

1.1 config.yaml

创建项目级配置文件，参考 config.yaml。此文件可以使用 yaml 和 hjson 格式（由 pytest-variables 插件实现），文件名任意。

配置文件可以同时指定多个（遇到相同字段，后面的会覆盖前面的），借助此功能可以实现：指定设备参数、实现复杂情况下的兼容性测试等。

1.2 pytest.ini

创建 pytest 的配置文件，参考文档进行基础配置。

添加addopts = --variables config.yaml，指定项目配置文件。

[可选]

如果使用 allure 生成报告，并安装了对应依赖，可以通过--alluredir指定报告的路径，通过--clean-alluredir指定开始前是否清理历史数据。更多参数可参考插件文档

如果借助 pytest-rerunfailures 插件实现失败重试，参考插件文档，添加--reruns

其他诸如 log 、markers，和第三方插件配置，根据需要参考对应文档。

这里是一份 pytest.ini 的示例。

2. 编写用例

2.1 可用的Fixtures

此处文档可能更新不及时，通过执行命令python -m pytest --fixtures，可以列出所有 fixtures 及其最新说明文档。

Name	Scope	Autouse	Description
driver	session	True	初始化设备 解锁、清理后台，设置驱动层参数和执行某些功能插件的注册
show_case_name	function	True	toast 提示显示用例描述或名字，便于了解进度
app_start	function	True	启动 app ，（仅）通过当前 app 包名判断是否启动
app_stop	function	True	每条 case 结束自动 close app

根据 pytest 的加载顺序，插件中定义的 fixture 是可以被 conftest.py和本地插件pytest_plugins 覆盖的。也就是说，如果具体到项目时不满足需求，可以在conftest.py文件中，编写同名fixture，修改scope、autoues和其具体行为。

2.2 编写用例

新建文件 test_demo.py，输入以下代码：

#!/usr/bin/env python
# encoding: utf-8
from uiautomator2 import UIAutomatorServer


def test_233(driver: UIAutomatorServer):
    print(driver.device_info)

运行：

pipenv run python -m pytest

Issues

如果插件使用中遇到问题，请通过 github issues 提交。

贡献代码

Contributions are very welcome.

License

Distributed under the terms of the MIT license, "pytest-android" is free and open source software.

根据MIT许可条款分发，“pytest-android”是免费的开源软件。