android官网译文《CTS Development》-cts的二次开发
android官网译文《CTS Development》-cts的二次开发
译文地址
初始化您的Repo客户端
按照说明获取和构建Android源代码，当使用repo init命令时，需要为CTS分支指定一个特定的名称，例如-b android-5.0_r2。这样CTS的修改才会下当前以及之后的版本生效。
构建以及运行cts
执行以下命令来构建CTS和启动交互式CTS控制台：
提示：使用AOSP x86_64的或AOSP MIPS来指定TARGET_PRODUCT，用于搭建不同的架构：
`cd /path/to/android/root
make cts -j32 TARGET_PRODUCT=aosp_arm64
cts-tradefed`
在cts-tf控制台中输入：
run cts --plan CTS
编写cts测试用例
CTS测试使用JUnit和Android Test API。如果要执行cts/tests目录下的测试用例，请先参照文档Testing and Instrumentation，cts测试大部分遵从以下条件：
* 必须考虑到不同的屏幕大小，方向，和键盘布局。
* 仅使用公共API方法。避免使用所有加上hide注解的的类，方法和字段。
* 避免依赖于特定视图布局或依赖于特定的尺寸资源。
* 不要依赖root权限
大多数CTS测试用例都是针对Android API中的某个类而言的。这些测试的包名统一使用cts作为后缀，测试类统一使用Test所为后缀。每一个测试用例包含一系列的测试项，每一项通常用来测试API的方法或者类。这些测试均按文件夹分类存放（比如widget或者views）
比如，存放在目录cts/tests/tests/widget/src/android/widget/cts下的android.widget.cts.TextViewTest是针对android.widget.TextView类的cts测试，测试包的名称为android.widget.cts，测试类的名称为TextViewTest。TextViewTest类中的testSetText方法用于测试setText方法，testSetSingleLine方法用于测试setSingleLine方法每项测试都加上了@TestTargetNew的注解，用于表面涵盖哪些测试。
一些cts测试虽然也放在相关的包中但是并不是直接用于API类的测试，
例如，在CTS测试，在android.net.cts包下的android.net.cts.ListeningPortsTest，虽然并没有对应的被测试类android.net.ListeningPorts，但因为它是与网络相关的，所以依然也存放到该包下。您还可以根据需要创建一个新的测试包。例如，有一个android.security测试包为与安全相关的测试。因此，添加新的测试时，尽量根据这种方法去命名和存放你的测试包。
最后，虽然很多的测试都使用@TestTargets和@TestTargetNew进行注解。但对于新添加的测试而言，并没有必要去添加这些注解。
测试的名称以及位置
新建一个测试包样例
在新建一个测试包的时候，也许当前并没有对应的目录存放你的测试包，这种情况下，需要参照cts/tests/tests/example中的样例去新建一个目录。
此外，请务必确保将新包的模块名已经添加到cts/CtsTestCaseList.mk文件的CTS_COVERAGE_TEST_CASE_LIST中，
这个Makefile被build/core/tasks/cts.mk调用，最后将所有测试合并以创建最终的CTS包。
测试的修复以及移除
除了添加新的测试意外，通过注解BrokenTest或KnownFailure修改或去除测试。
提交你的修改
按照Submitting Patches workflow提交cts的修改，提交前需要对你的修改进行审视。
发布以及分支信息
cts的发布需要遵从以下时间安排：
提示：这个时间安排只是暂定的，随时都可能更新。
| Version | Branch | Frequency |
|---|---|---|
| 6.0 | marshmallow-cts-dev | Monthly |
| 5.1 | lollipop-mr1-cts-dev | Monthly |
| 5.0 | lollipop-cts-dev | Monthly |
| 4.4 | kitkat-cts-dev | No releases planned |
| 4.3 | jb-mr2-cts-dev | No releases planned |
| 4.2 | jb-mr1.1-cts-dev | No releases planned |
几个重要的日期
- 结束后的第一周代码冻结。此时，当前分支的任何修改均无法提交，下一个cts版本也不会包含任何修改，一旦确定了发布候选日期，分支接口才会重新开发并且接受新的提交。
- 第二、三周：cts会在Android 开源项目上发布
自动合并
CTS分支开发中，每个分支的更改会自动合并：
jb-dev-> jb-mr1.1-cts-dev -> jb-mr2-cts-dev -> kitkat-cts-dev -> lollipop-cts-dev -> lollipop-mr1-cts-dev ->
如果变更列表（CL）没有正确合并时，CL的作者将收到一封冲突解决说明的电子邮件。在大多数的情况下，CL的作者可以使用该说明解决合并时的冲突。