本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立軟體套件和套件版本
<a name="creating-package-and-version"></a>

您可以使用下列步驟，透過 AWS 管理主控台建立套件和初始版本物件。

**若要建立軟體套件**

1. 登入 AWS 您的帳戶並導覽至 [AWS IoT 主控台](https://console.aws.amazon.com/iot/home)。

1.  在導覽窗格中，選擇**軟體套件**。

1.  在 **AWS IoT 軟體套件**頁面上，選擇**建立套件**。**啟用套件管理的相依性**對話方塊隨即出現。

1.  在**機群索引**下，選取**新增裝置軟體套件和版本**。這是軟體套件目錄的必要條件，並會提供機群的機群索引和指標。

1. 【選用】 如果您想要 AWS IoT 任務在任務成功完成時更新保留的具名影子，請選取**從任務自動更新影子**。如果您不希望 AWS IoT 任務進行此更新，請取消選取此核取方塊。

1.  【選用】 若要授予 AWS IoT 任務更新預留具名影子的權限，請在**選取角色**下選擇**建立角色**。如果您不希望 AWS IoT 任務進行此更新，則不需要此角色。

1. 建立或選取角色。

   1. 若您**沒有此用途的角色**：顯示**建立角色**對話方塊時，請輸入**角色名稱**，然後選擇**建立**。

   1. 若您**具有此用途的角色**：針對**選取角色**，請選擇您的角色，然後確定已選取**將政策附加至 IAM 角色**核取方塊。

1. 選擇**確認**。**建立新套件**頁面隨即出現。

1. 在**套件詳細資訊**下，輸入**套件名稱**。

1. 在**套件描述**下，輸入相關資訊協助您識別管理此套件。

1. [選用] 您可以使用標籤來協助您分類管理此套件。若要新增標籤，請展開**標籤**，選擇**新增**標籤，然後輸入金鑰-值配對。您最多可輸入 50 個標籤。如需詳細資訊，請參閱[標記您的 AWS IoT 資源](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)。

**若要在建立新套件時新增套裝版本**

1. 在**初始版本**下，輸入**版本名稱**。

   建議您使用 [SemVer 格式](https://semver.org/) (例如 `1.0.0.0`) 來專屬識別您的套件版本。您也可以使用更適合您使用案例的其他格式方式。如需詳細資訊，請參閱[套件版本生命週期](preparing-to-use-software-package-catalog.md#package-version-lifecycle)。

1. 在**版本描述**下，輸入相關資訊協助您識別管理此套件版本。
**注意**  
**預設版本**核取方塊會停用，因為套件版本是在 `draft` 狀態下建立的。您可以在建立套件版本之後，以及將狀態變更為 時，命名預設版本`published`。如需詳細資訊，請參閱[套件版本生命週期](preparing-to-use-software-package-catalog.md#package-version-lifecycle)。

1. [選用] 若要協助您管理此版本或將資訊傳送給您的裝置，請為**版本屬性**輸入一或多個名稱/值配對。為您輸入的每個名稱/值配對選擇**新增屬性**。如需詳細資訊，請參閱[版本屬性](preparing-to-use-software-package-catalog.md#version-attributes)。

1. [選用] 您可以使用標籤來協助您分類管理此套件。若要新增標籤，請展開**標籤**，選擇**新增**標籤，然後輸入金鑰-值配對。您最多可輸入 50 個標籤。如需詳細資訊，請參閱[標記您的 AWS IoT 資源](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)。

1. 選擇**下一步**。

**將軟體物料清單與套件版本建立關聯 （選用）**

1. 在**步驟 3：SBOMs（選用）** 上，選擇預設 SBOM 檔案格式和驗證模式，用於驗證您的軟體物料清單，然後再與套件版本相關聯。 ****

1. 在**新增 SBOM 檔案**視窗中，輸入代表您版本控制的 Amazon S3 儲存貯體的 Amazon Resource Name (ARN)，如果預設類型無法運作，則輸入偏好的 SBOM 檔案格式。
**注意**  
如果您的套件版本有多個軟體物料清單，您可以新增單一 SBOM 檔案或包含多個 SBOMs 的單一 zip 檔案。

1. 在**新增的 SBOM 檔案**視窗中，您可以檢視您為套件版本新增的 SBOM 檔案。

1. 選擇**建立套件和版本**。套件版本頁面隨即出現，您可以在**新增的 SBOM 檔案視窗中查看 SBOM 檔案**的驗證狀態。當 SBOM 檔案經過驗證`In progress`時，初始狀態將為 。
**注意**  
SBOM 檔案驗證狀態為 `Invalid file`、`Not started`、`Validated (CycloneDX)`、、 `In progress` `Validated (SPDX)`和驗證失敗原因。