本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建软件包和程序包版本
<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 作业更新预留名为 shadow 的权限，**请在 “选择角色”** 下选择 “**创建角色**”。如果您不希望 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. 在 **SBOM 配置**窗口的 “**步骤 3：版本 SBOMs （可选）**” 中，选择默认 SBOM 文件格式和验证模式，用于在软件物料清单与软件包版本关联之前对其进行验证。

1. 在**添加 SBOM 文件**窗口中，输入表示受版本控制的 Amazon S3 存储桶的 Amazon 资源名称（ARN），如果默认类型无效，则输入首选的 SBOM 文件格式。
**注意**  
 SBOMs 如果您的软件包版本有多个软件物料清单，则可以添加一个 SBOM 文件或包含多个文件的 zip 文件。

1. 在**已添加的 SBOM 文件**窗口中，您可以查看为程序包版本添加的 SBOM 文件。

1. 选择**创建软件包和版本**。程序包版本页面随即出现，您可以在**已添加的 SBOM 文件**窗口中看到 SBOM 文件的验证状态。SBOM 文件进行验证时的初始状态将为 `In progress`。
**注意**  
SBOM 文件验证状态包括 `Invalid file`、`Not started`、`In progress`、`Validated (SPDX)`、`Validated (CycloneDX)`，以及验证失败的原因。