每个项目中,允许创建一个自有品牌App。

背景信息

每个App应用包括4个实际的App Key,可分别用于您的App的测试开发和正式发布。

iOS 开发版(用于开发调试)
用户版(用于正式对外发布)
Android 开发版(用于开发调试)
用户版(用于正式对外发布)

操作步骤

  1. 创建App。
    1. 在项目主页面右侧,单击新建自有品牌App

      新建自有品牌App
    2. 配置应用名称和应用包名等信息,并单击确定完成。
      配置的应用名称和应用包名等信息,后期可修改。
      配置应用名称和包名
  2. 获取安全图片。

    获取安全图片
    • 获取iOS安全图片
      1. 下载安全图片,文件名为yw_1222_07e8.jpg
      2. 将安全图片放到工程根目录中。
        安全图片位置ios
      3. 打开xcode工具,将安全图片拖至xcodeproj根目录下。
        安全图片目录
      4. iOS端为了安全性,工程的Bundle Identifier与创建自有App时输入的bundleID(包名)要保持一致。
        bundleID
        包名
    • 获取Android安全图片
      1. 下载安全图片。

        下载Android图片之前需要先上传APK包(即.apk格式的文件),可通过Android Studio工具生成。

        下载后的安全图片的文件名为yw_1222_xxxx.jpg。放置在Android工程目录中的src\oversea\res\drawable下。


        安全图片目录
      2. 配置签名。

        Android 端上,安全图片是需要和签名搭配使用。

        确认build.gradle文件中包含以下内容,并确保与生成APK包中配置的内容一致。

        android{
        
            signingConfigs {
                debug {
                    storeFile file("./debug.keystore")
                    storePassword '123456'
                    keyAlias 'android'
                    keyPassword '123456'
                }
            }
        
            buildTypes{
                debug {
                    signingConfig signingConfigs.debug
                }
            }
        }
        									
  3. 打开产品的关联状态开关。

    关联产品列表中的产品,为当前项目主页面中显示的产品。关联后,在App端调用待配网设备的API时,可以获取到该产品的信息。

    产品的开发状态决定产品是否具备进入正式版App的能力。
    • 若开关开启,且该产品开发中,则默认展示在测试版App的配网入口。
    • 若开关开启,且该产品已发布,则默认展示在正式版App的配网入口。
    • 若开关关闭,该产品状态无论是开发中还是已发布,测试版和正式版App配网入口都隐藏。

    关联产品
  4. 配置用户账号。
    用户账号支持两种账号体系:内置账号体系和自有账号体系。
    • 如果开发者没有自己的账号体系,可以采用内置账号体系,内置账号体系无需配置,已经内置在SDK套餐包中,提供文档调用方法。
    • 如果开发者有自己的账号体系,可以采用自有账号体系,若勾选自有账号体系,则必须填写页面中的配置信息,否则自有账号将无法正常使用。

    配置账户
  5. 配置App界面。
    平台提供了一些常用的免开发界面,如配网、设备界面、定时、自动化场景、意见反馈等智能生活类App常用的页面模块。单击生成代码,将生成的代码嵌到自己的代码中,即可实现该功能模块的调用。
    配置App界面
  6. SDK下载。

    根据关联的产品,选择合适的 “API Level”(SDK套餐包版本),并勾选和配置需要的SDK套餐项。平台会自动生成的SDK配置包。您只需下载集成开发即可。

    API Level是SDK套餐项的功能版本等级,用来解决新老SDK套餐项不兼容问题,每个API Level包含一组SDK套餐项,不同API Level的SDK套餐项功能不同,先选择适合的API Level,一般建议选择最新的API Level。

  7. Android集成SDK。
    推荐开发工具为Google官方的Android Studio(建议使用最新版本3.0.x)。
    添加依赖文件
    1. 将下载的Android SDK Pom dependency.gradle文件放到Module的根目录下。
    2. 在模块根目录的build.gradle文件中,添加以下代码。
      apply from:'dependency.gradle'
  8. iOS集成SDK。
    本SDK采用cocoapods
    1. 将下载的IOS SDK Podfile文件放到工程文件夹根目录。
    2. 修改文件中的target名称与xcode工程的设置一致。
    3. 执行pod update

后续步骤

更多操作,查看开发指南中App端开发。