【Android】Android 通信测试套件

Android Comms 测试套件是一个基于 Python 的轻量级自动化工具集，用于对当前和即将推出的 Android 设备执行自动化测试。它提供了一个简单的执行接口；一组可插入库，用于访问商用设备、Android 设备和一组实用函数，以进一步简化测试开发。它是无线堆栈开发人员或集成商的理想桌面工具，无论是练习新代码路径、执行置信度测试还是运行扩展回归测试套件。

tests/google 目录中包含一组测试，其中许多测试只需一台或两台具有 wifi、蜂窝或蓝牙连接的 Android 设备即可运行，包括：

Wifi 测试接入点互操作性、企业服务器集成、WiFi 扫描、WiFi 自动加入和往返时间。
针对低功耗、GATT、SPP 和绑定的蓝牙测试。
针对电路交换和 IMS 呼叫、数据连接、消息传递、网络交换和 WiFi 热点的蜂窝测试。
ACTS 遵循 Google Open-source Python Style Guide，推荐用于所有新的测试用例。

• 系统环境：
  adb
  python3.4+
  python3.4-setuptools
• Python 依赖项（由 setup.py 自动安装）：
  future
  pyserial

运行单元测试： $ python3 setup.py test $ python setup.py test
https://android.googlesource.com/platform/tools/test/connectivity/+/master/acts/framework/acts

ACTS 执行流程概览

以下是 ACTS 流程的高级视图：

1. 读取配置文件
2. 创建控制器
3. 顺序执行测试类

FooTest.setup_class() 
FooTest.setup_test() 
FooTest.test_A() 
FooTest.teardown_test() 
FooTest.setup_test() 
FooTest.test_B() 
FooTest.teardown_test() 
.... 
FooTest.teardown_class() 
BarTest.setup_class() 
。 ...

4. 销毁控制器

准备安卓设备

1. 允许USB调试
2. 启用开发者模式-进入setting->about 重复点击内部版本号，直到显示“您现在是开发人员”。在开发者模式下将设备插入计算机（主机）> $adb devices
   可能会显示一个弹出窗口，要求允许主机访问 android 设备。勾选“始终”框并单击“是”。

行为设置

安装系统依赖项。在 Ubuntu 上，sudo apt-get install python3.4 python3-setuptools
使用提升的权限运行“python3.4 setup.py install”
要验证 ACTS 已准备就绪，请在 README 的位置运行

cd framework/tests/
&& act.py -c acts_confidence_test_config.json -tc IntegrationTest
#act.py: 是运行测试的脚本
#-c acts_confidence_test_config：是测试中要使用的配置文件的标志和名称
#-tc IntegrationTest：是测试用例的名称

安装后，act.py将在 usr/bin 中，可以作为命令行实用程序调用。ACTS 中的组件可以在“acts”包下导入。在 Python 中，例如：

$ python 
>>> from acts.controllers import android_device 
>>> device_list = android_device.get_all_instances()

分解示例命令

测试中要使用的配置文件
要运行测试，必须通过 json 格式的文本文件提供所需信息。所需信息包括测试台配置列表。每个都指定硬件、服务、日志目录的路径以及 python 测试用例文件所在的路径列表。以下是示例配置文件的内容：

{ "_description": "This is an example skeleton test configuration file.", 
    "testbed": 
    [ 
        { 
            "_description": "Sample testbed with no devices", 
            "name": "SampleTestBed" 
        } 
    ], 
    "logpath": " /tmp/logs", 
    "testpaths": ["../tests/sample"], 
    "custom_param1": {"favorite_food": "Icecream!"} 
}

测试路径和日志路径键可以交替地通过执行环境分别通过ACTS_TESTPATHS和ACTS_LOGPATH键提供。要指定多个测试路径，密钥应遵循标准的“:”分隔格式。配置文件中的显式密钥将覆盖环境提供的任何默认值。

测试类
测试类是用“控制器”字典实例化的。控制器字典包含提供给测试类的所有资源，并根据提供的配置文件创建。

测试类还必须包含一个可迭代成员 self.tests，它列出了类中的测试用例名称。在以下代码片段之后讨论了更多相关内容。

从 acts.base_test 导入 BaseTestClass

类 SampleTest(BaseTestClass): 

    def __init__(self, controllers): 
        BaseTestClass.__init__(self, controllers) 
        self.tests = ( 
            "test_make_toast", 
        ) 

    """Tests""" 
    def test_make_toast(self) ：
        对于 self.android_devices 中的广告：
            ad.droid.makeToast("Hello World.")
        返回 True

默认情况下，将运行测试类的 self.tests 中列出的所有测试用例。使用下面的语法将通过仅执行测试类中的特定测试来覆盖默认行为。
以下将运行单个测试 test_make_toast：
$ act.py -c sample_config.txt -tb SampleTestBed -tc SampleTest:test_make_toast
可以使用逗号分隔列表指定多个测试。以下将执行 test_make_toast 和 test_make_bagel：
$ act.py -c sample_config.txt -tb SampleTestBed -tc SampleTest:test_make_toast,test_make_bagel