fuchsia.testing.harness

添加时间：20

协议

RealmProxy

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

此协议可调解测试套件对被测组件的访问权限。

RealmProxy 是一种自动化测试框架，允许某个测试套件创建实例 按需测试组件的全貌。最重要的是 不必知道具体创建了哪些组件或创建方式； 只需知道组件公开的功能。

例如，用于 Fuchsia 文件系统的通用测试套件可以使用 RealmProxy 生成提供 fuchsia.io FIDL 协议的组件的协议 库。测试套件不需要知道正在测试哪个文件系统 或文件系统的初始化方式。它只需调用 将 [ConnectToNamedProtocol] 替换为 fuchsia.io 协议的名称， 测试。使用不同的代理来运行此测试套件 不同的文件系统，因此可以使用同一个套件来验证每个系统。

警告：RealmProxy 即将被弃用。希望将 fuchsia.component.sandbox.DictionaryRef 并将其安装到您的命名空间。

添加时间：23

ConnectToNamedProtocol

将 [server_end] 连接到此代理的命名空间中的 [protocol]。

请求

名称类型
protocol string[255]
server_end handle<channel>

响应

名称类型
payload RealmProxy_ConnectToNamedProtocol_Result

ConnectToServiceInstance

将 [server_end] 连接到此代理的命名空间中的 [service]/[instance]。

请求

名称类型
service string[255]
instance string[255]
server_end handle<channel>

响应

名称类型
payload RealmProxy_ConnectToServiceInstance_Result

OpenService

将 [server_end] 连接到此代理的命名空间中的 [service] 目录。

请求

名称类型
service string[255]
server_end handle<channel>

响应

名称类型
payload RealmProxy_OpenService_Result

结构体

RealmProxy_ConnectToNamedProtocol_Response

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

<空>

RealmProxy_ConnectToServiceInstance_Response

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

<空>

RealmProxy_OpenService_Response

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

<空>

精英

OperationError 柔性

类型：uint32

在 fuchsia.testing.harness/errors.fidl 中定义

Fuchsia 自动化测试框架操作错误类型。

自动化测试框架负责保持特定测试运行的状态。 当操作失败时，系统将返回此类型。

名称值说明
0

请求的操作无效。

当测试用例要求自动化测试框架执行相关操作时，系统将返回此代码 与自动化测试框架不兼容的信息”状态这个 error 表示测试代码本身存在 bug。

返回此值必须通过相应的测试。

示例：测试在文件创建之前询问其大小。
1

请求的操作失败。

当自动化测试框架无法完成时，会返回此值 操作，即使当前状态本应允许执行 操作有效。此错误表示 自动化测试框架的依赖项

返回此值必须通过相应的测试。

示例：测试在请求文件后 但查询失败了。
2

自动化测试框架不支持所请求的操作。

当自动化测试框架不支持 请求的操作。这不一定是严重错误 用于表示自动化测试框架了解 但并未实现该行为

返回此值可能会无法通过相应的测试， 不需要。这个返回值有助于确定 与不同功能集或版本的兼容性。

示例：测试要求提供文件大小，但功能 检查文件大小已从上一个组件中移除 版本。

联合体

RealmProxy_ConnectToNamedProtocol_Result 严格

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

Ordinal变体类型说明
response RealmProxy_ConnectToNamedProtocol_Response
err OperationError

RealmProxy_ConnectToServiceInstance_Result strict

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

Ordinal变体类型说明
response RealmProxy_ConnectToServiceInstance_Response
err OperationError

RealmProxy_OpenService_Result

在 fuchsia.testing.harness/realm_proxy.fidl 中定义

Ordinal变体类型说明
response RealmProxy_OpenService_Response
err OperationError

常量

名称值类型说明
MAX_PROTOCOL_LEN fuchsia.io/MAX_NAME_LENGTH uint64

FIDL 协议名称中允许的字符数上限。 此值设为文件系统节点名称的最大长度，因为 我们通常会使用文件系统进行协议发现。

添加时间：23