迁移指南

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

适用范围

支持迁移 SDK 版本的为：

• 1.x.x 和 2.x.x 版本 Cube App SDK
• 1.x.x 和 2.x.x 版本 UI 业务包 SDK

升级 Cube App SDK

1. 确保 SDK 网络请求可用，请在涂鸦开发者平台下载 ThingSmartCryption。

2. 在 Podfile 中添加以下变更：

   • 低版本使用安全图片的方案已不再适用，可在项目中删除 t_s.bmp。
   • 确保使用了正确的 SDK 版本，将 Tuya 开头的依赖库都改名为 Thing 开头。例如：
     • 修改前：

       pod 'TuyaSmartHomeKit', 'xx'
       

     • 修改后：

       pod 'ThingSmartHomeKit', '~> 5.0.0'
       

   • 如果您直接使用了 TuyaSmartHomeKit 所依赖的二级库，可以直接通过 GitHub 工程中的 podspec 找到对应的版本。

3. 从 涂鸦开发者平台 > App SDK > SDK 开发 > App 详情页 > 获取密钥 重新获取最新的密钥信息（App Key 和 AppSecret）。

4. 将您重新获得的密钥信息更新 App 项目中的本地密钥信息。详细步骤，请参考 快速集成《配置 SDK》章节。

5. 确保 SDK 的 API 能正常编译，同时减少手动修改的成本。推荐您使用 GitHub 工程中 迁移脚本，将您项目中使用的所有 Tuya 标识的 API 修改为 Thing 标识的 API。

升级 UI 业务包 SDK

1. 完成上文 升级 Cube App SDK 中的步骤。
2. 在 Podfile 中将 Tuya 开头的业务包库都改名为 Thing 开头，版本号指定为 '~> 3.0.0'。
3. 确保 ty_custom_config.json 文件可用，并在您的工程里将其改名为 thing_custom_config.json。该文件的作用请参考 框架接入。