API Level 版本介绍
更新时间：2018-06-20 16:09:49
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 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 运营和消息告警等需求
|
初始版本
|
|
移动端设备网关
|
提供子设备的管理功能，如子设备添加拓扑，删除拓扑，上线，下线以及数据上下行等
|
初始版本
|