迁移指南

更新时间:2024-06-25 10:06:49下载pdf

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

适用范围

支持迁移 SDK 版本的为:

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

升级智能生活 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. 完成上文 升级智能生活 App SDK 中的步骤。
  2. 在 Podfile 中将 Tuya 开头的业务包库都改名为 Thing 开头,版本号指定为 '~> 5.0.0'
  3. 确保 ty_custom_config.json 文件可用,并在您的工程里将其改名为 thing_custom_config.json。该文件的作用请参考 框架接入