更新记录

1.0.0（2026-02-15）

基于微信开放 SDK 的 HarmonyOS 跳转微信小程序 UTS 插件，支持 uni-app 和 uni-app x 项目。

平台兼容性

uni-app(4.76)

uni-app x(4.76)

HarmonyOS 跳转微信小程序 UTS 插件

基于微信开放 SDK 的 HarmonyOS 跳转微信小程序 UTS 插件，支持 uni-app 和 uni-app x 项目。

功能特性

• ✅ 支持 HarmonyOS 系统跳转微信小程序
• ✅ 支持正式版、开发版、体验版小程序
• ✅ 支持自定义小程序页面路径
• ✅ 完整的错误处理机制
• ✅ TypeScript 类型支持

安装配置

1. 配置依赖

确保 utssdk/app-harmony/config.json 中已配置微信开放 SDK：

{
  "dependencies": {
    "@tencent/***_open_sdk": "^1.0.0"
  }
}

2. 配置权限

插件会自动配置以下权限：

• ohos.permission.INTERNET - 网络访问权限

3. 获取微信 AppID

1. 在微信开放平台注册应用
2. 获取应用的 AppID
3. 在代码中配置 AppID

4. 配置小程序信息

• userName: 小程序的原始ID（例如：gh_ff02937dbaec）
• path: 小程序页面路径（例如：/pages/index/index）
• miniprogramType: 小程序类型（0-正式版、1-开发版、2-体验版）

使用方法

方式一：直接调用插件方法

import { launchMiniProgram } from "@/uni_modules/zzc-***-miniprogram-harmony";

launchMiniProgram({
  appId: "your_***_appid",
  userName: "gh_ff02937dbaec",
  path: "/pages/index/index",
  miniprogramType: 0,
}).then((result) => {
  if (result.success) {
    console.log("跳转成功");
  } else {
    console.error("跳转失败:", result.error);
  }
});

方式二：使用工具函数

import { navigateTo***MiniProgram } from "@/utils/help";

// 跳转到正式版小程序首页
navigateTo***MiniProgram(0, "/pages/index/index");

// 跳转到开发版小程序指定页面
navigateTo***MiniProgram(1, "/pages/detail/index");

API 说明

launchMiniProgram

跳转微信小程序

参数：

• options.appId (string, 必填): 微信 AppID
• options.userName (string, 必填): 小程序的原始ID
• options.path (string, 可选): 小程序页面路径，默认为 /pages/index/index
• options.miniprogramType (number, 可选): 小程序类型，默认为 0
  • 0: 正式版
  • 1: 开发版
  • 2: 体验版

返回值：

Promise<LaunchMiniProgramResult>;

LaunchMiniProgramResult：

• success (boolean): 是否成功
• error (string, 可选): 错误信息
• errorCode (number, 可选): 错误代码

错误代码：

• -1: appId 不能为空
• -2: userName 不能为空
• -3: 微信 API 初始化失败
• -4: 未安装微信客户端
• -5: 无法获取应用上下文
• -6: 跳转请求发送失败
• -999: 未知错误

注意事项

1. 微信客户端：确保用户已安装微信客户端
2. AppID 配置：必须在微信开放平台注册应用并获取 AppID
3. 小程序 ID：确保 userName 是正确的小程序原始ID
4. 权限配置：确保应用已配置网络访问权限
5. 测试环境：建议在真机上测试，模拟器可能无法正常跳转

参考文档

• HarmonyOS 鸿蒙 Next 中 UniApp 开发的 APP 如何跳转到微信小程序？
• 微信开放平台