基于OpenHarmony 的数字管家应用开发样例

样例简介

数字管家场景需要手机端、设备端和服务端三方协同完成，本文档介绍的demo是数字管家大场景中的手机端应用；用户注册登录后可创建我的家庭并管理家庭成员；可以添加设备（包括智能台灯，智能窗帘，智能养花机等）并进行配网和控制；添加日程编排、控制设备，从而达到多设备联动的效果；除了控制类设备外，告警类设备还可以检测环境状态，并主动将告警消息通知到家庭成员；

运行效果

应用安装成功后效果如下：

样例原理

如上图，本demo是数字管家大场景中的数据管家应用，主要的作用是对设备进行控制，和日程编排，并更新设备状态；

工程版本

• 系统版本/API版本：HarmonyOS Legacy SDK API 7

• IDE版本：DevEco Studio 3.0 Beta2

  注：HarmonyOS是华为基于开源项目OpenHarmony开发的面向多种全场景智能设备的商用版本。

快速上手

准备硬件环境

• 搭载HarmonyOS系统的手机，确保HarmonyOS 手机中api version 在 API 6以上;
• 查看HarmonyOS手机API方法：在HarmonyOS SDK存储目录下的Sdk\toolchains文件下打开命令行工具，执行如下命令进行查询真机设备的apiversion;
• HarmonyOS SDK存储目录可通过DevEco Studio中点击File->setting->SDM Manager->HarmonyOS Legacy SDK;
• 命令如下：

  hdc shell 
  getprop hw_sc.build.os.apiversion // 返回数值是6或者6以上
  

准备开发环境

• 准备HarmonyOS应用的开发环境，请参考 搭建开发环境流程；
• 准备好已实名认证的开发者联盟账号 ，具体 实名认证；
• 开发工具：DevEco Studio 3.0 Beta1 及以上，SDK 请配置 API Version 6 2.2.0.3 版本以上，具体 DevEcoStudio下载
• 打开手机设置 > 应用和服务 > 应用管理 (点击右上角图标，点击显示系统程序选项)，搜索“智慧生活基础服务”，检测智慧生活基础服务的版本是否为12.0.2.306及以上。如果不是，请打开华为手机的“智慧生活”APP，点击“ 我的 > 设置 > 检查应用更新 ”，更新“智慧生活基础服务”。

准备工程

配置git

• 提前注册准备码云gitee账号。
• git工具下载安装

  sudo apt install git
  sudo apt install git-lfs
  

• 配置git用户信息

  git config --global user.name "yourname"
  git config --global user.email "your-email-address"
  git config --global credential.helper store
  

项目地址：https://gitee.com/openharmony-sig/knowledge_demo_smart_home/tree/master/FA/DistSchedule

git下载

git clone https://gitee.com/openharmony-sig/knowledge_demo_smart_home.git --depth=1

工程导入

• DevEco Studio导入本工程;

  打开DevEco Studio,点击File->Open->下载路径/FA/DistSchedule

  

• 并将下列文件bundleName由com.example.distschedule修改为自己申请的包名

  ./netconfig/src/main/js/default/pages/index/index.js
  ./entry/src/config.json
  ./netconfig/src/main/config.json
  

编译

• 准备项目签名文件，并配置签名信息，请参考 申请发布证书和Profile文件/配置签名信息

• 配置多hap包模式，本样例包括一个entry模块，和netconfig模块;

  

• 点击Build->Build Hap/APPs 编译，编译成功生成entry-debug-rich-signed.hap

  

烧录/安装

• 在Phone中，打开“开发者模式”，可在设置 > 关于手机中，连续多次点击“版本号”，直到提示“您正处于开发者模式”即可。

• 然后在设置的系统与更新 > 开发人员选项中，打开“USB调试”开关。

• 使用USB方式，将Phone与PC端进行连接，USB连接方式选择“传输文件，会弹出“是否允许USB调试”的弹框，点击确定。

  

• 识别到phone后点击，或使用默认快捷键Shift+F10（macOS为Control+R)运行应用。

操作体验

设备配网

• 给应用配置配置智慧服务意图， 设备碰一碰配置指南

• 提前准备好智能设备端，且让设备端进入配网模式，可参考设备端无感配网介绍；

• 打开手机NFC功能，打开应用并登陆账号，手机碰一碰智能设备，等待拉起配网页面后开始给设备端配网；

• 在设备端配网成功后，进入设备控制页可控制设备开关机等；

  

新智能设备接入

参考 数字管家设备接入指南，根据文档编写页面、处理相关逻辑和对接服务端接口，即可将已开发完成的智能设备快速接入到数字管家应用端。