API Level 版本介绍
更新时间：2019-05-23 16:15:59
API Level的概念
- API Level值的范围为自然数，是用于描述移动应用SDK开放给移动插件的API等级，每个API Level包含有一组SDK，每个SDK包含着一组API的集合。
- 由于平台各个SDK版本的迭代，新功能的增加会伴随着API的增加，极少数情况下会有API的废弃，
- 为了避免基于新API开发的插件，在老版本SDK（不包含该API）上运行导致的不兼容问题（如，crash），引入了API Level的概念。
- 随着开放给插件的API的增加，开发者平台上API Level版本增加。开发者开发的插件也都会有标示最低支持的API Level。
- 开发者在应用开发平台上选取API Level，平台会前置过滤出该API Level下的SDK列表，开发者在选定SDK列表后再新建资源变更，平台会再根据API Level和开发者选择的SDK过滤出可用的插件列表。
移动插件能够与移动应用兼容，需要满足以下条件：移动应用配置的API Level >= 移动插件的API Level
API Level 6
API Level 6 发布于 2019 年 5 月，总共包含 11 个 SDK。本次升级主要是更新设备数据的缓存策略。
请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义。同时基于Oauth2.0协议，提供快速对接自有账号的能力，满足开发者在App开发中对接自有账号体系的需求。 | 无 |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 无 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 无 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | 升级 API Level 到 6 升级 Router-external （路由缓存策略变更，优先本地缓存） |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 无 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 | 无 |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 无 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等。 | 支持二维码配网 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | 连接成功时返回breeze 蓝牙设备激活数据 |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 新增设备影子 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | 无 |
API Level 5
API Level 5 发布于 2019 年 2 月，总共包含 11 个 SDK。本次升级主要是支持对设备热点的配网。
请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义。同时基于Oauth2.0协议，提供快速对接自有账号的能力，满足开发者在App开发中对接自有账号体系的需求。 | 无 |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 增加API request超时时长设置功能 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 无 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | API Level 值修改为5 |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 无 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 | 无 |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 无 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等。 | 支持设备热点配网 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | 无 |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 无 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | 无 |
API Level 4
API Level 4 发布于 2018 年 11 月，总共包含 11 个 SDK。本次升级主要是支持在插件中使用蓝牙能力，并对蓝牙相关 SDK 做了升级。
请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义。同时基于Oauth2.0协议，提供快速对接自有账号的能力，满足开发者在App开发中对接自有账号体系的需求。 | 无 |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 无 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 新增Feature:iOS Core SDK增加stopConnect API BugFix：iOS Core SDK解决接收到的topic不往上抛的问题 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | BugFix：修复对于Android 8.0系统下调试插件出现 Crash 的问题 |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 无 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 | 新增Feature:增加上行/下行监听/订阅等API |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 无 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网等。 | 无 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 新增Feature:本地通信新增对蓝牙设备的支持 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | BugFix：iOS SDK解决跟其他库同类名的编译冲突 |
API Level 3
API Level 3 发布于 2018 年 5 月，总共包含 11 个 SDK，请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义。同时基于Oauth2.0协议，提供快速对接自有账号的能力，满足开发者在App开发中对接自有账号体系的需求。 | 新增Feature:支持国际化(英文语言支持) |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 新增Feature:支持国际化 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 新增Feature:支持服务器地址动态配置 BugFix:修复长连接实例引起Bone容器崩溃 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | 新增Feature:支持零配置打开官方插件（注意：不支持打开私有插件） |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 无 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 |
| 新增Feature:新增建联接口 |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 新增Feature:支持阿里云账号
BugFix:修复刷新Token时callback可能引发的死循环 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网等。 | 新增Feature：新增配网埋点
新增Feature：配网方案更新和优化 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | 新增Feature:新增埋点 |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 新增Feature:本地通信新增对网关子设备的支持 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | 新增Feature:调整SDK代码结构，业务代码OTAHelper类从SDK移除 |
API Level 2
API Level 2 发布于 2018 年 2 月，总共包含 11 个 SDK，在 API Level 1 的基础上，新增了统一身份认证、配网、蓝牙、设备模型、蓝牙 OTA 5个 SDK 请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义。同时基于Oauth2.0协议，提供快速对接自有账号的能力，满足开发者在App开发中对接自有账号体系的需求。 | 新增Feature:支持自有账号登陆 |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 新增Feature:支持账号验证的扩展能力 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 新增Feature:内部逻辑优化 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | 新增Feature:支持 alias 功能，支持配置功能 |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 无 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 |
| 新增Feature:OTA等Topic规则的支持 |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 初始版本 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网等。 | 初始版本 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | 初始版本 |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 初始版本 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | 初始版本 |
API Level 1
API Level 1 发布于 2017 年 12 月，总共包含 6 个 SDK，请参见如下表格：
| SDK 名称 | SDK 介绍 | 变更内容 |
|---|---|---|
| 账号及用户 | 提供了标准的账号服务，提供了基本的 UI 界面，并支持自定义 | 初始版本 |
| API 通道 SDK | 提供了 IoT 官方服务的 API 通道，基于 HTTP 协议 | 初始版本 |
| 长连接通道 | 提供了 App 生命周期内的，适用于 IoT 业务场景的长连接通道，默认订阅 App 级别的下行推送；支持请求响应模型，支持发布订阅模型 | 初始版本 |
| Bone Mobile 容器 | 提供了 BoneMobile 插件的运行环境，开发和运行 BoneMobile 插件时，需要集成 | 初始版本 |
| 移动应用推送 | 提供了可用于 App 生命周期外的推送服务，满足 App 运营和消息告警等需求 | 初始版本 |
| 移动端设备网关 | 提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等 |
| 初始版本 |