fuchsia.component.decl

由父级分配给子级的名称。如果设置了 collection，则 name 的作用域限定为 collection，并且子项为动态实例。

name 所属的集合。如果省略，name 会引用静态实例。如果组件声明中使用了 ChildRef，则必须省略此字段。可选。

源实例中使用的名称。

目标实例中使用的名称。

STATIC_ONLY

只有静态优惠可以定位到集合中的组件。“静态优惠”是指 ComponentDecl 中面向集合本身的优惠。

这是默认行为。

STATIC_AND_DYNAMIC

静态优惠和动态优惠都可以定位到集合中的组件。“静态优惠”是指 ComponentDecl 中面向合集本身的优惠。“动态优惠”是在运行时传递给 CreateChild 的附加优惠。

必需

该功能必须可用。未能路由该 capability 就是错误。

可选

在 use 声明中：如果组件无法获取相应 capability，则可以正常运行。

在优惠/公开声明内：该功能在某些系统配置中可能不可用。因此，目标组件不得依赖于相应 capability。

SAME_AS_TARGET

如果相应优惠或公开声明的目标需要该 capability，则此行为相当于 required。如果目标对 capability 有可选依赖项，则该行为等同于可选属性。对于想要根据内部组件更改其路由可用性的容器组件而言，这非常有用。

不允许在 use 声明中使用此值。

过渡

来源可以完全省略路由，甚至无需从 void 进行路由。

TRANSITIONAL 用于引入新功能的软转换。

BOOL

UINT8

UINT16

UINT32

UINT64

INT8

INT16

INT32

INT64

字符串

视频

即时

一旦某些使用方组件请求该功能，框架就会立即打开该功能。

ON_READABLE

该框架将监控使用方组件所发出的连接请求的服务器端点上的 ZX_CHANNEL_READABLE 信号，并仅在服务器端点变为可读时从提供方组件的传出目录打开该功能。

强劲

强依赖项，使用它的组件可能需要该依赖项。

较差

能够形成循环的弱依赖项。使用弱依赖项的组件必须支持该依赖项在任意时间不可用。

即时

在父实例停止或明确销毁之前，实例会一直存在。

SINGLE_RUN

实例会在创建时启动，并在停止时立即销毁。

无

环境没有初始属性集。

领域

环境的初始属性集继承自其领域。继承属性包括 EnvironmentDecl 中定义的任何字段。

无

无操作，默认

重新启动

如果组件因任何原因终止，则触发系统正常重新启动。这是一项受组件框架安全政策控制的专用功能。

懒洋洋

仅当组件实例收到传入的功能请求或直接使用 fuchsia.component.Controller/Start 启动时，组件实例才会启动。

耳朵

在父组件启动时或创建组件时（对于动态组件）自动启动组件实例。

STATIC_INSTANCE_ID

隔离存储目录使用组件 ID 索引中指定的组件实例 ID 进行键控。未在索引中列出的组件无法使用或打开此存储功能。

STATIC_INSTANCE_ID_OR_MONIKER

隔离存储目录使用组件的实例 ID（如果在组件 ID 索引中指定）进行键控。否则，组件的存储功能名称将用于键控其隔离的存储目录。

1

（必需）由父级分配给子级的名称。

必须为非空，在所有同级项中具有唯一性，并且仅包含以下字符：[a-z0-9-_.]。

2

（必需）子组件的网址。

不得为空，且必须是格式正确的网址。

3

（必需）组件实例的启动模式。

必须设置。

4

（可选）分配给此子级的环境。

可以未设置，在这种情况下，子级将继承父级组件的环境。如果设置此参数，则该名称必须引用 ComponentDecl 中定义的环境，并且只能包含以下字符：[a-z0-9-_.]。

5

（可选，默认为 NONE）此组件实例意外终止时要执行的操作。

6

要应用于子级基本配置的配置替换。

若要替换配置字段，父级字段必须将其标记为可变。

父级必须传递与子级声明的架构类型完全匹配的 ConfigOverride 值。

1

（必需）集合的名称。在该集合中创建的实例的范围限定为此名称。

2

（必需）集合中实例的耐用性。

3

（可选）分配给此集合中的子实例的环境。

可以未设置；在这种情况下，此集合中的子级将继承父组件的环境。如果设置了此字段，则名称必须引用 ComponentDecl 中定义的环境，并且只能包含以下字符：[a-z0-9-_.]。

4

（可选，默认值为 STATIC_ONLY）可定位到此集合中的子实例的优惠类型。

只有使用 dynamic_offers 受限功能的组件才能设置此字段。

5

（可选，默认值为 false）此集合中的子实例的名称是否可以超过默认长度限制（100 个字符）。

只有使用 allow_long_names 受限功能的组件才能设置此字段。

6

（可选）动态子级实例及其后代使用的隔离存储空间中的数据在实例销毁后是否会保留。新的动态实例会继承先前实例的数据存储区。

此设置可被较低级别的集合替换，而后者是启用/停用此设置的集合的后代。

此设置适用于集合组件及其后代使用的所有存储空间。

默认值是继承自祖先集合的值（如果已设置），否则为 false。

1

（可选）有关在执行组件时运行的程序的信息。 对不可执行组件而言省略。

2

（可选）组件使用的功能列表。其中包括为组件提供的功能，这些功能安装在其传入命名空间中。

使用的功能必须是唯一且互不重叠的。

3

（可选）组件提供的功能列表。其中包括对父项可见的 capability。父级可以 offer 这些功能到其子级，但不能 use 它们。

提供的功能必须唯一且互不重叠。

4

（可选）为组件的子级提供的功能列表。这些层包含给定子项可以 use 的功能，这些能力可能来自子项、父项，或组件自己的传出命名空间。

提供的功能必须唯一且互不重叠。

5

（可选）组件定义的功能列表。

6

（可选）组件静态实例化的子项。子级必须具有唯一的名称。

7

（可选）组件的集合。集合的名称必须各不相同。

8

（可选）此组件创建的环境列表。 环境会分配给子级，并控制子级组件运行时的各个方面。

9

（可选）关于组件的其他元数据。

10

（可选）组件配置接口的架构。

1

（必需）此配置字段的标识符。 此键将用于匹配替换值。

2

（必需）配置值的类型。在构建和运行时，系统会根据此布局验证配置值。

3

此字段的值的运行时替换项的允许来源。

1

2

1

（必需）组件配置界面的有序字段。

2

（必需）配置声明的校验和。

3

（必需）用于解析配置值的策略。

1

1

组件配置的具体值。

2

配置架构的 SHA-256 校验和。必须与用于解析最终配置的组件清单和配置解析器库中的校验和匹配。

1

（必需）此配置的名称

2

（必需）此配置的值。

1

（必需）功能相对于组件本身的提供者。必须是 parent、self 或 child。

2

（必填）用于标识所提供的协议的名称。

3

（必需）提供 capability 的名称。

1

（必需）此字典的名称。

在内置功能中必须是唯一的。

2

（可选）用于初始化字典的内容来源。必须是 parent、self 或 child。

3

（可选）ref 提供的字典中的路径，其中包含将用于初始化字典的内容。

如果设置了 source，则必须设置此字段。

1

（必需）此目录的名称。

2

（可选）组件的传出目录中的目录路径。

未针对内置功能进行设置。

3

（必需）组件可使用此目录设置的最大权限。

1

（必需）此环境的名称。

2

（必需）指定如何构建此环境的初始状态。

3

（可选）此环境中可用的运行程序列表。

此列表决定了环境中任何组件可用的运行程序总数。

4

（可选）组件解析器及其注册用于解析的网址架构的列表。这些注册决定了如何在领域中解析组件。如果组件网址方案与任何解析器都不匹配，且此环境从 REALM 获取 extends，则网址解析将委托给父环境。

5

（可选）在组件管理器允许的情况下，向调试部分公开相应功能。

环境中的任何组件都可以通过带有 source == debug 的 use 声明来访问这些功能。此处只能声明旨在支持开发的功能，并且只有当明确包含在组件管理器许可名单中时，才允许使用这些功能。

6

（可选）组件在终止之前必须停止的时长（以毫秒为单位）。如果此环境从 NONE 处于 extends 状态，则需要。

1

（必需）此事件流的名称。

在内置功能中必须是唯一的。

1

（必需）要订阅的事件名称。

1

（必需）功能相对于组件本身的提供者。必须是 self、child 或 void。如果设置为 void，则目标必须公开、提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）标识将其呈现给此组件所用配置的名称。

3

（必需）公开 capability 的目的地。

4

（必需）公开功能时所用的名称。

5

（可选，默认为 REQUIRED）此功能的可用性。请参阅适用范围。

1

（必需）功能相对于组件本身的提供者。必须是 self、child 或 void。如果设置为 void，则目标必须公开、提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）用于标识呈现给此组件的字典的名称。

3

（必需）提供字典的目的地：组件的领域或框架。

4

（必需）公开功能时所用的名称。

5

（可选，默认为 REQUIRED）此功能的可用性。请参阅适用范围。

6

（可选）ref 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识嵌套在字典中的 capability。顶级字典的名称由 source_dictionary 的第一个路径段指定，source 应以此名称路由字典功能。路径的其余部分（可能为空）表示指向某个嵌套在顶级字典中的字典的路径，该字典应包含 source_name。

1

（必需）功能相对于组件本身的提供者。必须是 self、child 或 void。如果设置为 void，则目标必须公开、提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）用于标识将其呈现给此组件的目录的名称。

3

（必需）公开的目的地：组件的领域或框架。

4

（必需）公开功能时所用的名称。

5

（可选）组件可以使用此目录设置的最大权限。如果此政策未设置，“source”就会继承该权利。

6

（可选）要公开的此目录的子目录，而不是根目录。

7

（可选，默认为 REQUIRED）此功能的可用性。请参阅适用范围。

8

（可选）ref 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识嵌套在字典中的 capability。顶级字典的名称由 source_dictionary 的第一个路径段指定，source 应以此名称路由字典功能。路径的其余部分（可能为空）表示指向某个嵌套在顶级字典中的字典的路径，该字典应包含 source_name。

1

（必需）功能相对于组件本身的提供者。必须是 self、child 或 void。如果设置为 void，则目标必须公开、提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）标识将其呈现给此组件时所用的协议的名称。

3

（必需）提供协议的目的地：组件的领域或框架。

4

（必需）公开功能时所用的名称。

5

（可选，默认为 REQUIRED）此功能的可用性。请参阅适用范围。

6

（可选）ref 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识嵌套在字典中的 capability。顶级字典的名称由 source_dictionary 的第一个路径段指定，source 应以此名称路由字典功能。路径的其余部分（可能为空）表示指向某个嵌套在顶级字典中的字典的路径，该字典应包含 source_name。

1

（必需）功能相对于组件本身的提供者。必须为 self 或 child。

2

（必需）呈现给此组件的解析器的名称。

3

（必需）提供解析器的目的地

4

（必需）公开功能时所用的名称。

6

（可选）ref 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识嵌套在字典中的 capability。顶级字典的名称由 source_dictionary 的第一个路径段指定，source 应以此名称路由字典功能。路径的其余部分（可能为空）表示指向某个嵌套在顶级字典中的字典的路径，该字典应包含 source_name。

1

（必需）功能相对于组件本身的提供者。必须为 self 或 child。

2

（必需）呈现给此组件的运行程序的名称。

3

（必需）运行程序的目的地：组件的领域或框架。

4

（必需）公开功能时所用的名称。

6

（可选）ref 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识嵌套在字典中的 capability。顶级字典的名称由 source_dictionary 的第一个路径段指定，source 应以此名称路由字典功能。路径的其余部分（可能为空）表示指向某个嵌套在顶级字典中的字典的路径，该字典应包含 source_name。

1

（必需）功能相对于组件本身的提供者。必须是 self、child 或 void。如果设置为 void，则目标必须公开、提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）用于标识向其呈现该组件的服务的名称。

3

（必需）提供服务的目的地：组件的领域或框架。

4

（必需）公开功能时所用的名称。

5

（可选，默认为 REQUIRED）此功能的可用性。请参阅适用范围。

6

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必填）用于标识所提供的配置的名称。

3

（必需）对目标的引用。必须为 child 或 collection。

4

（必需）提供 capability 的名称。

5

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必填）用于标识所提供的字典的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供 capability 的名称。

5

（必需）此优惠所代表的依赖项类型。收到弱优惠的组件必须支持所提供的功能在任何时候都不可用。

6

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

7

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）用于标识所提供的目录的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供 capability 的名称。

5

（可选）组件可以使用此目录设置的最大权限。如果未设置此政策，“source”的相关权利就会继承下来。

6

（可选）要提供的此目录的子目录，而不是根目录。可选。

7

（必需）此优惠所代表的依赖项类型。收到弱优惠的组件必须支持所提供的功能在任何时候都不可用。

8

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

9

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须是 parent、framework、child 或 void。如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必填）所提供活动的名称。

3

（可选）如果从框架提供事件，该范围就是必需的，并且可用于定义与事件相关的子项（或子项数组）。如果事件是从父级提供，可以使用该范围将事件的作用域缩小到特定的子作用域，否则事件将具有来自父级的作用域。

4

（必需）提供事件流的目标位置。

5

（必填）提供事件流时所使用的名称。

7

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必填）用于标识所提供的协议的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供 capability 的名称。

5

（必需）此优惠所代表的依赖项类型。收到弱优惠的组件必须支持所提供的功能在任何时候都不可用。

6

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

7

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）提供的解析器的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供相应功能时所使用的名称。

5

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必需）提供的跑步者的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供相应功能时所使用的名称。

5

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

2

（必填）用于标识所提供的服务的名称。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必需）提供相应功能时所使用的名称。

5

（可选）要提供的已列入许可名单的实例的列表。目标组件将无法访问不在此列表中的服务实例。如果未设置，则意味着提供了来源服务中的所有实例。

6

（可选）要提供的已列入许可名单的实例的列表（可重命名）。

如果已设置此字段且非空，则目标服务中的实例集将仅限于此列表中的实例，并将 source_name 重命名为 target_name。

如果已设置此属性且非空，source_instance_filter 会进一步将这组实例限制为 target_name 出现在该列表中的实例。通常没有理由同时设置这两者，但为了保持兼容性，我们支持您进行设置。

7

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

8

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）提供的存储功能的名称

2

（必需）功能相对于组件本身的提供者。必须为 parent、self、child 或 void。 如果设置为 void，则目标必须提供或使用具有 OPTIONAL 或 TRANSITIONAL 可用性的功能。

3

（必需）对目标的引用。必须是 child、collection 或字典 capability。

4

（必填）提供存储功能的名称

5

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则目标可以使用或提供具有 required 或 optional 可用性的功能。如果设置为 optional，则目标必须使用或提供可用性为 optional 的功能。same_as_target 值会导致此优惠的可用性与目标中设置的可用性一致。

1

用于运行组件的运行程序的名称。必须与组件环境中的 RunnerRegistration 匹配。如果未提供此值，组件必须“使用”运行程序。 如果提供此值，组件可以“使用”运行程序，但运行程序必须完全相同（与环境中的名称一致）。

2

（必需）有关在执行组件时运行的程序的信息。在执行此程序时，组件管理器会向运行程序提供此字典的内容。

例如，该文件可能包含程序的可执行映像或程序参数的路径。

• 键表示命名空间属性，以“.”分隔。
• 属性可以嵌套在值中，但仅限于对象矢量。

1

（必需）此协议的名称。

2

（可选）组件的传出目录中的协议路径。

未针对内置功能进行设置。

3

（可选，默认值为 EAGER）指定当有人请求该 capability 时，框架何时将从此组件的传出目录打开协议。详见DeliveryType。

1

（必需）此解析器的名称。

在同一 ComponentDecl 中声明的解析器中必须是唯一的。

2

（可选）组件的传出目录中的解析器协议的路径

未针对内置功能进行设置。

1

（必需）解析器的名称。

2

（必需）功能相对于组件本身的提供者。必须是 parent、self 或 child。

3

（必需）注册解析器要处理的网址架构。一个解析器只能注册到一个特定的网址架构。网址架构必须以小写 ASCII 字母 (a-z) 开头，可以包含小写 ASCII 字母、数字、+、- 和 .。

1

（必需）此运行程序的名称。

在同一 ComponentDecl 中声明的运行程序之间必须唯一。

2

（可选）组件的传出目录中的运行程序协议的路径。

未针对内置功能进行设置。

1

（必需）向此组件公开、提供或定义的运行程序 capability 的名称。

2

（必需）功能相对于组件本身的提供者。必须是 parent、self 或 child。

3

（必需）在此环境中提供运行程序的名称。

1

（必需）此服务的名称。

2

（可选）组件的传出目录中的服务路径。

未针对内置功能进行设置。

1

（必需）此存储空间的名称

2

（必需）后备目录功能相对于组件本身的提供者。必须是 parent、self 或 child。

3

（必需）支持存储的 source 中目录功能的名称。

4

（可选）源目录的子目录（用于支持存储系统）

5

（必需）此枚举确定如何键控组件的隔离存储目录。每个选项都对应不同的键策略。

1

（必需）相对于组件本身的配置提供商。必须为 parent、self 和 child。

2

（必需）标识将其呈现给此组件所用配置的名称。

3

（必需）组件看到此配置的名称。 它必须与此组件的“config”架构中的键匹配。匹配的配置字段的类型必须与此配置类型匹配。

4

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

5

（必需）此配置值的类型。如果 target_name 与 config 架构中的某个键匹配，则此类型必须与该类型匹配。

1

（必需）相对于组件本身的目录提供程序。必须是 parent、framework 或 child。

2

（必需）用于标识将其呈现给此组件的目录的名称。

3

（必需）在组件的命名空间中应安装该功能的路径。

必须是以 / 开头的绝对路径。

4

（必需）组件使用此目录所需的权限。

5

（可选）要使用的目录的子目录，而不是根目录。

6

（必需）此用途所代表的依赖项类型。

如果组件通过自身为子级提供功能，并使用同一子级的功能，则必须将依赖项标记为 weak。weak 依赖项意味着该功能可能在任何时候变为不可用。严重依赖子级的 capability 会导致子级在父级之前关闭。使用弱依赖项时，父项会在子项之前关闭。

7

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

8

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）事件流的名称。

2

（必需）事件的提供方。必须是 parent、framework 或 child。

3

（可选）使用框架中的事件时，需要指定范围来指定事件将涉及的子项（或子项数组）。从父项使用事件时，可以使用作用域将事件范围缩小到特定的子作用域，否则事件将带有来自父项的范围。

4

（必需）在组件的命名空间中应安装该功能的路径。必须是以 / 开头的绝对路径。

5

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

6

（可选）事件流过滤条件。过滤器的结构取决于事件流类型。仅适用于 CapabilityRequested 事件类型。

1

（必需）相对于组件本身的协议的提供者。必须是 parent、framework、debug、capability 或 child。

2

（必需）标识将其呈现给此组件时所用的协议的名称。

3

（必需）在组件的命名空间中应安装 capability 的路径。

必须是以 / 开头的绝对路径。

4

（必需）此用途所代表的依赖项类型。

如果组件通过自身为子级提供功能，并使用同一子级的功能，则必须将依赖项标记为 weak。weak 依赖项意味着该功能可能在任何时候变为不可用。严重依赖子级的 capability 会导致子级在父级之前关闭。使用弱依赖项时，父项会在子项之前关闭。

5

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

6

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）相对于组件的运行程序的提供程序。必须是 parent、child、framework 或 environment。

2

（必需）用于标识将其呈现给此组件的运行程序的名称。

3

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）相对于组件本身的协议的提供者。必须是 parent、framework、self 或 child。

2

（必需）用于标识向其呈现该组件的服务的名称。

3

（必需）在组件的命名空间中应安装该功能的路径。

必须是以 / 开头的绝对路径。

4

（必需）此用途所代表的依赖项类型。

如果组件通过自身为子级提供功能，并使用同一子级的功能，则必须将依赖项标记为 weak。weak 依赖项意味着该功能可能在任何时候变为不可用。严重依赖子级的 capability 会导致子级在父级之前关闭。使用弱依赖项时，父项会在子项之前关闭。

5

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

6

（可选）source 提供的字典中的路径，其中包含 source_name。如果此字段不存在，则 source_name 会标识由 source 直接路由的功能。如果设置了此字段，则 source_name 会标识此字典中嵌套的功能。

1

（必需）标识将其呈现给此组件的存储的名称。

2

（必需）在组件的命名空间中应安装该功能的路径。

必须是以 / 开头的绝对路径。

3

（可选，默认为 REQUIRED）此功能的可用性。如果设置为 required，则在未提供此功能的情况下，组件可能会发生故障。如果设置为 optional，则组件可以处理没有该 capability。

1

2

3

4

5

6

8

9

10

1

通过组件的配置接口生成的 SHA-256 哈希。

1

2

3

4

5

6

7

8

9

10

1

2

1

（必需）组件软件包中用于查找配置值文件的路径。

2

如果设置此属性，则所有配置值都可以通过 CML 文件找到。

1

2

3

4

5

6

7

8

9

10

1

1

2

3

4

5

7

8

1

1

1

2

3

4

5

6

8

9

10

1

2

3

4

5

6

7

8

9

10

1

2

3

4

7

8

9

PARENT

允许父组件为配置字段提供替换项。

配置键只能包含以下数量的字节

EventStream 中的 EventSubscriptions 数上限。

配置字段的字符串标识符。

字典中的路径。该格式与目录路径类似，但不包含 . 和 ..。且每个路径段都必须符合 name 类型的格式。

“dirname”（第一个到倒数第二个段，或如果存在一个段则为空）表示一系列嵌套的字典。“basename”（最后一个片段）用于标识最后一个嵌套字典中的功能。