fuchsia.test.manager

Directory 频道，用于提供对目录的访问权限。release_fence 关闭后，不应使用此渠道。

用于控制目录保留的事件对句柄。当此句柄关闭时，目录将不再保留。

RESOURCE_UNAVAILABLE

资源不足，无法执行操作。

INSTANCE_CANNOT_RESOLVE

无法解析 test_suite_url。

INVALID_ARGS

传递的参数无效。

FAILED_TO_CONNECT_TO_TEST_SUITE

未能连接到测试应公开的 fuchsia.test.TestSuite。

CASE_ENUMERATION

未能枚举测试。

INTERNAL_ERROR

发生了一些内部错误。测试管理器设置出现问题。 检查日志并报告 bug。

NO_MATCHING_CASES

没有与指定测试过滤条件匹配的测试用例。仅当指定了测试过滤条件时，系统才会返回此错误。如果测试套件没有测试用例，则该套件将通过。

INVALID_MANIFEST

测试清单无效。

BATCH

表示使用 fuchsia.diagnostics.BatchIterator。此迭代器类型采用 VMO，可在本地实现最佳性能，但无法远程使用（例如，从主机使用）。选择此类型后，log 类型的制品将具有使用 Syslog 联合体的 batch 变体的值。

SOCKET

指示使用 fuchsia.diagnostics.host.ArchiveAccessor 中所述的套接字。 可以远程使用（例如，从主机）。选择此类型后，log 类型的制品将具有使用 Syslog 联合体的 stream 变体的值。

FINISHED

套件正常完成，所有测试用例结果均为 SKIPPED 或 PASSED。

失败

套件正常完成，但部分测试用例结果既不是 SKIPPED，也不是 PASSED。

DID_NOT_FINISH

套件实现崩溃、未发送 Finish 事件，或未报告一个或多个测试用例的测试用例结果。

TIMED_OUT

整个套件运行超时。

已停止

套件运行已停止。

INTERNAL_ERROR

已跳过

测试用例已跳过。

通过

测试用例已通过。

失败

测试用例失败。

TIMED_OUT

测试用例超时。

ERROR

套件实现未返回测试用例的结果。

1

生成该目录的组件的 moniker（相对于测试领域的根目录）。

2

包含工件的目录。

1

文件名称。每个 DebugDataIterator 必须是唯一的。

2

可通过其访问文件的套接字。

1

指定要在其中枚举测试用例的领域。如果未提供此字段，测试用例将在测试管理器内的封闭领域中枚举。需要非封闭领域或具有自定义运行程序的测试领域的客户端会使用此选项。

1

事件发生的时间。

2

事件的详细信息。

1

包含要在其中启动测试的集合的领域。必须填写此字段。

2

从领域到测试集合的所有优惠。必须填写此字段。

3

要在其中启动测试的测试集合。必须填写此字段。

1

指定要在其中运行测试套件的领域。如果未提供此字段，测试将在测试管理器内的封闭领域中运行。需要非封闭领域或具有自定义运行程序的测试领域的客户端会使用此选项。

2

如果设置为 true，则即使测试用例已被测试作者停用，也会执行。此值默认为 false。

3

定义要并发运行的测试用例数上限。如果未指定，则由测试套件组件决定此值。

4

要传递给测试的命令行参数。测试运行程序决定如何将这些参数传递给测试。默认情况下，此值为空矢量（无参数）。

5

整个套件运行的超时时间。如果未指定，则没有超时，套件运行可能会无限期挂起。

6

测试用例过滤条件，采用 glob 模式 [https://en.wikipedia.org/wiki/Glob_(programming)]。 您可以通过在前面添加“-”来指定排除性过滤条件。默认情况下，此值为空向量（无过滤条件）。

如果同时满足以下两个条件，则会运行给定的测试用例：

• 未指定正向过滤条件，或者测试用例与某个正向过滤条件匹配。
• 测试用例与任何指定的否定过滤条件都不匹配。

例如，假设某个套件包含测试用例 Foo.Test1、Foo.Test2、Bar.Test1 和 Bar.Test2：

• 过滤条件 ["Foo.*"] 将执行 Foo.Test1 和 Foo.Test2。
• 过滤条件 ["-Foo.*"] 将执行 Bar.Test1 和 Bar.Test2。
• 过滤器 ["Foo.*", "-*.Test1"] 将执行 Foo.Test2。

7

指定客户端将使用哪种迭代器来检索日志。默认情况下，此值为 BATCH。

8

配置在过滤来自测试套件组件的日志时要应用的最低严重级别。

9

如果设置为 true，则为此运行收集的调试数据将累积在测试管理器的 tmp 文件夹中，并与之前运行中收集的调试数据（此标志设置为 true）一起累积。默认值为 false。

当批量运行多个测试时，可以使用此选项，因为一次性提供累积数据比一次提供一个测试的调试数据更高效。

10

如果为 true，则表示测试会创建异常渠道。在这种情况下，测试管理器将避免创建自己的异常渠道，以避免冲突。默认值为 false。

11

如果为 true，则测试运行程序应在遇到失败时停止（如果支持）测试套件，以便调试程序将来可以附加到进程。如果测试运行程序不支持停止运行测试套件，则可以放心地忽略此操作。

1

描述制品。此字段始终会提供。

1

套件结果。此字段始终会提供。

1

测试用例的名称。

1

此事件所属的测试用例。此事件之前会有一个具有匹配 ID 的“test_case found”事件。此字段始终会提供。

2

描述制品。此字段始终会提供。

1

此事件所属的测试用例。此事件之前会有一个具有匹配 ID 的“test_case found”事件。此字段始终会提供。

1

找到的测试用例的名称。此字段始终会提供。

2

在后续事件中标识此测试用例。此字段始终会提供，并且对于给定的 SuiteController 是唯一的。

1

此事件所属的测试用例。此事件之前会有一个具有匹配 ID 的“test_case found”事件。此字段始终会提供。

1

此事件所属的测试用例。此事件之前会有一个具有匹配 ID 的“test_case found”事件。此字段始终会提供。

2

测试用例结果。此字段始终会提供。

1

该工件是套件或测试用例的“stdout”流。工件通过套接字传送，此处提供的是套接字的消费者端。

2

该工件是套件或测试用例的“stderr”流。工件通过套接字传送，此处提供的是套接字的消费者端。

3

该工件是套件或测试用例的 syslog。工件通过批处理迭代器或套接字交付。

4

制品是目录中的一个或多个文件，可以使用 fuchsia.io 读取。

5

这些工件是使用 DebugDataIterator 渠道提供的调试数据。

1

套件已开始执行。suite_artifact_generated 事件可能会在此事件之前发生。

2

找到了一个测试用例。这始终是给定测试用例的第一个事件。

3

测试用例已开始执行。对于给定的测试用例，只会生成一个 test_case_started 事件，并且该事件始终在相应测试用例的 test_case_stopped 事件之前发生。 测试用例的 test_case_artifact_generated 事件可能会在此事件之前发生。

4

测试用例中的工件。请注意，给定测试用例的 test_case_artifact_generated 事件可能会在 test_case_started 之前和 test_case_stopped 之后发生。

5

测试用例已停止执行。此事件包含测试用例的最终 TestCaseResult。 此事件之后可能会发生 test_case_artifact_generated 个与该支持请求相关的事件。

6

测试用例已完成，所有工件事件均已分派给客户端。这始终是给定测试用例的最后一个事件。

7

与整个套件相关的工件。

8

套件运行已停止执行。此事件包含套件的最终 SuiteResult。 此事件之后可能会发生 suite_artifact_generated 事件。

2

当 Fuchsia 客户端使用此协议时，迭代器的服务器端。

3

当主机端客户端使用此协议时，迭代器的服务器端。 这会使用 fuchsia.diagnostics.host.ArchiveReader 中指定的协议。

1

2

2

Fuchsia 客户端使用的迭代器的客户端。

3

主机端客户端使用的套接字的消费者端。

1

2

3

测试用例标识符。在套件运行中是唯一的。

测试用例的人类可读名称。