此页面由 Cloud Translation API 翻译。

将文件复制到组件或从中复制文件

ffx component copy 命令可以在目标设备上运行的 Fuchsia 组件之间复制文件。

概念

ffx component copy 命令可以通过以下方式传输文件：

从设备上的组件传送到主机。
从主机传输到设备上的组件。
设备上的组件之间。

存储和目录等功能可在 Fuchsia 系统中提供永久性或临时存储空间，您可以在此存储和访问属于特定组件的文件。每个 Fuchsia 组件都有一个命名空间，组件可以在其中访问其所有可用功能。组件的名称表示其在组件拓扑中的位置，也可用作系统上组件的标识符。

因此，如需访问组件命名空间中的文件，您首先需要确定目标组件的名称。例如，stash_secure 组件的名称为 core/stash_secure。（如需了解组件的名称，请参阅 ffx component show 命令。）

将文件复制到组件的命名空间以及从中复制文件

如需将文件复制到 Fuchsia 设备上运行的组件以及从中复制文件，请运行以下命令：

ffx component copy SOURCE DESTINATION

替换以下内容：

SOURCE：要复制的文件的路径。此路径可以引用本地路径，也可以引用与目标设备上的紫红色组件相关联的目录中的路径。
DESTINATION：文件的目标路径。此处适用的选项和限制与 SOURCE 相同。

如果 SOURCE 或 DESTINATION 是 Fuchsia 组件，请使用以下语法来表示组件和路径：
```
MONIKER::DIR_TYPE::PATH
```
DIR_TYPE 可以是 in、out 或 pkg 之一，以指示命名空间（“传入”目录）、组件的传出目录或组件的软件包目录。或者，可以省略 DIR_TYPE，该命令将默认采用组件的命名空间。

例如，core/stash_secure::in::/data/examples.txt 表示 core/stash_secure 组件的命名空间中的路径 /data/example.txt。

请参阅以下示例命令：

将 stash_secure.store 文件从 core/stash_secure 组件下载到宿主机：

$ ffx component copy core/stash_secure::/data/stash_secure.store ./copy_of_stash_secure.store

将 example.txt 文件从主机上传到 core/stash_secure 组件：

$ ffx component copy ./my_example_dir/example.txt core/stash_secure::/data/copy_of_example.txt

将 stash_secure.store 文件从 core/stash_secure 组件复制到 core/feedback 组件：

$ ffx component copy core/stash_secure::/data/stash_secure.store core/feedback::/data/copy_of_stash_secure.store

将多个文件复制到组件的命名空间以及从中复制多个文件

ffx component copy 命令支持使用通配符 * 一次复制多个文件。

请参阅以下示例命令：

将 core/stash_secure 组件的 /data 目录中的所有文件下载到主机：
```
$ ffx component copy core/stash_secure::/data/* ./my_example_dir/
```
将主机的 ./my_example_dir 目录中的所有文件上传到 core/stash_secure 组件：
```
$ ffx component copy ./my_example_dir/* core/stash_secure::/data/
```
将 core/stash_secure 组件的 /data 目录中的所有文件复制到 core/feedback 组件：
```
$ ffx component copy core/stash_secure::/data/* core/feedback::/data/
```
将 core/feedback/ 组件的 data 目录中的所有文件和主机上的 example.txt 文件复制到 core/stash_secure 组件：
```
$ ffx component copy core/feedback::/data/* ./my_example_dir/example.txt core/stash_secure::/data/
```

附录

将文件复制到组件的隔离存储空间以及从组件的隔离存储空间中复制文件

某些 Fuchsia 组件会按组件分配独立式存储空间，并提供存储功能。

与 ffx component copy 不同，ffx component storage 命令只能与存储功能配合使用。此命令使用组件的实例 ID 作为标识符，而不是名称。默认情况下，ffx component storage 命令与名为 data 的存储功能进行交互。

如需将文件复制到组件的隔离存储空间或从中复制文件，请运行以下命令：

ffx component storage copy SOURCE DESTINATION

替换以下内容：

SOURCE：要复制的文件的路径。此路径可以引用宿主机或目标设备上的 Fuchsia 组件。
DESTINATION：文件的目标路径。此路径可以引用主机或目标设备上的 Fuchsia 组件。

如果 SOURCE 或 DESTINATION 是 Fuchsia 组件，请使用以下语法来表示组件和路径：
```
INSTANCE_ID::PATH_IN_STORAGE
```
例如，c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4::/examples.txt 表示 example.txt 文件位于 core/stash_secure 组件的默认 /data 目录中。

请参阅以下示例命令：

将 example.txt 文件从主机上传到 core/stash_secure 组件：

$ ffx component storage copy ./my_example_dir/example.txt c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4::/copy_of_example.txt

将 stash_secure.store 文件从目标组件下载到主机：

$ ffx component storage copy c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4::/stash_secure.store ./my_example_dir/copy_of_example.txt

列出组件的隔离存储空间中的所有目录和文件

如需列出组件的独立存储空间中的所有目录和文件，请运行以下命令：

ffx component storage list INSTANCE_ID::PATH

替换以下内容：

INSTANCE_ID：目标组件的实例 ID。例如 c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4。
PATH：目标组件上的路径。

以下示例命令显示了目标组件的根目录 (/) 目录中的所有目录和文件：

$ ffx component storage list c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4::/
copy_of_example.txt
stash_secure.store

在组件的隔离存储空间中创建新目录

如需在组件的独立存储空间中创建新目录，请运行以下命令：

ffx component storage make-directory INSTANCE_ID::NEW_PATH

替换以下内容：

INSTANCE_ID：目标组件的实例 ID。例如 c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4。
NEW_PATH：要在目标组件上创建的新目录的名称。

以下示例命令会在目标组件上创建一个名为 my-new-example-dir 的新目录：

$ ffx component storage make-directory c1a6d0aebbf7c092c53e8e696636af8ec0629ff39b7f2e548430b0034d809da4::/my-new-example-dir