快速入门：将遥测数据从设备发送到 IoT 中心并使用后端应用程序读取该数据 (C)

• 安装 Visual Studio 2019 并启用“使用 C++ 的桌面开发”工作负荷。

• 安装最新版本的 Git。

• 确保已在防火墙中打开端口 8883。 本快速入门中的设备示例使用 MQTT 协议，该协议通过端口 8883 进行通信。 在某些公司和教育网络环境中，此端口可能被阻止。 有关解决此问题的更多信息和方法，请参阅连接到 IoT 中心(MQTT)。

可以使用本地 Azure CLI。

• 如果需要，请安装 Azure CLI 来运行 CLI 参考命令。

• 本地 Azure CLI，请了解如何安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

  • 通过使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。

  • 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。

  • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

• 在生成 SDK 之前安装所有依赖项。

  sudo apt-get update    
  sudo apt-get install -y git cmake build-essential curl libcurl4-openssl-dev libssl-dev uuid-dev ca-certificates
  

• 验证 CMake 的版本是否至少为 2.8.12：

  cmake --version
  

• 验证 gcc 的版本是否至少为 4.4.7：

  gcc --version
  

• 确保已在防火墙中打开端口 8883。 本快速入门中的设备示例使用 MQTT 协议，该协议通过端口 8883 进行通信。 在某些公司和教育网络环境中，此端口可能被阻止。 有关解决此问题的更多信息和方法，请参阅连接到 IoT 中心(MQTT)。

1. 下载 CMake 生成系统。

   在进行 安装之前CMake，必须在计算机上安装 Visual Studio 必备组件（Visual Studio 和“使用 C++ 的桌面开发”工作负荷）。 满足先决条件并验证下载内容后，安装 CMake 生成系统。

2. 找到最新版 SDK 的标记名称。

3. 打开命令提示符或 Git Bash shell。 运行以下命令以克隆最新版本的 Azure IoT C SDK GitHub 存储库。 使用在上一步找到的标记作为 -b 参数的值：

   git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git
   cd azure-iot-sdk-c
   git submodule update --init
   

   应该预料到此操作需要几分钟才能完成。

4. 在 git 存储库的根目录中创建 cmake 子目录，并导航到该文件夹。 从 azure-iot-sdk-c 目录运行以下命令：

   mkdir cmake
   cd cmake
   

5. 运行以下命令，以生成特定于你的开发客户端平台的 SDK 版本。 将在 cmake 目录中生成模拟设备的 Visual Studio 解决方案。

   cmake ..
   

   如果 cmake 找不到 C++ 编译器，则可能会在运行以上命令时出现生成错误。 如果出现这种情况，请尝试在 Visual Studio 命令提示符窗口中运行该命令。

   生成成功后，最后的几个输出行如下所示：

   $ cmake ..
   -- Building for: Visual Studio 15 2017
   -- Selecting Windows SDK version 10.0.16299.0 to target Windows 10.0.17134.
   -- The C compiler identification is MSVC 19.12.25835.0
   -- The CXX compiler identification is MSVC 19.12.25835.0
   
   ...
   
   -- Configuring done
   -- Generating done
   -- Build files have been written to: E:/IoT Testing/azure-iot-sdk-c/cmake
   

1. 找到最新版 SDK 的标记名称。

2. 打开 shell 命令提示符。 运行以下命令以克隆最新版本的 Azure IoT C SDK GitHub 存储库。 使用在上一步找到的标记作为 -b 参数的值：

   git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git
   cd azure-iot-sdk-c
   git submodule update --init
   

3. 在 git 存储库的根目录中创建 cmake 子目录，并导航到该文件夹。 从 azure-iot-sdk-c 目录运行以下命令：

   mkdir cmake
   cd cmake
   

4. 运行以下命令，以生成特定于你的开发客户端平台的 SDK 版本。

   cmake ..
   cmake --build .
   

1. 使用文本编辑器打开 iothub_convenience_sample.c 源文件，并查看用于发送遥测数据的示例代码。 该文件位于克隆 Azure IoT C SDK 的工作目录下的以下位置：

   azure-iot-sdk-c\iothub_client\samples\iothub_convenience_sample\iothub_convenience_sample.c
   

2. 找到 connectionString 常量的声明：

   /* Paste in your device connection string  */
   static const char* connectionString = "[device connection string]";
   

   将 connectionString 常量的值替换为之前记下的设备连接字符串。 然后将更改保存到 iothub_convenience_sample.c 。

3. 在本地终端窗口中，导航到在 Azure IoT C SDK 中创建的 CMake 目录中的 iothub_convenience_sample 项目目录 。 在工作目录中输入以下命令：

   cd azure-iot-sdk-c/cmake/iothub_client/samples/iothub_convenience_sample
   

4. 在本地终端窗口中运行 CMake 以使用更新的 connectionString 值生成示例：

   cmake --build . --target iothub_convenience_sample --config Debug
   

5. 在本地终端窗口中运行以下命令，以便运行模拟设备应用程序：

   Debug\iothub_convenience_sample.exe
   

   以下屏幕截图显示了模拟设备应用程序将遥测数据发送到 IoT 中心后的输出：

   

1. 使用文本编辑器打开 iothub_convenience_sample.c 源文件，并查看用于发送遥测数据的示例代码。 该文件位于克隆 Azure IoT C SDK 的工作目录下的以下位置：

   azure-iot-sdk-c\iothub_client\samples\iothub_convenience_sample\iothub_convenience_sample.c
   

2. 找到 connectionString 常量的声明：

   /* Paste in your device connection string  */
   static const char* connectionString = "[device connection string]";
   

   将 connectionString 常量的值替换为之前记下的设备连接字符串。 然后将更改保存到 iothub_convenience_sample.c 。

3. 在本地终端窗口中，导航到在 Azure IoT C SDK 中创建的 CMake 目录中的 iothub_convenience_sample 项目目录 。 在工作目录中输入以下命令：

   cd azure-iot-sdk-c/cmake/iothub_client/samples/iothub_convenience_sample
   

4. 在本地终端窗口中运行 CMake 以使用更新的 connectionString 值生成示例：

   cmake --build . --target iothub_convenience_sample
   

5. 在本地终端窗口中运行以下命令，以便运行模拟设备应用程序：

   ./iothub_convenience_sample
   

   以下屏幕截图显示了模拟设备应用程序将遥测数据发送到 IoT 中心后的输出：