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

ffx component copy 命令可将文件复制到目标设备上运行的 Fuchsia 组件,也可从这些组件中复制文件。

概念

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

  • 从设备上的组件传输到宿主机。
  • 从主机到设备上的组件。
  • 在设备上的组件之间。

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

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

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

如需在 Fuchsia 设备上运行的组件之间复制文件,请运行以下命令:

ffx component copy SOURCE DESTINATION

替换以下内容:

  • SOURCE:要复制的文件的路径。此路径可以是本地路径,也可以是与目标设备上的 Fuchsia 组件关联的目录中的路径。

  • DESTINATION:文件的目标路径。此处适用与 SOURCE 相同的选项和限制。

    如果 SOURCEDESTINATION 是 Fuchsia 组件,请使用以下语法表示组件和路径:

    MONIKER::DIR_TYPE::PATH
    

    DIR_TYPE 可以是 inoutpkg 之一,用于表示命名空间(“传入”目录)、组件的传出目录或组件的软件包目录。(可选)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 组件。

    如果 SOURCEDESTINATION 是 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