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. 进入自有品牌App的SDK和插件页面,选择最新的API Level 9,并下载新的SDK套餐项。详细操作请参见下载并集成SDK

    下载到本地的文件为压缩包,解压后包含安全图片和dependency.gradle文件。

    说明 由于下载Android安全图片需要先上传apk签名文件,如果您没有上传apk签名文件,压缩包里就不包含安全图片。更多信息,请参见集成安全图片
  2. 使用统一初始化接口,并完成SDK的初始化。详细请参见SDK初始化

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

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

    当您需要同时管理两个项目下的App时,您还需要根据以下步骤来设置安全图片后缀名。

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

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

      IoTSmart.setAuthCode(String authCode); 
      //authCode为重命名的安全图片名称后缀名,即示例中的xxxyyy
      //authCode不设置或设置为空时,App默认加载名称为yw_1222_china_production.jpg的安全图片

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

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

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

    下载到本地的文件为压缩包,解压后包含安全图片和dependency.gradle文件。

    说明 由于下载Android安全图片需要先上传apk签名文件,如果您没有上传apk签名文件,压缩包里就不包含安全图片。更多信息,请参见集成安全图片
  2. 删除当前App工程中初始化相关的代码,如APIGatewaySDKDelegate、OpenAccountSDKDelegate、DeviceCenterSDKDelegate等。

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

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

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

说明

该升级方案无法实现全球统一激活,请您慎重选择。

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

    下载到本地的文件为压缩包,解压后包含安全图片和dependency.gradle文件。

    说明 由于下载Android安全图片需要先上传apk签名文件,如果您没有上传apk签名文件,压缩包里就不包含安全图片。更多信息,请参见集成安全图片
  2. 拷贝至App工程build.gradle同级目录,替换原来的同名文件。

  3. build.gradle里添加以下代码。

    apply from: "dependencies.gradle"