Appium UiAutomator2驱动：被测应用(APP)能

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

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

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

一、被测应用(APP)能力

如下参数主要是用于操作被测设备上对被测应用。

APP本地化能力集：

二、能力解析

• 关于Android中activity和intent的概念

  activity : activity是Android应用程序的核心和基础概念，这里翻译成活动。可以把Android应用看成是一系列活动组成的，每个活动都可以进入和退出。活动可以简单类比成当前呈现出来的"屏幕"，在当前屏幕中呈现出来的各种界面元素共同组成一个活动。要从当前屏幕呈现的界面切换到下一个，需要启动一个新的活动。从当前活动切换到下一个活动，并不局限只能在一个应用中，切换活动后，造成的结果可能是启动了一个新的应用。活动概念被设计出来主要是方便应用之间传递信息或复用。比如摄像机拍摄活动可以被各种应用启动，而不需要每个应用在需要改功能的时候单独去写一个摄像机拍摄的功能。如果已经连接上Android设备，可以使用adb提供的am命令（Activity Manger的缩写）来启动一个活动（-n参数指定名称），例如启动联系人列表：

  adb shell am start -n com.google.android.dialer/.extensions.GoogleDialtactsActivity

  intent：活动都是通过intent来启动的，这里翻译成意图，意图有两种类型：显式意图和隐式意图。显式意图是通过应用的名称和活动的名称（在应用的manifest文件中申明）来启动一个活动；隐式意图用于在单个应用内进行活动的切换。

  显式意图是直接指定应用的名称和活动的名称来启动一个活动；隐式意图则是通过已定义好用户意图来启动活动，例如指定启动活动的意图是android.intent.action.SET_WALLPAPER，那么Android系统会在设备上查找所有应用的所有活动，找到申请支持该意图的活动，然后启动该活动。如果找到支持意图的活动只有一个，那直接启动该活动即可，如果找到支持该意图的活动有多个呢？Android会所有支持该意图的活动弹出来让用户进行选择。在本文使用的模拟器设备上，执行adb shell am start -a android.intent.action.SET_WALLPAPER(-a参数表明这是一个动作意图)会出现3个支持该意图的活动供选择。

  更多细节可以参考文章What Appium Users Need to Know about Android Activities and Intents

  关于意图的更多参数介绍请参考这里。

• 通过设置appium:appPackage 和appium:appActivity启动一个指定应用

    # -*- coding: utf-8 -*-
    
    import pytest
    
    from appium import webdriver
    from appium.options.android import UiAutomator2Options
    from appium.webdriver.appium_service import AppiumService
    
    import time
    import datetime
    
    # 开启服务端
    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_api(custom_opts = None):
     options = UiAutomator2Options()
     if custom_opts is not None:
     options.load_capabilities(custom_opts)
     return webdriver.Remote(f'http://{AP_intentPIUM_HOST}:{APPIUM_PORT}', options=options)
    
    def test_app_capability_explicit_intent(start_appium_service):
     driver = create_appium_session_by_api()
     driver.start_activity("com.google.android.dialer", ".extensions.GoogleDialtactsActivity")

• 通过appium:appWaitActivity和appium:appWaitPackage等待第一个被启动的应用和活动

  下面的代码会等待消息发送应用和活动打开，如果一直未等到该界面打开，那么会提示超时异常（超时时间通过appium:appWaitDuration指定，默认是20S），因此在启动下面的测试后，在超时时间之内，需要在命令行执行adb shell am start -n com.google.android.apps.messaging/.ui.ConversationListActivity以保证用例通过：

  def test_app_capability_appWaitActivity(start_appium_service):
     custom_opts = {
     "appium:appWaitPackage": "com.google.android.apps.messaging",
     "appium:appWaitActivity": ".ui.ConversationListActivity",
     }
     driver = create_appium_session_by_api(custom_opts)
     assert driver.current_activity == custom_opts["appium:appWaitActivity"]

  实际上，appium:appWaitActivity和appium:appWaitPackage支持通配符处理。

• 强制关闭被测应用

  def test_app_capability_closeAppAfterSession(start_appium_service):
     custom_opts = {
     "appium:noReset": True,
     "appium:appPackage": "com.google.android.apps.messaging",
     "appium:appActivity": ".ui.ConversationListActivity",
    
     "appium:shouldTerminateApp": True
     }
     driver = create_appium_session_by_api(custom_opts)
     assert driver.current_activity == custom_opts["appium:appActivity"]
     driver.quit()
    
     # 被测应用在上一步会话退出时已经被关闭了
     driver = create_appium_session_by_api({"appium:noReset": True})
     assert driver.current_activity != custom_opts["appium:appActivity"]