快速集成鸿蒙 App SDK

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

前提条件

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

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

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

集成 SDK

第一步：创建 Harmony 工程

在 DevEco-Studio 中新建工程。

第二步：下载 SDK 包

根据IOT平台入口配置鸿蒙相关包名信息。

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

第三步：设置关键信息

SDK 包含以下文件：

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

集成步骤

第一步 - 添加安全图片

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

第二步 - 配置依赖

在工程根目录下的 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下。

第三步 - 配置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=

第四步 - 配置应用包名

确认 App 包名与 SDK 一致。如不一致，需要修改包名。

修改方法：前往 /AppScope/app.json5 文件，修改 bundleName 字段。

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

第五步 - 初始化 SDK

从 IoT 平台获取 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 子设备配网。

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

运行 Demo

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