本頁面由 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：要複製的檔案路徑。這個路徑可以是本機路徑，或是與目標裝置上的 Fuchsia 元件相關聯的目錄內的路徑。
DESTINATION：檔案的目的地路徑。此處適用的選項和限制與 SOURCE 相同。

如果 SOURCE 或 DESTINATION 是 Fuchsia 元件，請使用以下語法來表示元件和路徑：
```
MONIKER::DIR_TYPE::PATH
```
DIR_TYPE 可以是 in、out 或 pkg 其中之一，用於指示命名空間 (即「incoming」目錄)、元件的傳出目錄或元件的套件目錄。您也可以選擇省略 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 做為 ID，而非 Moniker。根據預設，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