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 流程的高级视图:
- 读取配置文件
- 创建控制器
- 顺序执行测试类
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()
。 ...
- 销毁控制器
准备安卓设备
- 允许USB调试
- 启用开发者模式-进入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