快速集成鸿蒙 App SDK

本文介绍如何将鸿蒙版涂鸦智能生活 App SDK 集成到您的开发环境中，例如 DevEco-Studio，并介绍初始化方法以及如何启用调试模式。然后，您可以尝试运行 Demo，快速上手全屋智能移动应用开发。

前提条件

• 开始操作前，请确保您已经完成 准备工作。

• 如果您还未安装 DevEco Studio，请访问 鸿蒙官网 进行下载安装。

• 智能生活 SDK 分为开发版和正式版。详情请参考 产品定价。

集成 SDK

第一步：创建 Harmony 工程

在 DevEco-Studio 中新建工程。

第二步：下载 SDK 包

1. 首先，登录 涂鸦开发者平台 并进入 SDK 开发 页面，单击页面右上角 创建 App 完成智能生活 App SDK 的创建，然后在 获取鸿蒙 SDK 页签下填写应用包名作为上架到应用市场的唯一标识并单击 确定 保存。

   

2. 在配置页面，勾选一款或多款您需要的 SDK 或者业务包，然后下载对应应用平台的集成资料包。

   

第三步：设置关键信息

SDK 包含以下文件：

• t_s.bmp：专属鸿蒙 SDK 安全图片。
• TSmartSecurity.har：专属鸿蒙 SDK 库文件。

集成步骤

1. 添加安全图片。将 t_s.bmp 文件添加到鸿蒙工程的 /entry/src/main/resources/rawfile/ 目录下。

2. 配置依赖。在工程根目录下的 oh-package.json5 文件中，于 overrides 字段中声明集成 TSmartSecurity.har：

   {
     "modelVersion": "5.0.2",
     "description": "Please describe the basic information.",
     "dependencies": {
     },
     "devDependencies": {
     },
     "overrides": {
      // 使用项目目录的相对路径，可以将下载的文件移动到项目中，并修改确认路径
       "@thingsmart/security": "./sdk_TSmartSecurity.har"
     },
     "dynamicDependencies": {}
   }
   

   请根据实际项目目录结构调整 file: 后的相对路径。

   将依赖文件 dependencies.txt 中依赖的组件版本拷贝至项目中需要使用对应功能的 Module 的 oh-package.json5 的 Dependencies 下。

3. 配置 Tuya ohpm 环境。在终端中，配置 ohpm 的涂鸦环境。

   ohpm config set @thingsmart:registry https://ohpm-repo.tuya.com/repos/ohpm
   
   ohpm config set @rnoh:registry https://ohpm-repo.tuya.com/repos/ohpm
   
   ohpm config set @tuya-oh:registry https://ohpm-repo.tuya.com/repos/ohpm
   
   ohpm config set //ohpm-repo.tuya.com/repos/ohpm/:_read_auth NTllMTBlMmIzOGE4NDljOWEyYjE3ZWU2MmEyNDdhNDk=
   

4. 配置应用包名。确认 App 包名与 SDK 一致。如不一致，需要修改包名：前往 /AppScope/app.json5 文件，修改 bundleName 字段。

   修改包名后，IDE 可能存在缓存问题。建议清理项目缓存后重新构建，确保运行包名为修改后的正确包名。

5. 初始化 SDK。从涂鸦开发者平台获取 AppKey 和 AppSecret，然后集成 Tuya 鸿蒙 App SDK 并完成初始化：

   import { TSmartSDK } from "@thingsmart/channel"
   
   let applicationContext = this.context.getApplicationContext();
   TSmartSDK.startWithAppKey(AppKey, AppSecret, applicationContext, '你的鸿蒙 App 包名')
   

   请根据您的实际情况将代码中的 AppKey、AppSecret 和 你的鸿蒙 App 包名 替换为真实值。

第四步：运行 Demo 应用

Demo 应用演示 App SDK 的开发流程，展现如何调用 SDK 能力、实现智能家居场景。在开发应用之前，建议您根据需要先按照以下流程完成 Demo 应用的操作。

Demo 应用介绍

Demo 应用主要包括：

• 用户管理：使用手机号或者邮箱进行登录和注册。

• 家庭管理和设备管理：

  • 创建家庭，切换用户所属的当前家庭。
  • 展现家庭中设备列表，控制设备功能。
  • 设备重命名和设备移除。

• 设备配网：包括 Wi-Fi 快连配网模式、热点配网模式、有线网关配网、网关子设备配网、蓝牙配网、Mesh 子设备配网。

更多详情，请访问 GitHub 项目：tuya-home-harmony-sdk-sample。

运行 Demo

1. 完成设置 Appkey、AppSecret 和安全图片以及初始化 SDK。
2. 单击运行，运行 Demo。