更新记录

1.0.1（2026-08-04）

• 修复 HarmonyOS 平台文件缺少公开 API 同名导出，导致 uni-app x 调用 getApiSupportInfo / isInstall / isWXAppSupportApi 等接口时报 undefined is not callable 的问题。
• 保留原有 *ByHarmony 平台分发入口，并补齐 interface.uts 声明的微信公开 API 代理，不影响 Android、iOS、Web、小程序和既有 uni-app 调用入口。
• HarmonyOS 当前继续返回明确的微信能力降级结果；登录、分享、支付等真实能力仍需对应微信开放平台配置和 Harmony SDK 支持。
• Harmony 原生 UTS 已变化，升级后需要重新构建并安装匹配的 Harmony HAP 或自定义基座。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

# lizhao-wechat-kit

lizhao-wechat-kit 是纯 UTS 的微信开放能力 API 插件，支持统一调用微信注册、授权登录、分享、支付、商家转账用户确认、打开小程序、打开客服与微信回流监听。

插件简介

• 插件名：lizhao-wechat-kit
• 插件类型：UTS API 插件
• 调用环境：uni-app / uni-app x
• 导入路径：@/uni_modules/lizhao-wechat-kit

目录结构

uni_modules/lizhao-wechat-kit
├─ package.json
├─ readme.md
├─ changelog.md
└─ utssdk
   ├─ interface.uts
   ├─ unierror.uts
   ├─ index.uts
   ├─ app-android
   ├─ app-ios
   ├─ app-harmony
   ├─ web
   ├─ mp-weixin
   └─ mp-alipay

支持平台

安装说明

import * as WeChatKit from '@/uni_modules/lizhao-wechat-kit'

API 列表

• register(options)
• isInstall()
• isWXAppSupportApi(api)
• openWXApp(options)
• getApiSupportInfo(options)
• login(options)
• share(options)
• pay(options)
• requestMerchantTransfer(options)
• launchMiniProgram(options)
• openCustomerService(options)
• onLaunchFromWX(options)
• offLaunchFromWX(listener?)
• getTTWeChatSDK()

参数说明

register(options)

login(options)

share(options)

pay(options)

requestMerchantTransfer(options)

launchMiniProgram(options)

openCustomerService(options)

onLaunchFromWX(options)

返回值说明

错误码说明

权限说明

• Android：按微信 OpenSDK 要求完成应用与权限配置。
• iOS：需配置 URL Scheme 与 Universal Link。

自定义基座说明

本插件接入微信 OpenSDK（原生依赖与平台配置），默认需要自定义基座。

uni-app 示例

import * as WeChatKit from '@/uni_modules/lizhao-wechat-kit'

WeChatKit.register({
  appId: 'wx1234567890abcdef',
  universalLink: 'https://your.domain.com/app/',
  success() {
    WeChatKit.login({
      state: Date.now().toString(),
      success(res) {
        console.log('login code =', res.code)
      },
      fail(err) {
        console.error('login fail', err)
      }
    })
  }
})

uni-app x 示例

import * as WeChatKit from '@/uni_modules/lizhao-wechat-kit'

WeChatKit.register({
  appId: 'wx1234567890abcdef',
  universalLink: 'https://your.domain.com/app/'
})

WeChatKit.share({
  type: 3,
  scene: 0,
  title: '分享标题',
  desc: '分享描述',
  href: 'https://example.com'
})

注意事项

1. 必须先调用 register，再调用其他微信能力。
2. pay 与 requestMerchantTransfer 的签名参数必须由服务端生成。
3. 不支持平台会返回明确错误，不会静默成功。
4. iOS 需确保开放平台配置与 universalLink 严格一致。

联系方式

信-微：l-z-1-8-7-1512-5421（-去掉，不这样写会被和谐）

作者系列UTS插件

以下为已在 DCloud 插件市场上架的作者系列 UTS 插件，可按业务场景组合使用。未列出的插件表示当前未确认公开市场页，后续上架后再补充。