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

# 下载并保存 AWS IoT 设备客户端
<a name="iot-dc-install-download"></a>

本节中的步骤下载 AWS IoT 设备客户端，对其进行编译，然后将其安装到您的 Raspberry Pi 上。测试安装后，您可以保存 Raspberry Pi的 microSD卡映像，以便以后需要再次尝试教程时使用。

**Topics**
+ [下载并构建 AWS IoT 设备客户端](#iot-dc-install-dc-download)
+ [创建教程使用的目录](#iot-dc-install-dc-files)
+ [（可选）保存 microSD 卡映像](#iot-dc-install-dc-save)

## 下载并构建 AWS IoT 设备客户端
<a name="iot-dc-install-dc-download"></a>

此过程将 AWS IoT 设备客户端安装到您的 Raspberry Pi 上。

在连接到 Raspberry Pi 的本地主机上的终端窗口中执行这些命令。

**在 Raspberry Pi 上安装 AWS IoT 设备客户端**

1. 输入这些命令在 Raspberry Pi 上下载和构建 AWS IoT 设备客户端。

   ```
   cd ~
   git clone https://github.com/awslabs/aws-iot-device-client aws-iot-device-client
   mkdir ~/aws-iot-device-client/build && cd ~/aws-iot-device-client/build
   cmake ../
   ```

1. 运行此命令来构建 AWS IoT 设备客户端。完成此命令可能最多需要 15 分钟。

   ```
   cmake --build . --target aws-iot-device-client
   ```

   可以忽略 AWS IoT 设备客户端编译时显示的警告消息。

   这些教程已在 2021 年 10 月 30 日的 Raspberry Pi 操作系统（buster）版本上**gcc**使用内置的 AWS IoT 设备客户端（Raspbian 10.2.1-6\$1rpi1）10.2.1 20210110 进行了测试，版本为（Raspbian 8.3.0-6\$1rpi1）8.3.0。**gcc**

1.  AWS IoT 设备客户端构建完成后，通过运行此命令对其进行测试。

   ```
   ./aws-iot-device-client --help
   ```

如果您看到 AWS IoT 设备客户端的命令行帮助，则 AWS IoT 表示设备客户端已成功构建并可供您使用。

## 创建教程使用的目录
<a name="iot-dc-install-dc-files"></a>

此过程将在 Raspberry Pi 上创建目录，用于存储教程在此学习路径中使用的文件。

**要在此学习路径中创建教程使用的目录，请执行以下操作：**

1. 运行这些命令创建所需的目录。

   ```
   mkdir ~/dc-configs
   mkdir ~/policies
   mkdir ~/messages
   mkdir ~/certs/testconn
   mkdir ~/certs/pubsub
   mkdir ~/certs/jobs
   ```

1. 运行这些命令设置新目录的权限。

   ```
   chmod 745 ~
   chmod 700 ~/certs/testconn
   chmod 700 ~/certs/pubsub
   chmod 700 ~/certs/jobs
   ```

创建这些目录并设置权限后，请继续 [（可选）保存 microSD 卡映像](#iot-dc-install-dc-save)。

## （可选）保存 microSD 卡映像
<a name="iot-dc-install-dc-save"></a>

此时，你的 Raspberry Pi 的 microSD 卡已经更新了操作系统、基本应用软件和 AWS IoT 设备客户端。

如果您想再次尝试这些练习和教程，可以跳过前面的步骤，使用此步骤保存的 microSD 卡映像写入新的 microSD 卡，然后在 [在中配置你的树莓派 AWS IoT](iot-dc-install-provision.md) 中继续教程。

**要将 microSD 卡映像保存到文件中，请执行以下操作：**

在连接到 Raspberry Pi 的本地主机的终端窗口中：

1. 确认您的 AWS 账户 凭证尚未存储。

   1. 使用以下命令运行 AWS 配置应用程序：

      ```
      aws configure
      ```

   1. 如果您的凭据已存储（如果出现在提示中），输入 **XYXYXYXYX** 字符串在提示时，如下所示。保持**原定设置区域名称**和**原定设置输出格式**空白。

      ```
      AWS Access Key ID [****************YXYX]: XYXYXYXYX
      AWS Secret Access Key [****************YXYX]: XYXYXYXYX
      Default region name: 
      Default output format:
      ```

1. 输入此命令关闭 Raspberry Pi。

   ```
   sudo shutdown -h 0
   ```

1. Raspberry Pi 完全关闭后，卸下其电源接头。

1. 从设备中取出 microSD 卡。

1. 在本地主机上：

   1. 插入 microSD 卡。

   1. 使用 SD 卡成像工具，将 microSD 卡映像保存到文件中。

   1. 保存 microSD 卡的映像后，从本地主机上弹出该卡。

您可以继续使用这张 microSD 卡在 [在中配置你的树莓派 AWS IoT](iot-dc-install-provision.md) 中操作。