阿里云物联网.NET Core客户端使用指南

简要概括，CZGL.AliIoTClient 是一款专为 .NET Core 开发者打造的阿里云物联网 SDK，基于 .NET Standard 2.0 构建。其核心价值在于帮助物联网设备快速、稳定地连接阿里云物联网平台。底层通信采用 MQTT 协议，依托成熟的 M2MQTT.DotNetCore 库。功能覆盖全面：包括建立加密通信连接、Topic 消息推送与订阅、设备属性上报与设置、事件响应、服务调用以及位置信息上报。数据格式方面，支持透传和 Alink JSON 两种模式，具有较高的灵活性。

更值得一提的是，该 SDK 并不局限于特定运行环境。借助 .NET Core 的跨平台能力，它可以在多种嵌入式开发板上稳定运行。开发团队已在各类硬件平台上进行了大量测试，其兼容性与稳定性得到了充分验证。

核心用途

阿里云官方物联网 SDK 列表中一直缺少 .NET Core 客户端，该 SDK 的诞生正是为了填补这一空白。它严格遵循阿里云官方文档的开发逻辑，同时额外实现了一些官方文档未明确记载但实际开发中非常实用的功能。

一机一密认证、Topic 订阅与推送、设备属性上报与设置等物联网设备接入的基础操作均已封装完成，可直接调用。配套文档内容详尽，同步梳理了阿里云物联网平台的使用流程。对于 .NET 开发者来说，这无疑是一份稀缺的、与物联网平台对接的实战指南。

快速集成指南

集成过程十分简便：在 Nuget 中搜索 CZGL.AliIoTClient，安装相应版本的包即可完成集成。

版本说明

需特别注意版本差异：当前 V1.1 版本相比 V1.0 在底层逻辑和接口设计上几乎是颠覆性更新，差异巨大。因此，本文档及说明仅适用于 V1.1 版本。若您仍在使用 V1.0 代码或项目，直接套用 V1.1 用法将导致问题，请务必做好迁移工作。