协议功能

一种使用特定语言的协议。

library fuchsia.examples;

const MAX_STRING_LENGTH uint64 = 32;

@discoverable
protocol Echo {
    EchoString(struct {
        value string:MAX_STRING_LENGTH;
    }) -> (struct {
        response string:MAX_STRING_LENGTH;
    });
    SendString(struct {
        value string:MAX_STRING_LENGTH;
    });
    -> OnString(struct {
        response string:MAX_STRING_LENGTH;
    });
};

并从其他组件的命名空间中使用这些数据。

提供协议功能

如需提供协议功能,组件必须声明该功能并从 self 路由该功能。该组件在其出站目录中托管协议功能。

如需定义该 capability,请为其添加 capabilities 声明:

{
    capabilities: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
        },
    ],
}

这定义了此组件托管的 capability,其传出目录路径为 /svc/fuchsia.example.ExampleProtocol。您还可以自定义路径:

{
    capabilities: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            path: "/my_svc/fuchsia.example.MyExampleProtocol",
        },
    ],
}

路由协议功能

组件通过向其父级公开协议功能并向其子级提供协议功能来路由协议功能。

如需详细了解该框架如何路由组件功能,请参阅功能路由

公开

公开协议功能可让组件的父级访问该功能:

{
    expose: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            from: "self",
        },
    ],
}

from: "self" 指令表示此组件提供协议功能。

成为协作者

提供协议功能可让子组件访问该功能:

{
    offer: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            from: "self",
            to: [ "#child-a", "#child_b" ],
        },
    ],
}

使用协议功能

如需使用协议功能,组件必须请求该功能,并在其

如需请求该 capability,请为其添加 use 声明:

{
    use: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
        },
    ],
}

这会在组件的命名空间中以众所周知的路径 /svc/fuchsia.example.ExampleProtocol 填充该协议。您还可以自定义路径:

{
    use: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            path: "/my_svc/fuchsia.example.MyExampleProtocol",
        },
    ],
}

如需详细了解打开请求,请参阅协议打开的生命周期

使用可选协议功能

请参阅 Connect 组件:使用可选功能

框架协议

框架协议是组件框架提供的协议。任何组件都可以通过将 framework 设置为来源来 use 这些功能,而无需从其父级附加 offer。Fuchsia 支持以下框架协议:

{
    use: [
        {
            protocol: "fuchsia.component.Realm",
            from: "framework",
        },
    ],
}