UIAutoTest

Fixtures辅助层(driver、data、业务相关的前后置操作)
     |
   用例层
     |
业务流程逻辑层
     |
PageObject层(继承BasePage)
     |
   元素层(元素数据、元素集切换)

WalletUiTest/
  - common/ 存放公共文件
    - base_page.py: 提供基本页面元素操作
    - config_parser.py: 提供配置文件解析方法
    - image.py: 提供图像识别方法
    - logger.py: 提供日志全局配置方法
    - yaml_parser.py: 提供yaml文件解析方法
    - utils.py: 提供工具类方法
  - install/: 存放修改后的源码或依赖库
  - demo/: 文件夹名称表示对应的应用别称(功能域)，demo只是示例名称
    - vXXX/: 以vXXX表示应用版本号以区分版本用例，每个版本一个文件夹(包含文件夹内的文件结构)
      - case/: 存放用例
      - data/: 存放测试数据(yaml文件)
      - element/: 存放定位元素(yaml文件)
        - element_router.py: 元素选择路由，需按照实际补充相关逻辑
      - flow/: 存放业务流程逻辑
      - image/: 存放需要图像识别的元素图像文件
      - page/:  存放PageObject文件
      - conftest.py: 放置与应用强关联的Fixtures操作
      - debug.py: 做步骤调试
      - run.py: 用例统一执行和生成报告
    - config.ini: 应用相关配置
  - report/: 存放与报告相关的文件
    - log: 存放本工程的log日志
    - logcat: 存放抓取的系统和应用日志
    - screenrecord: 存放用例执行过程的录屏
    - screenshot: 存放截图
    - raw_data: 存放allure原始数据
    - html_report_xxxx: allure生成的html报告，以时间分割保存
  - config.ini: 全局相关配置
  - conftest.py: 放置通用的Fixtures和Hooks方法
  - pytest.ini: pytest运行配置
  - README.md: 使用说明文档

#用例中数据，以以下方式书写，并存放到data/data.yaml中
test_case_0001: 
    param1: aaa
    param2: bbb

#page中的对应的element定位元素，以以下方式书写，并存放到element/中，文件名以 xxx_zz_element.yaml命名，xxx区分page，zz区分语言区域
element_name1: {text: "这是text文案", resourceId: "com.yyy.wallet:id/xxxx"}
element_name2: {resourceId: "com.yyy.wallet:id/zzzz"}

#driver和data传入参数
def test_unionpay_0001(self, driver, start_stop_app, data):
    union_pay_flow = UnionPayFlow(driver)
        union_pay_flow.bind_debit_card_nfc(**data["test_unionpay_0001"])

@pytest.mark.parametrize(('kewords'), [(u"小明"), (u"小红"), (u"小白")])
def test_kewords(self,kewords):
    print(kewords)

# 多个参数    
@pytest.mark.parametrize("test_input,expected", [
    ("3+5", 8),
    ("2+4", 6),
    ("6*9", 42),
])
def test_eval(test_input, expected):
    assert eval(test_input) == expected

class TestExample(object):

    @pytest.mark.dependency()
    def test_a(self):
        assert False

    @pytest.mark.dependency()
    def test_b(self):
        assert False

    @pytest.mark.dependency(depends=["TestExample::test_a"])
    def test_c(self):
        # TestExample::test_a 没通过则不执行该条用例
        # 可以跨 Class 筛选
        print("Hello I am in test_c")

    @pytest.mark.dependency(depends=["TestExample::test_a","TestExample::test_b"])
    def test_d(self):
        print("Hello I am in test_d")

@pytest.mark.release
def test_0001():
    pass

#仅执行标记release的用例
pytest -v -m release
#不执行标记release的用例
pytest -v -m "not release"

@pytest.mark.run(order=1)
class TestExample:
    def test_a(self):
        pass

#使用第三方插件
pip install pytest-rerunfailures #使用插件
pytest --reruns 2 # 失败case重试两次

#run.py args传入下值
def run():
    args = ["--reruns", "2", "--reruns-delay", "5"]
    pytest.main(args)

ClassName, ExceptionName  
GLOBAL_CONSTANT_NAME, CLASS_CONSTANT_NAME  
module_name, package_name, method_name, function_name, global_var_name, instance_var_name, function_parameter_name, local_var_name  
_InternalClassName, _INTERNAL_CONSTANT_NAME, _internal_function_name, _protected_member_name, __private_member_name  

spam(ham[1], {eggs: 2}, [])
if x == 4:
print x, y
x, y = y, x

spam(1)
dict[‘key’] = list[index]

x == 1

def complex(real, imag=0.0): return magic(r=real, i=imag)

foo = 1000 # comment
long_name = 2 # comment that should not be aligned

dictionary = {
“foo”: 1,
“long_name”: 2,
}

spam( ham[ 1 ], { eggs: 2 }, [ ] )

if x == 4 :
print x , y
x , y = y , x

spam (1)
dict [‘key’] = list [index]

x<1

def complex(real, imag = 0.0): return magic(r = real, i = imag)

foo = 1000 # comment
long_name = 2 # comment that should not be aligned

dictionary = {
“foo” : 1,
“long_name”: 2,
}

# 获取平台（Android iOS）
ReadConfig().get_platform
# 获取隐式等待时间
ReadConfig().get_implicitly_wait
# 获取检查错误toast开关状态
ReadConfig().get_check_error_toast
# 获取包名
ReadConfig().get_package_name
# 获取弹窗元素列表
ReadConfig().get_popup_elements
# 获取环境
ReadConfig().get_env
# 获取区域
ReadConfig().get_region
# 获取项目根路径
ReadConfig().get_root_dir

# 查找元素基本方法，聚合了ios、android元素基本定位方法和图像识别方法，若没有识别到会重试retry_times次数
find_element(retry_times=_MAX_RETRY_TIMES, **locator)

# 查找到元素后进行点击操作，默认会在点击操作结束后检查是否弹出异常toast，若不需要检查输入check_toast=False，若需要忽略正常toast输入ignore_toast,
# config.ini中的check_error_toast进行全局控制
find_element_and_click(check_toast=True, ignore_toast=None, **locator)

# 查找到元素后进行长按操作，默认长按1.0s
find_element_and_long_click(duration: float = 1.0, **locator)

# 查找到元素后进行输入操作，plaintext传入输入的文本，通常输入框无需额外进行点击，识别到即可输入文本
find_element_and_input(plaintext=None, **locator)

# 查找到元素后滑动元素，支持"left", "right", "up", "down"，steps只用于android，从元素中间开始，1步表示滑动5ms，200步表示滑动1s；
# scale用于android的xpath定位时表示从一边滑至另一边的比例(0, 1.0)，scale用于ios时表示滑动元素的宽/高乘以scale的长度
find_element_and_swipe(direction, steps: int = 10, scale: float = 0.8, **locator)

# 查找到元素后拖动元素，与滑动元素不同，这里只支持android，并且需要指定目标点的坐标
find_element_and_drag(*coordinate, **locator)

# 断言元素是否存在，不存在即报错
assert_element_exist(**locator)

# 检查元素存在性，返回bool值
check_element_existence(**locator)

# 断言文字是否存在，不存在即报错
assert_text_exist(plaintext)

# 检查文字存在性，返回bool值
check_text_existence(plaintext)

# 查找到指定的元素后等待元素消失，若超过默认5min时间还没有消失，会断言失败，可依据实际情况修改超时时间，一般用于进度等待
wait_until_element_gone(timeout=300, **locator)

# 滑动屏幕，支持"left", "right", "up", "bottom"，android可以设置滑动的比例，滑动距离是屏幕的宽(高)*scale；ios滑动距离固定，
# 上下滑动是从屏幕中间滑到上下边界，左右滑动是从屏幕最左(右)滑到最右(左)
swipe_screen(direction, scale: float = 0.7)

# 向上滚动屏幕直到指定的元素出现
scroll_until_element_appear(retry_times=_MAX_RETRY_TIMES, **locator)

# 滚动屏幕直到达到应用边界(顶部或底部)
scroll_to_boundary(boundary: str = "end", speed: str = "fast")

# 按键操作，Android支持home, back, left, right, up, down, center, menu, search, enter,delete(or del), recent(recent apps), 
# volume_up, volume_down,volume_mute, camera, power  iOS支持home, volumeUp, volumeDown
press_key(key)

# 打开通知栏
open_notification()

# 打开快速设置栏
open_quick_settings()

# 获取toast
get_toast()

# 屏幕截图
take_screenshot(name="截图")

# 等待，秒
sleep(seconds)

# element_router.py
# page和element文件的映射，page的类名作为键，文件名作为值
mapping = {
    "CommonPage": "common_cn_element.yaml",
    "HomePage": "home_cn_element.yaml",
    ...
}

# xxx_zz_element.yaml
# resourceId支持简写，消除包名差异，比如com.finshell.wallet:id/tv_order_record，可以简写成tv_order_record
abc: {resourceId: "com.finshell.wallet:id/tv_order_record"}
# 或者(推荐)
abc: {resourceId: "tv_order_record"}

# 组合写法
bcd: {text: "fff", resourceId: "dddeeefff"}

# child写法，传入child关键字，值为字典组成的列表，字典的写法与上面的一致，支持单个和组合，列表长度没有限制
efg: {child: [{className: "android.widget.LinearLayout"},{text: "京津冀互联互通卡"}]}

# right,left,up,down写法，传入right/left/up/down关键字，值为字典组成的列表，字典的写法与上面的一致，支持单个和组合，列表长度限制为2个元素
hij: {right: [{textContains: "身份证", resourceId: "tvName"}, {resourceId: "cetInf"}]}
...

# xxx_page.py
class XXXPage(BasePage):

    def __init__(self, driver):
        super(XXXPage, self).__init__(driver)
        self.element = ElementRouter.select(self.__class__.__name__)

    # ----------------- XXX模块/子页面 -------------------
    @allure.step("点击abc")
    def click_abc(self):
        self.find_element_and_click(**self.element["abc"])

    # ----------------- YYY模块/子页面 -------------------
    @allure.step("输入bcd")
    def input_bcd1(self, bcd1):
        self.find_element_and_input(bcd1, **self.element["bcd1"])

    @allure.step("输入bcd")
    def input_bcd2(self, bcd2):
        self.find_element_and_input(bcd2, **self.element["bcd2"])
    ...

# debug.py
def step(d):
    page = XXXPage(d)
    page.click_abc()

# xxx_flow.py
class XXXFlow(object):

    def __init__(self, driver):
        self.xxx_page = XXXPage(driver)

    @allure.story('描述是干什么的流程，比如登录账户')
    def flow_logic_description(self, **kwargs):
        self.xxx_page.click_abc()
        self.xxx_page.input_bcd(kwargs["bcd"])
        ...

# test_xxx.py
@allure.epic("用例一级模块")
class TestXXX:

    @allure.feature("用例二级模块")
    @allure.title("用例标题")
    @pytest.mark.release
    def test_xxx_0001(self, driver, start_stop_app, data): # 注意这里传入的fixtures参数，driver必传，data需要的时候再传
        xxx_flow = XXXFlow(driver)
        xxx_flow.flow_logic_description(**data["test_xxx_0001"])

# data.yaml
test_xxx_0001:
  bcd: "abcdefg"
  ...

import logging

logging.debug()
logging.info()
logging.warning()
logging.error()
logging.critical()
logging.exception()