智能生活家电方案中,一个项目包括一个智能App,让消费者可以通过移动终端对设备配网、绑定、控制、状态进行查看和接收通知。

背景信息

当前平台为开发者提供了两种App形式,开发者可以根据自己的情况选择。

  • 公版App

    无需额外开发,简单配置完界面后即可使用。

  • 自有品牌App

    需要基于平台提供的SDK、API和插件,对产品进行配网、控制和场景自动化配置。适合希望定制品牌App的客户。

此处以创建Android自有App为例介绍,并利用Demo App快速开始,帮助您熟悉整个自有App开发的流程。创建iOS自有App可参见利用DemoApp快速开始

操作步骤

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

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

    获取安全图片
    1. 上传APK包(即.apk格式的文件),可通过Android Studio工具生成。
    2. 下载安全图片,文件名为yw_1222_xxxx.jpg
    3. 将安全图片放置在Android工程目录中的src\oversea\res\drawable路径下。
    4. 配置签名。

      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. 下载Demo App。
    1. 单击Demo App对应的查看
    2. 勾选“我同意 《软件许可协议》”。
    3. 单击Dmeo源码下载
  6. 构建APK包。

    推荐使用Android Studio工具构建APK包。在Android Studio工具中,选择Build > > analyze APK,并配置本地保存路径。


    打包

    Demo App中已包含各功能模块的默认服务,可以直接构建APK包,此处跳过App界面的配置和SDK下载的配置。

    如果需要对SDK和插件进行开发,可参考开发指南中相关章节。各SDK使用到的官方服务列表对应关系如下。

    SDK 名称 服务名称
    API 通道 官方基础服务
    长连接通道 应用与插件服务、长连接推送服务
    用户及账号 用户服务
    移动应用推送 移动应用推送服务
    BoneMobile 容器 应用与插件服务
    用户认证SDK 用户服务
  7. 在安卓市场上线该APK包,终端用户下载后可在Android手机上使用该App。