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

# Amazon IoT Greengrass 开发工具包命令行界面
<a name="greengrass-development-kit-cli"></a>

Amazon IoT Greengrass 开发工具包命令行界面（GDK CLI）提供的功能可帮助您开发[自定义 Greengrass 组件](develop-greengrass-components.md)。您可以使用 GDK CLI 来创建、构建和发布自定义组件。使用 GDK CLI 创建组件存储库时，可以从 [Greengrass 软件目录](greengrass-software-catalog.md)中的模板或社区组件开始。然后，您可以选择可将文件打包为 ZIP 存档、使用 Maven 或 Gradle 构建脚本或运行自定义构建命令的构建系统。创建组件后，您可以使用 GDK CLI 将其发布到 Amazon IoT Greengrass 服务，这样您就可以使用 Amazon IoT Greengrass 控制台或 API 将该组件部署到 Greengrass 核心设备。

在不使用 GDK CLI 的情况下开发 Greengrass 组件时，每次创建组件的新版本时，都必须更新[组件配方文件](component-recipe-reference.md)中的版本和构件 URI。当您使用 GDK CLI 时，它可以在您每次发布组件的新版本时自动为您更新版本和构件 URI。

GDK CLI 是开源的，可在 GitHub 上提供。您可以自定义和扩展 GDK CLI 以满足您的组件开发需求。我们邀请您在 GitHub 存储库上打开问题和拉取请求。您可以通过以下链接查找 GDK CLI 的源代码：[https://github.com/aws-greengrass/aws-greengrass-gdk-cli](https://github.com/aws-greengrass/aws-greengrass-gdk-cli)。

## 先决条件
<a name="gdk-cli-prerequisites"></a>

要安装和使用 Greengrass 开发工具包 CLI，需要以下条件：
+ Amazon Web Services 账户。如果没有，请参阅[设置一个 Amazon Web Services 账户](setting-up.md#set-up-aws-account)。
+ 支持互联网连接的 Windows、macOS 或类 Unix 的开发计算机。
+ 对于 GDK CLI 1.1.0 版本或更高版本，开发计算机上需已安装 [Python](https://www.python.org/downloads/) 3.6 或更高版本。

  对于 GDK CLI 1.0.0 版本，开发计算机上需已安装 [Python](https://www.python.org/downloads/) 3.8 或更高版本。
+ 开发计算机上已安装 [Git](https://git-scm.com/)。
+ <a name="development-component-aws-cli-prerequisite"></a>开发计算机上已安装Amazon Command Line Interface（Amazon CLI）并使用凭证进行配置。有关更多信息，请参阅《Amazon Command Line Interface 用户指南》中的[安装、更新和卸载 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/cli-chap-install.html) 以及[配置 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/cli-chap-configure.html)。**
**注意**  
如果您使用 Raspberry Pi 或其他 32 位 ARM 设备，请安装 Amazon CLI V1。Amazon CLIV2 不适用于 32 位 ARM 设备。有关更多信息，请参阅[安装、更新和卸载 Amazon CLI 版本 1](https://docs.amazonaws.cn/cli/latest/userguide/install-cliv1.html)。
+ 要使用 GDK CLI 将组件发布到 Amazon IoT Greengrass 服务，必须拥有以下权限：
  + `s3:CreateBucket`
  + `s3:GetBucketLocation`
  + `s3:PutObject`
  + `greengrass:CreateComponentVersion`
  + `greengrass:ListComponentVersions`
+ 要使用 GDK CLI 构建其构件存在于 S3 存储桶（而不是本地文件系统）中的组件，必须拥有以下权限：
  + `s3:ListBucket`

  此功能适用于 GDK CLI v1.1.0 及更高版本。

## 更改日志
<a name="gdk-cli-changelog"></a>

下表介绍每个版本的 GDK CLI 的更改。有关更多信息，请参阅 GitHub 上的 [GDK CLI 发行版页面](https://github.com/aws-greengrass/aws-greengrass-gdk-cli/releases)。


|  **版本**  |  **更改**  | 
| --- | --- | 
|  1.6.2  |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
|  1.6.1  |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.6.0 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
|  1.5.0  |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.4.0 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.3.0 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.2.3 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.2.2 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.2.1 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
| 1.2.0 |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html) [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
|  1.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/greengrass/v2/developerguide/greengrass-development-kit-cli.html)  | 
|  1.0.0  |  初始版本。  |