迁移指南

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

适用范围

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

• 如果您的应用已经接入过 Cube App SDK，则支持迁移 SDK 版本的为：

  • 1.x.x 版本 Cube App SDK
  • 1.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. 从 开发者平台 > App SDK > SDK 开发 > App 详情页 > 获取密钥，重新获取最新的密钥信息（App Key 和 AppSecret）。

   

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

例外情况

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