Appium UiAutomator2驱动：通用能力集介绍

Appium服务端会提供的一系列能力集合，Appium客户端通过构造键值对集合并发送给Appium服务端，以此来告诉服务器需要提供什么样的能力（例如建立与何种设备的通信，是Android还是ios设备、建链的超时时间等），也可以在运行过程中对服务端的行为进行修改。

Appium提供的能力跟Driver相关，不同的Driver对应不同的测试对象，提供的能力以及所需要传入的参数都不一样，本文描述的是UiAutomator2 Driver提供的能力集合，它提供对Android设备的自动化测试支持。按照官方文档的定义，分为通用能力、Driver/Server能力等方面，本文介绍UiAutomator2提供的通用能力集。

本文所有测试代码的前提是已经安装Appium和相关环境（例如JDK和Android SKD），可以参考Appium环境搭建。

本文所使用的相关软件及版本如下：

通用能力

1、通用能力描述

2 、通用能力解读

运行测试脚本前，请打开模拟器或者连接真机器

• 建立会话连接

  从前面分析可以知道，要建立客户端与服务端的会话，至少需要提供两个参数：platformName 和appium:automationName 。其中任何一个未提供，建立会话时都会返回错误，有两种方法可以指定所需要的能力集，一种是使用将能力使用字典键值对的方式传入，另外一种是使用UiAutomator2Options类来创建并指定添加能力。第一种方式目前已经不推荐，后续也会被废弃，建议采用第二种方式。

方法1：

# -*- coding: utf-8 -*-

import pytest

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.appium_service import AppiumService

# 开启服务端
APPIUM_HOST = '127.0.0.1'
APPIUM_PORT = 4723
@pytest.fixture(scope="session")
def start_appium_service():
    server = AppiumService()
    server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
    yield server
    server.stop()

# !使用原始的字典键值对创建能力---该方法会被废弃
def create_appium_session_by_dict(custom_opts:dict):
    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', custom_opts)

# 客户端创建会话连接所需要的最少参数
def test_general_capability_of_min_args(start_appium_service):
    min_opts = {
        "appium:automationName":"uiautomator2",
        "platformName": "android"
    }
    driver = create_appium_session_by_dict(min_opts)
    driver.quit()

方法2（推荐）：UiAutomator2Options会默认创建platformName 和appium:automationName两个参数，因此无需传入其他参数也可以建立会话

# -*- coding: utf-8 -*-

import pytest

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.appium_service import AppiumService

# 开启服务端
APPIUM_HOST = '127.0.0.1'
APPIUM_PORT = 4723
@pytest.fixture(scope="session")
def start_appium_service():
    server = AppiumService()
    server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
    yield server
    server.stop()

# 创建客户端到服务端的会话
# !使用API接口UiAutomator2Options创建能力---推荐
def create_appium_session_by_api(custom_opts = None):
    # !UiAutomator2Options默认就已经初始化automationName和platformName两个参数
    options = UiAutomator2Options()
    if custom_opts is not None:
        options.load_capabilities(custom_opts)
    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)

# 客户端创建会话连接所需要的最少参数
def test_general_capability_of_min_args(start_appium_service):
    driver = create_appium_session_by_api()
    driver.quit()

• appium:noReset ：保持被测应用和数据不被恢复

  该参数可以保持会话过程中打开的应用和数据不被恢复，下面的例子首先使用"appium:noReset": True 建立会话连接，并打开联系人应用。随后关闭该会话，新建一个会话（不打开任何应用），进入之后页面仍保留在联系人应用上。

# -*- coding: utf-8 -*-

import pytest

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.appium_service import AppiumService

# 开启服务端
APPIUM_HOST = '127.0.0.1'
APPIUM_PORT = 4723
@pytest.fixture(scope="session")
def start_appium_service():
    server = AppiumService()
    server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
    yield server
    server.stop()

def test_open_contact(start_appium_service):
    # 创建一个会话连接，打开联系人应用
    # noReset设置为True，会话退出后不会清零应用
    custom_opts_noreset = {
        "appium:noReset" : True,
        "appPackage": "com.google.android.dialer",
        "appActivity": ".extensions.GoogleDialtactsActivity"
    }
    driver = create_appium_session_by_api(custom_opts_noreset)
    driver.quit() # 模拟会话终止

    # 创建一个新的会话连接，不做具体动作
    driver = create_appium_session_by_api()
    # 由于前一个会话未清理应用，因此该会话连接之后，被测设备仍停留在联系人应用界面
    assert driver.current_activity == ".extensions.GoogleDialtactsActivity"