此页面由 Cloud Translation API 翻译。

目录功能

如需了解每个组件隔离的目录，请参阅存储功能。

提供目录功能

如需提供目录功能，组件必须声明该功能并从 self 中路由该功能。

如需定义 capability，请为其添加 capabilities 声明：

{
    capabilities: [
        {
            directory: "data",
            rights: ["r*"],
            path: "/published-data",
        },
    ],
}

此示例定义了由此组件托管的功能，其传出目录路径为 /published-data，且最大可用权限为“只读”。

路由目录功能

组件通过向父级公开目录功能并将其提供给子级，来路由目录功能。exposing

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

正在曝光

公开目录 capability 可让组件的父级访问此项功能：

{
    expose: [
        {
            directory: "data",
            from: "self",
        },
    ],
}

您可以选择指定：

as
rights
subdir

成为协作者

提供存储功能可让子组件访问该功能：

{
    offer: [
        {
            directory: "data",
            from: "parent",
            to: [ "#child-a", "#child-b" ],
        },
    ],
}

您可以选择指定：

as
rights
subdir

使用目录功能

如需请求该功能，请为其添加 use 声明：

{
    use: [
        {
            directory: "data",
            rights: ["r*"],
            path: "/data",
        },
    ],
}

系统会使用提供的 path（包含共享目录内容）中的目录填充组件的命名空间。

您必须指定 rights。您可以视需要指定 subdir。

使用可选目录功能

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

目录功能权限

借助目录权限，组件可在系统在整个系统中路由目录时控制对目录的访问权限。目录权限的应用方式如下：

capabilities：必需。提供可用于目录的基本权限集。在 use、offer 或 expose 中指定的任何权限都必须是此处声明的权限的子集。
use：必需。说明使用方组件请求的访问权限。
offer：可选。目标组件可用的修改权限。如果权限不存在，则从 offer 来源继承权限。
expose：可选。目标组件可用的修改权限。如果权限不存在，则从 expose 来源继承权限。

rights 字段可以包含以下 fuchsia.io.Rights 令牌的任意组合：

rights: [
  "connect",
  "enumerate",
  "traverse",
  "read_bytes",
  "write_bytes",
  "execute_bytes",
  "update_attributes",
  "get_attributes",
  "modify_directory",
]

该框架提供了一种简化表单，以使用aliases声明 rights。每个别名代表 FIDL 权利令牌的组合，用于提供常见的读取、写入或执行访问：

别名	FIDL 权利
`r*`	`connect, enumerate, traverse, read_bytes,` `get_attributes`
`w*`	`connect, enumerate, traverse, write_bytes,` `update_attributes, modify_directory`
`x*`	`connect, enumerate, traverse, execute_bytes`
`rw*`	`connect, enumerate, traverse, read_bytes, write_bytes,` `get_attributes, update_attributes, modify_directory`
`rx*`	`connect, enumerate, traverse, read_bytes, execute_bytes,` `get_attributes`

rights 字段只能包含一个别名。您可以附加其他 FIDL 权利，前提是这些权利不重复该别名代表的权利。

示例

在下面的示例中，组件 A 请求对 data 目录的读写权限：

// A.cml
{
    use: [
        {
            directory: "data",
            rights: ["rw*"],
            path: "/data",
        },
    ],
}

不过，父组件 B 向组件 A 提供了目录 data，并且仅具有只读权限。在这种情况下，路由失败，并且 data 不会出现在 A 的命名空间中。

// B.cml
{
    capabilities: [
        {
            directory: "data",
            rights: ["r*"],
            path: "/published-data",
        },
    ],
    offer: [
        {
            directory: "data",
            from: "self",
            to: [ "#A" ],
        },
    ],
}

子目录

您可以 expose、offer 或 use 目录功能的子目录：

{
    offer: [
        {
            directory: "data",
            from: "parent",
            to: [ "#child-a", "#child-b" ],
            subdir: "children",
        },
    ],
}

重命名目录

您可以用不同的名称 expose 或 offer 目录 capability：

{
    offer: [
        {
            directory: "data",
            from: "#child-a",
            to: [ "#child-b" ],
            as: "a-data",
        },
    ],
}