SDK 与示例下载

当前公开版本Guangnian C/C++ SDK 1.2.1

打开根目录 main.cpp 填写对接信息；包含中文教程、C ABI、会话心跳和完整源码

下载 ZIP

SHA-256：46DE9C1C77BA7C6E6CC136AF13ADB1FCD29AED72E0A3E59D7F444739E5814707（20221 字节）

下载解压后先阅读 INTEGRATION_GUIDE.zh-CN.md，再打开根目录 main.cpp，只填写平台地址、程序 ID、项目密钥和本地版本代码。不要从旧项目复制内部项目 ID 或 Legacy MD5 调用码。

建议使用最新版

所有新项目和正常升级都应使用上方最新版。历史 SDK 只用于旧项目兼容、问题复现或紧急回滚，不再包含后续安全、兼容性和易用性修复。

历史版本

版本	文件	大小	SHA-256	下载
1.2.0	guangnian-sdk-cpp-1.2.0.zip	20152 B	AFB563DFF9DFF54EDC5E42E90596ACBCA3106E2009D1EB355E29B8B2F55B55AB	历史版 1.2.0
1.1.0	guangnian-sdk-cpp-1.1.0.zip	9351 B	2AA10E24B0EB53E6E084CA52E9A629DF7BC6E8DA7CE06F6BFC22254E7C82927B	历史版 1.1.0
1.0.2	guangnian-sdk-cpp-1.0.2.zip	6567 B	3E95F3F0D3D06D99805839D6A682AC3DF0215EF46DE92C73079B34A380D7FCDF	历史版 1.0.2
1.0.1	guangnian-sdk-cpp-1.0.1.zip	6436 B	333244BF97ACC4E21C8FDEA2A10AF81DFE0F1D2AD75223119F3C16AD7CB35F96	历史版 1.0.1
1.0.0	guangnian-sdk-cpp-1.0.0.zip	5592 B	8CA513A139F5B901CAAAD4EA16C8C52555485B39B9E9B5B9DC472DE55CFDA9CE	历史版 1.0.0

下载与校验

正式 SDK 包由管理员在平台发布，下载地址保持在现有静态 SDK 区域：

下载后请在用户中心或发布说明中核对版本号与 SHA-256，不要使用来源不明的二次打包文件。

1. 从上方正式地址下载 ZIP。
2. 核对压缩包版本和平台发布的 SHA-256。
3. 阅读包内 README，先运行测试项目完成首次登录。
4. 确认心跳在线并实测一次全体下线，再合入正式程序。

SDK 负责什么

• 请求签名和随机 nonce
• 登录会话令牌
• 心跳与强制下线结果
• TLS 安全下限和响应大小限制
• 常用错误结果封装

SDK 源码包内还包含程序配置、公告、版本清单、域名授权验证、程序用户注册/登录和两类会话心跳的接口封装。接口路径和成功判断不要从旧版 Legacy V1 示例推断，统一以官方 SDK 接口总览和包内 sdk/cpp/README.md 为准。

仍需客户端实现

• 提供稳定设备码
• 在心跳失败时真正退出受保护功能
• 安全保存和清理敏感数据
• 展示业务错误与请求 ID
• 根据版本结果执行更新和文件校验

WARNING

SDK 与标准 HTTP 共用 card_login 权限和配额；项目还必须允许 SDK 客户端接入。Connect 是另一套独立接口，不通过该 SDK 调用。

下一步：C++ 接入结构 · SDK 心跳 · 上线检查清单