智能生活 App SDK 常见问题

本文介绍了智能生活 SDK 版本差异常见问题以及 SDK 版本升级常见问题，关键信息总结如下：

• SDK 版本差异：v5.x 是 v4.x、v3.x 的升级版本，支持 Matter 设备配网、涂鸦智能小程序开发等新功能。
• SDK 版本的开发版和正式版区别：开发版仅用于开发或调试，正式版可用于商业发布。
• SDK 版本升级问题：2024 年 1 月 1 日前需要升级到 v5.0 及以上版本，升级后不会影响已上线的 App。
• SDK 服务续费问题：未续费的智能生活 SDK 应用将无法查看重要信息和下载最新版本，但涂鸦可以为您减免部分费用，App 仍可正常运行。

SDK 版本差异问题

1. 使用 v5.x 系列版本 SDK 开发版 开发的 SDK App，已完成功能测试，是否能够直接发布上线使用？

不能。您需要按以下步骤操作，才能发布应用上线使用：

1. 在 涂鸦 IoT 开发平台 付费升级到正式版。详细步骤，请参考 开通服务。
2. 重新构建下载 正式版 SDK 包，替换本地工程项目的 SDK 包。详细步骤，请参考 构建和下载 SDK 包（iOS） 或者 构建和下载 SDK 包（Android）。
3. 重新打包。

2. v5.x、v4.x、v3.x 系列版本 SDK 的区别是什么？

v5.x 系列版本 SDK 是 v4.x、v3.x 系列版本 SDK 的升级版本。v5.x 系列版本 SDK 支持以下全新功能：

• 支持 Matter 设备配网和控制
• 支持涂鸦智能小程序开发
• 开放 App SDK 扫码配网入口
• 修复 v4.x、v3.x 系列版本 SDK 的已知问题

更多信息，请参考 iOS SDK 更新日志 或者 Android SDK 更新日志。

3. v5.x 系列版本 SDK 的开发版和正式版，有什么区别？

• 使用场景不同：

  • 开发版：仅可用于开发或调试使用。限制 云端 OpenAPI 调用量、限制 100 个注册用户数。包含基础 SDK 及 多个垂直品类 SDK 和 UI 业务包，不支持用于发布上架商业化使用。
  • 正式版：可正式商业化使用，无注册用户限制，包含基础 SDK 及多个垂直品类 SDK 和全部 UI 业务包。此外，还为中国大陆以外地区的客户提供独立域名服务。

• 提醒信息不同：

  • 正式版：不包含强制提醒信息。正式版 SDK 中不会包含以下强制提醒信息，请您放心使用。

  • 开发版：包含强制提醒信息。开发版 SDK 中添加了强制提醒信息，帮助开发者识别区分开发版 SDK，避免将开发版 SDK 直接用于商业发布到应用市场，影响用户体验。

    • iOS 版本提醒信息：

      相关弹窗	提示位置	提示内容
      	注册用户限制提醒（每隔 48 小时）	当前 App 仅限于开发测试使用，不可用于商用发布。若达到注册用户数量上限，可能会限制新用户注册。
      	SDK 日志提示（每隔 10 秒）	This application is for testing only, but not for commercial use. If the number of registered users reaches the limit, new users cannot be registered.

    • Android 版本提醒信息：

      相关弹窗	提示位置	提示内容
      	注册用户限制提醒（每隔 48 小时）	当前 App 仅限于开发测试使用，不可用于商用发布。若达到注册用户数量上限，可能会限制新用户注册。
      	SDK 日志提示（每隔 10 秒）	当前 App 仅限于开发测试使用，不可用于商用发布。若达到注册用户数量上限，可能会限制新用户注册。

SDK 版本升级问题

1. 涂鸦 IoT 开发平台提示无法下载 v3.x 系列版本 SDK，并要求尽快开通正式版，升级到 v5.0 及以上版本 SDK，有升级时间限制吗？

有。请您于 2024 年 1 月 1 日之前完成升级，升级到 v5.0 及以上版本 SDK。升级后，请参考 iOS 迁移指南 或者 Android 迁移指南 完成旧版本 SDK 迁移。

2. 如果我把 SDK App 升级正式版（v5.x 系列版本 SDK），是否会影响线上使用 v3.x 系列版本 SDK 开发的 App？

不会。升级后，不会影响已上线的 App。

3. 如果我继续使用 SDK v3.x 系列版本 SDK 开发 App，并发布上线，是否需要更换 v5.x 系列版本的新密钥？

不需要。v3.x 系列版本 SDK App 仍然使用 v3.x SDK 对应的密钥（App Key 和 App Secret）。升级到 v5.x 系列版本后，请您再替换使用 v5.x 系列版本 SDK 的新密钥。

查看 v4.x、v3.x 系列版本 SDK 的密钥步骤如下：

1. 登录 涂鸦 IoT 开发平台。
2. 前往 App SDK > SDK 开发。
3. 打开对应的 SDK 应用，进入 SDK 应用详情页。
4. 单击 切换至旧版本: V4。
   
5. 查看 v4.x 和 v3.x 系列版本 SDK 旧密钥信息。

4. 升级到 v5.x 系列版本或以上版本 SDK 后，如何解决错误码 “SING_VALIDATE_FALEDerror:权限校验失败”？

请您检查并确认：

1. SDK App 项目中配置的密钥（App Key 和 App Secret），是否与 涂鸦 IoT 开发平台 上展示的是否一致。
2. 安全图片是否删除。
3. 安全组件是否已配置。

详细步骤，请参考 iOS 迁移指南 或者 Android 迁移指南。

5. 如何解决错误码 “No implementation found”？

• 完整报错：No implementation found for java.lang.Object com.thingclips.smart.security.jni.SecureNativeApi.doCommandNative(android.content.Context, int, byte[], byte[], boolean) (tried Java_com_thingclips_smart_security_jni_SecureNativeApi_doCommandNative and Java_com_thingclips_smart_security_jni_SecureNativeApi_doCommandNative__Landroid_content_Context_2I_3B_3BZ)
• 解决方法：请检查并确认是否已经添加使用 SDK 安全组件，以及 implementation fileTree(include: ['*.aar'], dir: 'libs’) 依赖。

SDK 服务购买问题

1. 如果我已为智能生活 App SDK 应用开通了首年的智能生活 App SDK 正式版服务，但是次年不续费，会有什么影响？

针对未续费的智能生活 App SDK 应用：

• 您无法在 涂鸦 IoT 开发平台 查看该智能生活 App SDK 应用的重要信息，例如密钥、SHA256 证书、独立域名配置等信息。
• 您无法构建下载最新版本的智能生活 App SDK。

您可以根据实际需求，前往涂鸦 增值服务页面，续费服务。

基于您与涂鸦持续的、长期的未来合作，涂鸦可以为您减免基础的 App 流量费用、运维费用等。您的 App 仍旧可以正常运行，消费者功能不受影响。

若您已确认可能会停止与涂鸦在其他方面的整体合作，出于 App 持续会产生的流量及基础运维成本，涂鸦可能会向您收取这部分的费用，或与您一起探讨未来您的供应商替代方案，并逐步终止提供 App 相关服务。