快速入门

本文介绍如何在鸿蒙项目中快速上手涂鸦 MiniApp SDK。

初始化 SDK

SDK 初始化代码位于 entry/src/main/ets/app/AppAbilityStage.ets，应用启动时会自动完成初始化。完整的初始化代码示例，请参考示例项目中的 entry/src/main/ets/app/AppAbilityStage.ets 文件。

打开小程序

小程序管理主要介绍操作小程序的 API，包括但不限于：

• 打开小程序
• 打开设备面板

针对不同的业务场景，打开小程序的方式也不尽相同。鸿蒙版本使用 ThingRouter 来打开小程序和面板。

打开小程序

使用 ThingRouter 来打开小程序：

import { ThingRouter } from "@thingsmart/thingrouter";

// 打开小程序
ThingRouter.getInstance()
  .setParam({
    // 小程序 URL，格式为 godzilla://miniprogramId/pagePath?queryA=a
    'url': 'godzilla://miniprogramId/pagePath'  
  })
  .push("miniApp")

打开设备面板

使用 ThingRouter 来打开设备面板：

import { ThingRouter } from "@thingsmart/thingrouter";

// 打开设备面板
ThingRouter.getInstance()
  .setParam({
    'devId': 'deviceId',  // 设备 ID
    'groupId': 'groupId',  // 设备组 ID（可选）
    /**
     * 透传到属性 initialProps 和 contextProps 上
     */
    // 'propsData': {} as Record<string, Object>  // 自定义参数（可选）
  })
  .push("panel")

支持的参数

小程序初始化支持多种参数格式，下表列出了所有支持的参数：

查询相关信息

小程序在运行过程中，需要一些基础信息帮助涂鸦更好地定位问题，所以涂鸦提供了查询部分运行信息的 API。

首先需要获取 MiniAppContainerInfoService 服务实例：

import { MiniAppContainerInfoService } from "@thingsmart/godzillainterface";
import { ThingRouter } from "@thingsmart/thingrouter";

// 获取小程序容器信息服务
const miniappService = await ThingRouter.getServiceMgr()
  .getServiceAsync<MiniAppContainerInfoService>('MiniAppContainerInfoService');

接口说明

/**
 * 返回当前最新的基础库版本
 */
abstract jsSdkVersion(): string;

/**
 * 返回当前 SDK 对应的小程序容器版本
 */
abstract containerVersion(): string;

/**
 * 返回当前 App 依赖的 TTT-Kits 版本信息
 */
abstract tttKitsInfo(): Record<string, string>;

/**
 * 返回最近打开的小程序列表
 */
abstract recentlyOpenedMiniPrograms(): RecentlyOpenedMiniProgram[];

/**
 * 主动清理小程序缓存
 */
abstract cleanCache(): void;

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