当您开发自有App,下载并集成SDK后,需要对所有SDK进行初始化。

概述

从API Level 8开始,SDK的初始化不再需要挨个初始化SDK,而可以使用统一的初始化接口,一次性完成所有的所需SDK的初始化。如果您使用的是API Level 7或以下版本,建议您升级至最新版本,详细请参见SDK升级

根据开发者下载SDK时勾选的SDK配置项,统一接口对如下SDK逐一初始化。

  • API通道SDK (必选初始化)
  • 账号及用户SDK (必选初始化)
  • 身份认证SDK(必选初始化)
  • 长连接通道SDK
  • 设备模型SDK
  • 移动应用推送SDK
  • BoneMobile容器SDK

统一初始化支持默认初始化和带参数初始化两种方式,区别如下。

  • 如果您的设备仅在中国大陆使用,建议使用默认初始化。默认初始化不可以自定义,固定为直连中国大陆接入点的正式版环境。
  • 如果您的设备可能销往全球(除中国大陆以外地区),建议使用带参数初始化。用带参数初始化可以自定义,包括选择接入类型(中国大陆/全球),选择环境版本(测试版/正式版),是否打开日志,以及定制三方通道离线推送参数等。

SDK初始化

  1. 集成安全图片。详细操作请参见集成安全图片
    说明 安全图片文件名根据站点、版本的不同而存在差异。请勿修改安全图片名称,下载后直接拷贝到App工程目录下。
  2. 下载并集成SDK。详细操作请参见下载并集成SDK
  3. 初始化SDK。
    • 默认初始化
      IoTSmart.init(application); //application是APP环境上下文Application
    • 带参数初始化
      // 初始化参数配置
      IoTSmart.InitConfig initConfig = new IoTSmart.InitConfig()
                      // REGION_ALL: 支持连接中国大陆和海外多个接入点,REGION_CHINA_ONLY:直连中国大陆接入点,只在中国大陆出货选这个
                      .setRegionType(REGION_ALL) 
                      // 对应控制台上的测试版(PRODUCT_ENV_DEV)和正式版(PRODUCT_ENV_PROD)
                      .setProductEnv(IoTSmart.PRODUCT_ENV_PROD)
                      // 是否打开日志
                      .setDebug(true);
      
              // 定制三方通道的离线推送,目前支持华为、小米和FCM
              IoTSmart.PushConfig pushConfig = new IoTSmart.PushConfig();
              pushConfig.fcmApplicationId = "fcmid"; // 替换为从FCM平台申请的id
              pushConfig.fcmSendId = "fcmsendid"; // 替换为从FCM平台申请的sendid
              pushConfig.xiaomiAppId = "XiaoMiAppId"; // 替换为从小米平台申请的AppID
              pushConfig.xiaomiAppkey = "XiaoMiAppKey"; // 替换为从小米平台申请的AppKey
              // 华为推送通道需要在AndroidManifest.xml里面添加从华为评审申请的appId
              initConfig.setPushConfig(pushConfig);
      
              // 初始化
              IoTSmart.init(app, initConfig);                   

      三方通道的离线推送的详细介绍请参见移动应用推送开发指南