更新记录

0.0.3（2026-05-15） 下载此版本

0.0.3

插件支持鸿蒙系统

0.0.2（2026-04-10） 下载此版本

兼容HbuilderX4.14

0.0.1（2026-04-07） 下载此版本

Version: 0.0.1

新增企微鉴权登录插件

平台兼容性

uni-app(4.84)

cnd-wecom-auth

企业微信鉴权登录 UTS 原生插件，基于企业微信官方 SDK 实现，支持 Android、iOS 和鸿蒙（HarmonyOS Next）三端。

鸿蒙端接入说明

1. 获取 SDK

前往企业微信开发者文档下载 HarmonyOS SDK HAR 包（文件名为 lib_wwapi.har），放入：

utssdk/app-harmony/libs/lib_wwapi.har

2. 企业微信后台配置

在企业微信管理后台 -> 应用管理 -> 自建应用 -> 企业微信授权登录中，添加鸿蒙应用的包名（Bundle Name）。

3. 调用授权

调用方式与 Android/iOS 完全一致：

import { sendWecomAuth, isWecomInstalled } from "@/uni_modules/cnd-wecom-auth"

sendWecomAuth({
  corpId: 'your_corp_id',
  agentId: 'your_agent_id',
  success(res) {
    console.log('授权码:', res.code)
  },
  fail(err) {
    console.error('授权失败:', err.errMsg)
  }
})

4. 授权回调处理

鸿蒙端企微 SDK（@tencent/wecom_open_sdk）在 WWAPIFactory.createWWAPI(context) 内部已自动注册 AbilityLifecycleCallback，由 SDK 接管 onNewWant 回调处理，无需在 UIAbility 中手动调用任何回调函数。

调用 sendWecomAuth 后，授权结果直接通过 success / fail 回调返回，与 Android/iOS 行为一致。

关于 utssdk/index.uts

本插件目录下除了各平台目录的 index.uts 之外，还应保留 utssdk/index.uts 作为通用入口。

这是 uni-app 的 UTS 模块解析要求，不是企业微信 SDK 自身要求。项目中如果这样导入：

import { sendWecomAuth, isWecomInstalled } from "@/uni_modules/cnd-wecom-auth"

那么在 H5 开发或其他非 App 平台的依赖扫描阶段，构建工具会先尝试解析 utssdk/index.uts 或 utssdk/<当前平台>/index.uts。如果插件只有平台实现而没有通用入口，就会在扫描阶段直接报模块找不到。

建议插件结构保持为：

• utssdk/app-android/index.uts：Android 真正实现
• utssdk/app-ios/index.uts：iOS 真正实现
• utssdk/app-harmony/index.uts：鸿蒙真正实现
• utssdk/index.uts：非 App 平台兜底入口，至少保证模块可解析

这样可以避免以下问题：

• H5 开发时 Vite 依赖扫描失败
• 条件编译代码还没被裁掉，导入阶段先报错
• 插件目录结构和 uni-app 的默认解析规则不一致