鸿蒙端如何跳转微信和支付宝小程序

欢迎到专业群（ uni-app鸿蒙化技术交流群 ） 咨询，群中有相关专业的管理员和群友。

在鸿蒙端（HarmonyOS App）跳转微信和支付宝小程序，目前 uni-app 官方暂未提供统一的内置 API 直接支持，但可以通过以下方案实现：

推荐方案：使用插件市场插件

插件市场已有现成的解决方案 APP 端应用打开微信和支付宝小程序插件，该插件支持在鸿蒙（HarmonyOS）、Android、iOS 端跳转微信和支付宝小程序。

接入要点：

1. 平台差异处理：鸿蒙端与 Android/iOS 的 app-plus 配置不同，需使用 app-harmony 相关配置，且需通过 UTS 插件方式调用原生能力。

2. 前置条件：

   • 微信：需在微信开放平台创建「移动应用」（非小程序），获取移动应用 AppID，并配置鸿蒙包名与签名
   • 支付宝：需在支付宝开放平台创建移动应用，获取 alipayAppId

3. 代码示例（基于上述插件）：

   
   import { launchMiniProgram } from '@/uni_modules/app-miniprogram-launcher/unified-launcher'  

// 跳转微信小程序
await launchMiniProgram({
type: 'weixin',
userName: 'gh_XXXXXXXXXXXX', // 小程序原始ID
appId: 'wxXXXXXXXXXXXXXXXX', // 微信开放平台移动应用AppID
path: 'pages/index/index',
miniProgramType: 0 // 0正式版/1开发版/2体验版
})

// 跳转支付宝小程序
await launchMiniProgram({
type: 'alipay',
alipayAppId: '202100XXXXXXXXXX', // 支付宝开放平台应用ID
path: 'pages/home/index'
})

> **本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用[uni-agent](https://uniapp.dcloud.net.cn/ai/)**  

**注意事项：**  
- 鸿蒙端配置与 Android/iOS 不同，不能直接将 `app-plus` 的配置套用到鸿蒙，需在 `manifest.json` 的 `app-harmony` 节点下配置微信 SDK 相关参数  
- 真机需安装微信和支付宝客户端  
- 如遇到具体配置问题，建议在 [ask 社区](https://ask.dcloud.net.cn) 提供复现工程详细描述操作步骤  

如果是鸿蒙元服务（MP-HARMONY）场景，则与鸿蒙应用（APP-HARMONY）的实现方式不同，需使用对应平台的跳转能力。

UniApp‑X 鸿蒙端跳转微信 / 支付宝小程序
⚠️uni.navigateToMiniProgram 在鸿蒙 App 环境完全无效，该 API 只在小程序环境可用
1、跳转微信小程序（鸿蒙 Next）
必须集成微信 Open‑SDK for HarmonyOS，不能用weixin://scheme，鸿蒙系统拦截裸 Scheme 跳转
前置：微信开放平台新建鸿蒙移动应用，录入鸿蒙包名、证书指纹，应用提交审核；
⚠️未上架应用，每日跳转上限 100 次，调试容易超限报错跳转失败
参数：填小程序原始 ID gh_xxxx，不是 wx‑appId，填页面路径，miniprogramType (0 正式 / 1 开发 / 2 体验)
UniApp‑X：直接使用 UTS 插件市场现成插件 app‑miniprogram‑launcher / zzc‑wechat‑hm，封装好微信鸿蒙 SDK，不用手写 ets 原生代码。
ts
//UTS插件调用伪代码
await launchMiniProgram({
platform:"wechat",
userName:"gh_xxxx", //小程序原始ID
path:"pages/index/index?id=123",
miniprogramType:0
})
2、跳转支付宝小程序（鸿蒙 Next）
支付宝没有提供鸿蒙版 SDK，只可以用系统openLink调用 alipays:// Scheme 协议拉起
ts
//鸿蒙uts代码
import common from '@ohos.app.ability.common';
let context = getContext(this) as common.UIAbilityContext
//appId为支付宝小程序appId，page需要urlEncode编码
const url = alipays://platformapi/startapp?appId=2021xxxx&page=${encodeURIComponent("pages/index/index")}
await context.openLink(url)
需要提前判断用户设备安装支付宝，openLink 会抛异常捕获；
如需跳转后回调回自己 App，增加参数&backSCAppScheme=你的自定义scheme，并在 module.json5 注册 scheme 接收回调。
⚠️关键坑清单
微信鸿蒙 SDK：包名、证书指纹必须和微信开放平台填写完全一致，否则直接跳转失败；未上架 App 每日 100 次限额调试限制。
微信跳转参数：用gh_原始 ID，不是 wx 开头 appId，填 wx‑appId 直接报错。
支付宝没有鸿蒙 SDK，只靠 Scheme，系统版本、支付宝版本会影响成功率。
条件编译：鸿蒙端使用#ifdef APP‑HARMONY，不要用#ifdef APP‑PLUS。
降级方案：用户没有安装微信 / 支付宝，打开小程序 H5 网页作为兜底。
快速选型
不想手写原生 ETS 代码，直接 DCloud 插件市场安装：app‑miniprogram‑launcher，一套 API 兼容 Android/iOS/ 鸿蒙，微信走官方 SDK，支付宝走 scheme。