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
发出路由功能。
如需定义该功能,请为其添加 capabilities
声明:
{
capabilities: [
{
protocol: "fuchsia.example.ExampleProtocol",
},
],
}
定义了传出目录路径为 /svc/fuchsia.example.ExampleProtocol
的此组件托管的功能。您还可以自定义路径:
{
capabilities: [
{
protocol: "fuchsia.example.ExampleProtocol",
path: "/my_svc/fuchsia.example.MyExampleProtocol",
},
],
}
路由协议功能
通过将路由协议功能exposing给父级并提供给子级,组件实现这些功能。
如需详细了解框架如何路由组件功能,请参阅功能路由。
正在曝光
公开协议 capability 可让组件的父项使用该功能:
{
expose: [
{
protocol: "fuchsia.example.ExampleProtocol",
from: "self",
},
],
}
from: "self"
指令表示协议功能由此组件提供。
成为协作者
提供协议功能可让子组件使用该功能:
{
offer: [
{
protocol: "fuchsia.example.ExampleProtocol",
from: "self",
to: [ "#child-a", "#child_b" ],
},
],
}
使用协议功能
如需请求该功能,请为其添加 use
声明:
{
use: [
{
protocol: "fuchsia.example.ExampleProtocol",
},
],
}
这会将相关协议填充到组件命名空间中的已知路径 /svc/fuchsia.example.ExampleProtocol
下。您还可以自定义路径:
{
use: [
{
protocol: "fuchsia.example.ExampleProtocol",
path: "/my_svc/fuchsia.example.MyExampleProtocol",
},
],
}
如需详细了解未解决的请求,请参阅协议打开的生命周期。
使用可选的协议功能
请参阅连接组件:使用可选功能。
框架协议
框架协议是由组件框架提供的协议。
任何组件都可以通过将 framework
设置为来源(无需其父组件中附带 offer
)来 use
这些功能。Fuchsia 支持以下框架协议:
fuchsia.component.Realm
:允许组件管理和绑定到其子项。作用域限定为组件的领域。fuchsia.component.Binder
:允许一个组件启动另一个组件。
{
use: [
{
protocol: "fuchsia.component.Realm",
from: "framework",
},
],
}