此页面由 Cloud Translation API 翻译。

由开发者提供支持的 CTS

本页概述了开发人员支持的 CTS (CTS-D) 的使用指南。

测试覆盖率

CTS-D 与 CTS 和 CTS Verifier 一样，只能强制执行以下内容：

非必须要求（例如“强烈建议”、“应该”、“可以”）是可选的，无法使用 CTS 进行测试。

由于所有 API 和 CDD 要求都与特定的 API 级别相关联，因此所有 CTS 测试（CTS、CTS-D 和 CTS Verifier）都与与其关联的 API 或要求相同的 API 级别相关联。如果特定 API 被弃用或更改，则必须弃用或更新其相应的测试。

以下是用于测试应用程序限制的一组测试条件示例：

我们接受新的测试，这些测试强制执行现有 CTS、CTS 验证程序或 CTS-D 测试未测试的行为。任何检查超出我们测试覆盖范围的行为的测试都将被拒绝。

编写测试提案：应用程序开发人员使用Google Issue Tracker提交测试提案，描述已识别的问题并提出测试来检查问题。该提案必须包含关联的CDD 要求 ID 。 Android 团队审核该提案。
开发 CTS 测试：提案获得批准后，其提交者在主（AOSP/主）分支上的 AOSP 上创建 CTS 测试。 Android 团队审查代码。
发布测试：在AOSP/main上提交您的 CL，然后将其挑选到最新的androidx-tests-dev分支。该测试现已公开。

遵循Java 代码风格指南。
请遵循CTS 开发中描述的所有步骤。
将您的测试添加到适当的测试计划中：
- 使用include-filters将新测试添加到 CTS-D 测试计划中： platform/cts/tools/cts-tradefed/res/config/cts-developer.xml 。
- 使用exclude-filters将新测试从主 CTS 测试计划中排除： platform/cts/tools/cts-tradefed/res/config/cts-developer-exclude.xml 。
处理build_error.log中所有errorprone警告和建议。
将您的更改重新设置为head 。这包括cts-developer.xml和cts-developer-exclude.xml测试计划。
与您的 Google 工程联系人合作，确定您的测试用例是否可以包含在现有的 CTS 模块中。如果不能，他们会帮助您创建一个新模块。
对于创建的每个新测试模块，在新测试模块目录中创建一个 OWNERS 文件。
- 您的 OWNERS 文件应包含从与您合作的 Google 测试所有者处获得的以下信息：
- # Bug component: xxx
- Google 测试所有者 ldap
在AndroidTest.xml中，指定以下参数。请参阅示例文件 ( 1 , 2 ) 作为示例：
- Instant_app或not_instant_app
- secondary_user或not_secondary_user
- all_foldable_states或no_foldable_states
要指定正确的 minSDK，请参阅<uses-sdk> 文档。
签入新的测试方法、类或模块时，将它们添加到 CTS-D 测试计划中，并以与新测试相同的方式将它们从主 CTS 测试计划中排除。

使用run cts --plan cts-developer从命令行运行 CTS-D 测试计划。

要运行特定测试用例，请使用run cts --include-filter "test_module_name test_name" 。

有关运行完整 CTS 的信息，请参阅运行 CTS 测试。

提交测试请求后，内部团队将对其进行审核，以确保它测试 CDD 要求或记录的 API 行为。如果确定测试是为了检查有效的要求或行为，团队会将此测试用例转发给 Google 工程师进行进一步审查。 Google 工程师将与您联系，提供有关如何改进测试的反馈，然后才能被 CTS 接受。