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

概述

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

类别 API Level 7及以下SDK API Level 8 SDK API Level 9 SDK
初始化 每个SDK分别初始化 统一初始化 统一初始化
安全图片 4张(分别对应原中国站与原国际站、原测试版与正式版) 2张(分别对应原中国站与原国际站) 1张(全球适用)
App在中国内地与内地以外地区切换时的操作 切换安全图片,并重启App 切换安全图片,并重启App 无需任何操作

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

当前SDK集成情况 升级方案
未集成任何版本SDK

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

已集成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 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版本号。