更新记录

1.0.1（2026-03-20） 下载此版本

• 修复：空包问题

#

1.0.0（2026-03-20） 下载此版本

• 首发：HarmonyOS NEXT（API 11+）原子支付/系统分享/账号登录三合一 UTS 插件
• 纯系统原生能力封装：无第三方 SDK、无 token 消耗
• 提供示例工程与权限/配置说明

平台兼容性

uni-app(4.45)

uni-app x(4.45)

zy-next-psl（鸿蒙 Next 支付/分享/登录 三合一原生 UTS 插件）

简介

zy-next-psl 是面向 HarmonyOS NEXT（API 11+） 的三合一原生插件，包含：

• 原子支付：调用系统原子支付能力（不接入微信/支付宝等第三方 SDK）
• 系统分享：调用系统分享面板
• 账号登录：基于系统账号体系（OS Account / AppAccount）获取账号标识

插件仅封装系统原生 API：无第三方 SDK 依赖、无 token 消耗。支付“下单/签名/风控”等仍应由你的业务服务端完成。

安装

将本插件目录 zy-next-psl 复制到项目的 uni_modules/ 下即可。

API

入口：

import { zyNextPayShareLogin } from '@/uni_modules/zy-next-psl/utssdk/index.uts'

1) init(options?)

await zyNextPayShareLogin.init({
  debug: true,
  // 推荐：传入 Harmony context（UIAbility/Stage context），避免部分运行时拿不到
  context: (globalThis as any).__uniContext
})

2) pay(options)

const res = await zyNextPayShareLogin.pay({
  // 业务服务端返回的支付参数（建议 JSON 字符串，插件内部会 best-effort 解析）
  orderInfo: '{"amount":1,"tradeNo":"..."}',
  attach: 'order_123'
})

3) share(options)

await zyNextPayShareLogin.share({
  title: '分享标题',
  text: '分享内容',
  url: 'https://example.com'
})

4) login(options?)

const user = await zyNextPayShareLogin.login({ preferOsAccount: true })
// user.userId: "os:100" 或 "app:xxx"

鸿蒙权限与配置（重要）

插件会在需要时 best-effort 触发系统授权弹窗（如账号读取 GET_ACCOUNTS）。你仍需要在宿主应用侧声明权限（以 DevEco / HBuilderX 实际生成结构为准）。

module.json5（参考）

在你的鸿蒙工程 entry/src/main/module.json5（或等价位置）中添加需要的权限声明：

{
  "module": {
    "requestPermissions": [
      { "name": "ohos.permission.GET_ACCOUNTS" }
    ]
  }
}

如你的支付流程需要网络请求（下单/查询/回调），请在宿主应用按业务补充联网权限（例如 ohos.permission.INTERNET）。

Context 注入（推荐）

部分运行时环境下，UTS 插件内部可能拿不到 Harmony 的 context。推荐你在应用启动时注入：

• 在业务侧把 UIAbility context 赋值给 globalThis.__uniContext
• 或调用 init({ context }) 显式传入

若未注入，插件会抛出明确错误提示。

说明与限制

• 本插件 不包含任何第三方 SDK（微信/支付宝等），仅调用系统能力。
• 原子支付的 orderInfo 必须由你的业务服务端按平台要求生成；插件只负责拉起支付并返回系统结果。
• 系统分享属于“拉起面板”能力，是否真正分享成功由系统/目标应用决定，插件返回值以 best-effort 为准。

许可证

MIT