基于C++开发Azure IoT Edge模块，需要先搭建稳定的边缘计算网关环境，这个环境需要同时支持Azure IoT Edge运行时运行和C++代码编译调试，整体流程分为基础环境准备、运行时部署、开发工具配置三个核心部分。
一、基础环境准备
首先选择支持Azure IoT Edge的操作系统，推荐Ubuntu 20.04 LTS或者更高版本，Windows系统也可以选择Windows 10/11专业版。如果是Linux系统，先更新系统软件源并安装基础依赖：
# 更新软件源 sudo apt-get update # 安装基础工具 sudo apt-get install -y curl wget git build-essential cmake
如果是ARM架构的边缘网关设备，需要确认系统支持对应的安装包，部分依赖需要根据架构调整安装命令。
二、部署Azure IoT Edge运行时
Azure IoT Edge运行时是边缘网关的核心组件，负责管理模块的生命周期和消息路由。Linux系统下安装运行时的步骤如下：
1. 注册微软软件源
# 安装微软GPG密钥 curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg sudo cp microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg # 添加Azure IoT Edge软件源 sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/ubuntu/20.04/prod focal main" sudo apt-get update
2. 安装IoT Edge运行时
sudo apt-get install -y aziot-edge
3. 配置运行时连接信息
需要从Azure门户获取IoT Edge设备的连接字符串，然后配置到运行时的配置文件中：
sudo nano /etc/aziot/config.toml # 在文件中添加以下内容，替换连接字符串 [provisioning] source = "manual" connection_string = "HostName=your-iothub-name.azure-devices.net;DeviceId=your-edge-device-id;SharedAccessKey=your-device-key" # 保存后重启服务 sudo systemctl restart aziot-edge
配置完成后可以通过sudo systemctl status aziot-edge命令查看运行时运行状态，确认服务正常启动。
三、配置C++开发工具链
Azure IoT Edge的C++模块开发需要依赖Azure IoT SDK for C和Edge SDK，首先安装C++编译相关的依赖：
# 安装CMake和必要的开发库 sudo apt-get install -y cmake git libcurl4-openssl-dev libssl-dev uuid-dev
然后克隆Azure IoT C SDK和Edge模块SDK到本地：
# 克隆Azure IoT C SDK git clone https://github.com/Azure/azure-iot-sdk-c.git cd azure-iot-sdk-c git submodule update --init # 编译SDK mkdir build && cd build cmake .. make sudo make install
四、创建C++ Azure IoT Edge模块
完成环境搭建后，可以创建一个基础的C++模块示例，实现向IoT Hub发送消息的功能：
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "azure_iot_edge_module.h"
// 模块消息回调函数
static void message_callback(MESSAGE_HANDLE message, void* user_context)
{
const char* message_content = NULL;
if (Message_GetString(message, &message_content) == MESSAGE_OK)
{
printf("收到消息: %sn", message_content);
}
}
int main(void)
{
// 初始化模块
MODULE_HANDLE module_handle = Module_Create(NULL, NULL, NULL);
if (module_handle == NULL)
{
printf("模块初始化失败n");
return -1;
}
// 设置消息回调
Module_SetMessageCallback(module_handle, message_callback, NULL);
// 循环发送消息
int count = 0;
while (1)
{
char send_content[128];
snprintf(send_content, sizeof(send_content), "边缘网关C++模块消息计数: %d", count++);
MESSAGE_HANDLE send_message = Message_CreateFromString(send_content);
if (send_message != NULL)
{
Module_SendMessage(module_handle, send_message);
Message_Destroy(send_message);
}
sleep(5);
}
// 销毁模块
Module_Destroy(module_handle);
return 0;
}
编写CMakeLists.txt文件用于编译模块：
cmake_minimum_required(VERSION 3.10) project(edge_cpp_module) # 查找Azure IoT SDK find_package(azure_iot_sdk_c REQUIRED) # 添加可执行文件 add_executable(edge_cpp_module main.cpp) # 链接依赖库 target_link_libraries(edge_cpp_module azure_iot_sdk_c::iothub_client azure_iot_sdk_c::edge_module)
五、模块编译与部署
编译模块生成可执行文件：
mkdir build && cd build cmake .. make
编译完成后将可执行文件打包成Docker镜像，然后部署到边缘网关设备上。在Azure门户的IoT Edge设备页面，添加自定义模块，设置镜像地址和模块启动命令，保存部署配置后，边缘网关会自动拉取镜像并启动模块。
六、常见问题排查
- 运行时启动失败：检查连接字符串是否正确，设备是否在IoT Hub中注册，网络是否通畅
- C++模块编译失败：确认Azure IoT SDK是否正确安装，CMake配置是否指向正确的依赖路径
- 模块无法收发消息：检查边缘网关的消息路由配置，确认模块的输入输出端点配置正确
Azure_IoT_EdgeC++边缘计算网关模块开发修改时间：2026-07-14 18:36:38