本頁面由 Cloud Translation API 翻譯而成。

套裝內容

套件是 Fuchsia 系統上的安裝單位。本文件說明各種建構與安裝套件的工作流程。

工作流程如下：

建構套件
發布套件
安裝套件
透過已安裝的套件執行元件

詳情請參閱來自 ffx package build help 和 ffx repository publish help 的說明訊息。

建立套件

如何建構套件：

建立 meta 目錄：
```
mkdir -p PACKAGE_DIR/meta
```
將 PACKAGE_DIR 替換為要建構套件的暫存目錄。

設定 $META_PACKAGE_FILE 環境變數：

export META_PACKAGE_FILE=PACKAGE_DIR/meta/package

開啟文字編輯器，並使用下列內容建立 $META_PACKAGE_FILE 檔案：
```
{
  "name": "<intended name of your package here>",
  "version": "0"
}
```
目前的版本號碼必須為 0。
儲存檔案並關閉文字編輯器。
建立套件建構資訊清單檔案 ($BUILD_MANIFEST_FILE)，提供所有套件內容檔案的路徑，並透過變數匯出其路徑：
```
export BUILD_MANIFEST_FILE=BUILD_MANIFEST_FILE
```
資訊清單檔案的每一行都會對應至套件中的一個檔案，且格式為 destination=source，其中：
- destination 是最終套件中檔案的路徑。
- source 是主體機器上的檔案路徑。
資訊清單檔案必須包含至少一行套件 ID 檔案，例如：
```
meta/package=/path/to/meta/package
```
要新增至套件的其他檔案必須以相同方式列於建構資訊清單檔案中。
前往 PACKAGE_DIR 目錄：
```
cd PACKAGE_DIR
```
產生套件資訊清單檔案，在 PACKAGE_DIR/meta.far 中建立套件中繼資料封存：
```
ffx package build $BUILD_MANIFEST_FILE -o PACKAGE_DIR --api-level HEAD
```
這個指令會以 PACKAGE_DIR/package_manifest.json 隱含形式建立套件資訊清單檔案。

請注意，--api-level 最好用於透過數字引數指定特定 API 級別。在此範例中，我們使用 HEAD，例如最新的 In- Development API。
設定 $PACKAGE_MANIFEST_FILE 環境變數：
```
export PACKAGE_MANIFEST_FILE="PACKAGE_DIR/package_manifest.json"
```
如果套件內容有所變更，就必須重新執行 ffx package build $BUILD_MANIFEST_FILE 指令。
建立套件封存，將所有套件內容收集到單一可發行檔案：
```
ffx package archive create -o "PACKAGE_DIR/PACKAGE_NAME.far" "$PACKAGE_MANIFEST_FILE"
```
將 PACKAGE_NAME 替換為所需套件名稱。

這個指令會以 PACKAGE_NAME.far 的形式建立套件封存檔。
設定 $PACKAGE_ARCHIVE 環境變數：
```
export PACKAGE_ARCHIVE=PACKAGE_DIR/PACKAGE_NAME.far
```
如果套件內容有所變更，就必須重新執行 ffx package build 和 ffx package archive create 指令。

您已成功建立套件。您現在可以發布套件了。

發布套件

如何發布套件：

初始化做為套件存放區的目錄：
```
ffx repository create REPO
```
這項操作會在 REPO 目錄下建立可用於發布套件的目錄結構。
將套件資訊清單發布至存放區：
```
ffx repository publish --package $PACKAGE_MANIFEST_FILE REPO
```
ffx repository publish 會剖析 $PACKAGE_MANIFEST_FILE，並在提供的 REPO 目錄中發布該套件。

--package 引數可以重複。如果使用不同的套件資訊清單多次執行此指令，則每個執行個體都會發布至相同的存放區。使用相同指令即可發布相同套件的新版本。
(選用) 將套件封存檔發布至存放區：
```
ffx repository publish --package-archive $PACKAGE_ARCHIVE REPO
```
ffx repository publish 會剖析 $PACKAGE_ARCHIVE，並在提供的 REPO 目錄中發布該套件。

--package-archive 引數可以重複。如果以不同的套件封存多次執行此指令，系統會將每個執行個體發布至同一個存放區。使用相同指令即可發布相同套件的新版本。

您已成功發布套件。您現在可以安裝套件了。

安裝套件

如何安裝套件：

啟動套件伺服器，並將存放區提供給目標：
```
ffx repository serve --repository "REPO_NAME" --repo-path "REPO"
```
根據預設，這麼做會在主機機器上啟動存放區伺服器，監聽通訊埠 8083。這會將存放區導入目標為更新來源。--repository "REPO_NAME" 為選用項目，但很實用。
(在目標裝置上) 檢查設定的存放區：
```
pkgctl repo -v
```
您應該會看到已設定的存放區，列出 (以及其他設定變數) 其存放區網址 "repo_url": "fuchsia-pkg://<REPO_NAME>"。
(在目標裝置上) 下載套件：
```
pkgctl resolve fuchsia-pkg://REPO_NAME/PACKAGE_NAME
```
如果系統中還沒有該元件，pkgctl 會下載套件，並在解析過程中將 blob 放入 blobFS。如果套件已存在，系統會下載更新。

已成功安裝或更新套件。您現在可以透過已安裝的套件執行元件。

透過已安裝的套件執行元件

如要執行元件，請使用 ffx component run 工具。如需協助，請ffx component run --help。

如果是 url 參數，請以 fuchsia-pkg://<REPO_NAME>/<PACKAGE_NAME>#meta/<COMPONENT_NAME>.cm 格式提供網址。