樣例簡介

數字管家場景需要手機端、設備端和服務端三方協同完成，本文檔介紹的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存儲目錄下的Sdktoolchains文件下打開命令行工具，執行如下命令進行查詢真機設備的apiversion;
• HarmonyOS SDK存儲目錄可通過DevEco Studio中點擊File->setting->SDM Manager->HarmonyOS Legacy SDK;
• 命令如下：

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

準備開發環境

• 準備HarmonyOS應用的開發環境，請參考 [搭建開發環境流程][gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
• 準備好已實名認證的開發者聯盟賬號；
• 開發工具：DevEco Studio 3.0 Beta1 及以上，SDK 請配置 API Version 6 2.2.0.3 版本以上
• 打開手機設置 > 應用和服務 > 應用管理 (點擊右上角圖標，點擊顯示系統程序選項)，搜索“智慧生活基礎服務”，檢測智慧生活基礎服務的版本是否為12.0.2.306及以上。如果不是，請打開華為手機的“智慧生活”APP，點擊“ 我的 > 設置 > 檢查應用更新 ”，更新“智慧生活基礎服務”。

準備工程

配置git

• 提前注冊準備碼云gitee賬號。
• git工具下載安裝

  鴻蒙開發文檔知識更新在：mau123789是v可以直接拿取
  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
  

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
  

編譯

• 準備項目簽名文件，并配置簽名信息
• 配置多hap包模式，本樣例包括一個entry模塊，和netconfig模塊;
  
• 點擊Build->Build Hap(s)/APP(s) 編譯，編譯成功生成entry-debug-rich-signed.hap
  

燒錄/安裝

• 在Phone中，打開“開發者模式”，可在設置 > 關于手機中，連續多次點擊“版本號”，直到提示“您正處于開發者模式”即可。
• 然后在設置的系統與更新 > 開發人員選項中，打開“USB調試”開關。
• 使用USB方式，將Phone與PC端進行連接，USB連接方式選擇“傳輸文件”，會彈出“是否允許USB調試”的彈框，點擊確定。
  
• 識別到phone后點擊，或使用默認快捷鍵Shift+F10（macOS為Control+R)運行應用。

操作體驗

設備配網

• 給應用配置配置智慧服務意圖，
• 提前準備好智能設備端，且讓設備端進入配網模式；
• 打開手機NFC功能，打開應用并登陸賬號，手機碰一碰智能設備，等待拉起配網頁面后開始給設備端配網；
• 在設備端配網成功后，進入設備控制頁可控制設備開關機等；
  

審核編輯 黃宇