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

# 下載並儲存 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>

此程序會在 Raspberry Pi 上安裝 AWS IoT 裝置用戶端。

在連接至 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 Device Client 編譯的警告訊息可以忽略。

   這些教學課程已在 2021 年 10 月 30 日版本 Raspberry Pi OS (bullseye) 的 **gcc**2021 年 10 月 30 日版本 (Raspbian 8.3.0-6\$1rpi1) 8.3.0 的 Raspberry Pi OS (buster) 的 2021 年 5 月 7 日使用建置於 的 AWS IoT Device Client **gcc**(Raspbian 10.2.1-6\$1rpi1) 10.2.1 20210110 進行測試。

1.  AWS IoT 裝置用戶端完成建置後，請執行此命令來測試它。

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

如果您看到 AWS IoT Device Client 的命令列說明， AWS IoT 表示 Device Client 已成功建置並準備好供您使用。

## 建立教學課程所使用的目錄
<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 卡，然後繼續進行 [在 中佈建 Raspberry Pi AWS IoT](iot-dc-install-provision.md)。

**若要將 microSD 記憶卡映像儲存至檔案中：**

在連接至 Raspberry Pi 本機主機電腦上的終端機視窗中：

1. 確認您的 AWS 帳戶 登入資料尚未儲存。

   1. 使用此命令執行 AWS configure 應用程式：

      ```
      aws configure
      ```

   1. 如果憑證已儲存 (若顯示在提示中)，請在提示出現時輸入 **XYXYXYXYX** 字串，如下所示。將 **Default region name** (預設區域名稱) 和 **Default output format** (預設輸出格式) 保留為空白。

      ```
      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 卡的映像後，請從本機主機電腦中退出記憶卡。

您可以在 [在 中佈建 Raspberry Pi AWS IoT](iot-dc-install-provision.md) 中繼續使用此 microSD 卡。