pytest-android 2019.2a2

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

pytest-android

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

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

目录

• pytest-android
• 目录
• 主要功能
• 安装
  • 1. 安装 python
  • 2. 创建工程
  • 3. 安装插件和一些可选模块
• 使用
  • 1. 创建配置文件
    • 1.1 创建配置文件 config.yaml 和 pytest.ini
    • 1.2 根据需求调整配置[可选]
  • 2. 编写用例
    • 2.1 可用的Fixtures
    • 2.2 编写用例
• Issues
• License

主要功能

• 整合 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

# 必须，根据您的配置文件格式，二选一（因为插件目前在 alpha 测试阶段，需要添加`--pre`参数）
# 注意，pipenv在2018.11.26版本之后，才能支持额外（extras）模块（即安装时的中括号语法），所以使用较新的版本、或手动安装
pipenv install --pre pytest-android[yaml]	# yaml 作为配置文件，推荐
pipenv install --pre pytest-android[hjson]	# json 作为配置文件

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

PS: pip版本大于等于18时，pipenv需要的最低版本为2018.11.26（如果低于此版本会导致一系列错误）

注意：根据这里的观点，pytest-android 作为 libraries，将部署到某个特定的环境中，然后才能使所有依赖项和子依赖项的确切版本具体化。

使用

1. 创建配置文件

1.1 config.yaml

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

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

1.2 pytest.ini

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

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

1.1 创建配置文件 config.yaml 和 pytest.ini

项目配置文件 config.yaml，pytest 配置文件 pytest.ini ，区别：

pytest.ini 只能有一个，且文件名不可修改；

config.yaml 可以有多个（通过 pytest-variables 插件实现，需在pytest.ini 中指定），文件名任意，并且可以同时载入多个文件（遇到重复字段时，最后一个生效）。

通过配置文件，可以对测试进行参数化配置，提高测试的灵活性，降低代码维护的工作量，和减少可能的疏忽导致的异常。

目前已实现命令行工具，可以直接执行命令下载对应的配置文件示例：

pipenv run python -m pytest_android download --init

如果已经手动创建，或者想重新下载指定的文件，可以附加对应的参数：

pipenv run python -m pytest_android download --pytest.ini
pipenv run python -m pytest_android download --config.yaml

当本地文件与示例文件不一致时，会提示是否覆盖，可以选择N然后手动合并。

1.2 根据需求调整配置[可选]

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

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

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

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 包名判断是否启动

根据 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 提交。

License

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

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