SDK升级

如果您当前使用的App端SDK不是最新版本,建议您根据以下内容将SDK升级至最新版本。

概述

生活物联网平台发布的App端SDK最新版本为API Level 10。App端各版本SDK的区别如下(更多介绍请参见API Level版本介绍)。

类别

API Level 7及以下SDK

API Level 8 SDK

API Level 9 SDK

API Level 10 SDK

初始化

每个SDK分别初始化

统一初始化

统一初始化

统一初始化

安全图片

4张(分别对应原中国站与原国际站、原测试版与正式版)

2张(分别对应原中国站与原国际站)

1张(全球适用)

无需安全图片

App在中国内地与内地以外地区切换时的操作

切换安全图片,并重启App

切换安全图片,并重启App

无需任何操作

无需任何操作

我们给您提供了多种升级方案,请您根据实际情况来选择。

当前SDK集成情况

升级方案

未集成任何版本SDK

请直接使用最新版本的SDK,并对SDK进行初始化。此情况不涉及SDK升级。相关操作请参见下载并集成SDKSDK初始化

已集成API Level 9版本SDK

如需要更换安全图片或重新创建新的APP,建议根据API Level 9升级SDK方案进行升级(平台生成的密钥建议妥善保存)。

已集成API Level 8版本SDK

请根据API Level 8升级SDK方案来升级SDK,并在后续项目管理中注意以下内容(升级可能给您带来的影响请参见全球激活中心更新公告)。

  • 如果您在原中国站与原国际站中都创建了项目,且其中一个项目没有出货或者出货量较少

    升级后,建议您以出货量大的项目为主项目(即后续产品、App等在该项目中操作),将另一个项目的产品分享至主项目的App中,便于您日后只需维护一个项目中的App。跨项目分享产品的介绍请参见设置关联产品

  • 如果您在原中国站与原国际站中都创建了项目,且两个项目的出货量相当无法取舍

    升级后,您可以通过手动修改安全图片后缀名,并调用接口切换安全图片,从而实现同时管理两个项目中的产品和App。

已集成API Level 7及以下版本SDK

我们提供了两种升级方案供您选择

  • API Level 7升级SDK并使用统一初始化方案(推荐)

    统一初始化方案对后期增加新功能、开拓海外市场等,具有更大的优势。因此,推荐您升级至最新版本的SDK,并使用统一初始化方案。

  • API Level 7升级SDK但不用统一初始化方案(不推荐)

    您也可以保留之前的初始化方法,仅更新SDK版本,但此时无法实现全球统一激活。该方案请慎重选择。

API Level 9升级SDK方案

  1. 进入自有品牌App的SDK和插件页面,选择最新的API Level 10,并下载新的SDK套餐项。详细操作请参见下载并集成SDK

    下载到本地的文件为压缩包,解压后包含dependency.gradle文件

  2. 使用统一初始化接口,并完成SDK的初始化。详细请参见SDK初始化

  3. (可选)添加原来SDK中的定制化逻辑,如用户账号的定制化UI等。

API Level 8升级SDK方案

  1. 进入自有品牌AppSDK和插件页面,选择最新的API Level 9,并下载新的SDK套餐项。详细操作请参见下载并集成SDK

    将下载后的压缩包解压,得到的文件夹中包含安全图片和Podfile文件。

  2. 使用新的统一初始化接口,并完成SDK的初始化。详细请参见SDK初始化

  3. (可选)添加原来的定制化逻辑,如用户账号的定制化UI等。

  4. (可选)设置安全图片后缀名。

    当您需要同时管理两个项目下创建的App时,请通过设置不同的安全图片后缀名来实现。

    1. 复制并重命名安全图片名称,如命名为yw_1222_xxxyyy.jpg

    2. 增加安全图片调用和切换的业务逻辑。

      [[IMSIotSmart sharedInstance] setAuthCode:@"xxxyyy"] 
      //xxxyyy为重命名的安全图片名称后缀名
      //authCode不设置或设置为空时,App默认加载名称为yw_1222_china_production.jpg的安全图片

      切换安全图片的时机和逻辑需要您自行实现,且切换安全图片后App必须重启才能生效。

API Level 7升级SDK并使用统一初始化方案(推荐)

  1. 进入自有品牌AppSDK和插件页面,选择最新的API Level 9,并下载新的SDK套餐项。详细操作请参见下载并集成SDK

    将下载后的压缩包解压,得到的文件夹中包含安全图片和Podfile文件。

  2. 删除当前App工程中初始化相关的代码,如API通道SDK初始化代码、账号及用户SDK初始化代码、身份认证SDK初始化代码等。

  3. 使用新的统一初始化接口,并完成SDK的初始化。详细请参见SDK初始化

  4. (可选)添加原来的定制化逻辑,如用户账号的定制化UI等。

API Level 7升级SDK但不用统一初始化方案(不推荐)

说明 该升级方案无法实现全球统一激活,请您慎重选择。
  1. 进入自有品牌AppSDK和插件页面,选择最新的API Level 9,并下载新的SDK套餐项。详细操作请参见下载并集成SDK

    将下载后的压缩包解压,得到的文件夹中包含安全图片和Podfile文件。

  2. 将代码工程中原有Podfile里的SDK版本号,替换为新下载Podfile里的SDK版本号。