迁移指南

更新时间:2023-04-21 07:06:51下载pdf

为了让您能够构建自属业务特性的应用,涂鸦全面升级了智能生活 App SDK,在业务架构优化调整的基础上,提供更中立的软件开发服务。您可以按照本文描述,借助自动化升级脚本从低版本 SDK 升级到 5.x.x 版本 SDK。

适用范围

  • 如果您的应用是第一次接入智能生活 App SDK,则默认使用的是 5.x.x 版本 SDK,因此您可以忽略本文描述。

  • 如果您的应用已经接入过智能生活 App SDK,则支持迁移 SDK 版本的为:

    • 3.x.x 和 4.x.x 版本智能生活 App SDK
    • 3.x.x 和 4.x.x 版本 UI 业务包 SDK

迁移步骤

  1. 将映射表 thingMapping.json 与脚本 thingMapping.gradle 拷贝到 app 模组目录下。

  2. 打开 app 模组下的 build.gradle 文件,引用 thingMapping.gradle 脚本:

    apply plugin: 'com.android.application'
    // 引用脚本插件
    apply from : "thingMapping.gradle"
    
  3. 打开 thingMapping.gradle 文件,找到 replaceThing,单击绿色三角形开始自动执行替换:

    迁移指南
  4. IoT 平台 > App SDK > SDK 开发 > App 详情页 > 获取密钥 重新获取最新的密钥信息(App Key 和 AppSecret)。

    迁移指南
  5. 将您重新获得的密钥信息更新 App 项目中的本地密钥信息。详细步骤,请参考 快速集成《设置 Appkey、AppSecret 和证书签名》章节。

例外情况

  • 如果您有通过反射方式调用相关非开放 SDK 方法,则需要您手动自行修改。
  • 如果您调用的是非 API 的实体类或者方法,也需要您手动更新。或者,将此类名或者接口放置于映射表 thingMapping.json 中,重新执行该脚本即可实现自动替换。