迁移指南

更新时间:2025-08-11 09:09:49下载pdf

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

适用范围

如果您的 SDK 版本为 v3.x.x 或者 v4.x.x ,并需要升级到 v5.x.x 及以上版本 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. 开发者平台 > App SDK > SDK 开发 > App 详情页 > 获取密钥 重新获取最新的密钥信息(App Key 和 AppSecret)。

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

例外情况

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