更新记录

1.0.0（2026-10-29）

• 新增企业微信初始化、能力检测、打开客户端、授权登录与文本、图片、文件、视频、链接、小程序六类分享API。
• 新增Android/iOS官方SDK原生混编、固定公开依赖、客户端检测、请求隔离、取消超时与释放流程。
• 新增分享受理与真实可关联回执分离、结果未知观察、统一错误码及有界脱敏诊断。
• 新增uni-app与uni-app x真实调用示例、完整环境报告、固定快照分段复制和手动复制回退。
• 新增客户接入说明、原生验收夹具、公共行为与双宿主资源检查；本版为候选源码，Apple编译、匹配基座及真实企业业务须另行验收。

平台兼容性

uni-app(5.33)

uni-app x(5.33)

其他

企业微信授权登录与分享 UTS 插件（Android/iOS）

介绍

lizhao-wecom通过企业微信官方移动端SDK，为uni-app和uni-app x提供Android/iOS企业内部应用授权码登录与内容分享。当前为开发候选源码，尚未发布到插件市场；可用性以实际编译和匹配原生包的验收结果为准。

功能特色

适合哪些场景

本插件不提供H5/扫码登录、服务商代开发SSO、企业群发接口、微信朋友圈、客户联系人自动选择或后台代发消息。Harmony、Web和小程序不提供上述原生业务；导入后的业务调用返回明确不支持错误。

下载与导入

在企业微信管理后台建立企业内部自建应用并开启移动端授权，取得企业corpId、应用agentId及Android/iOS各自的scheme。Android后台包名和签名必须与实际APK一致；iOS后台Bundle ID必须与实际应用一致。scheme使用后台原值，不能自行拼接。

iOS还须把该真实scheme注册到宿主URL Types。uni_modules/lizhao-wecom/utssdk/app-ios/Info.plist仅内置安装查询白名单，不填虚构企业scheme。按项目现有iOS配置合并自己的URL Scheme，不能覆盖其他登录或支付插件的条目。插件通过UTS Hook转交回跳，不需要更改客户真实业务调用路径；完整回跳链仍须用匹配包实测。

从基础到进阶：按业务模块使用

模块一：初始化并取得授权码

以下函数使用真实回调接口，参数由业务配置传入。serverUrl是用户自有HTTPS登录接口（需自行部署），企业Secret/access_token只保留在该后端。

import { initialize, login } from '@/uni_modules/lizhao-wecom'

export function authorizeEnterprise(corpId: string, agentId: string, scheme: string, serverUrl: string): void {
  initialize({
    corpId: corpId, agentId: agentId, scheme: scheme,
    success: () => {
      login({
        timeoutMs: 120000,
        success: (result) => {
          // 只交给业务后端；不把code/state打印或写进复制日志。
          uni.request({
            url: serverUrl, method: 'POST',
            data: { code: result.code, state: result.state, corpId: corpId },
            success: (reply) => { console.log('后端已响应，请按业务合同处理状态码', reply.statusCode) },
            fail: (error) => { console.error('业务后端请求失败', error.errMsg) }
          })
        },
        fail: (error) => { console.error(error.errSubject, error.errCode, error.errMsg) },
        complete: (result) => { console.log('授权调用结束', result.requestId, result.status) }
      })
    },
    fail: (error) => { console.error(error.errSubject, error.errCode, error.errMsg) }
  })
}

后端先使用企业凭据取得企业access_token，再携带code请求企业微信获取用户信息接口，核对业务成员和事务后签发自有会话。取得code或HTTP200都不等于业务已经登录成功。若后端要求绑定自己的登录事务，传入后端生成的一次性随机state并在服务端独立校验；客户端缺省state由原生安全随机源产生，仅用于本次SDK回执关联。

模块二：分享链接并观察真实回执

import { shareLink, onShareResult, offShareResult, cancelRequest } from '@/uni_modules/lizhao-wecom'
import { WeComShareResult } from '@/uni_modules/lizhao-wecom'

export function sendEnterpriseLink(url: string, title: string): string {
  let requestId = ''
  const listener = (result: WeComShareResult): void => {
    if (result.requestId != requestId) return
    console.log('真实SDK回执', result.status, result.errCode)
    offShareResult(listener)
  }
  onShareResult(listener)
  requestId = shareLink({
    url: url, title: title,
    success: (result) => { console.log('已提交企业微信', result.requestId, result.stage) },
    fail: (error) => { offShareResult(listener); console.error(error.errCode, error.errMsg) },
    complete: (result) => { console.log('提交调用结束', result.status) }
  })
  // 页面离开时：offShareResult(listener)，并调用cancelRequest(requestId)停止本地观察。
  // 无真实回执时，最终结果应显示未知；不要凭App返回前台显示“分享成功”。
  return requestId
}

同一SDK通道存在请求或分享观察时，新业务请求返回忙碌错误。需要继续下一项时，等待回执/观察结束，或显式调用cancelRequest停止旧观察；停止观察不会撤回已经提交的内容。

模块三：文件、小程序与生命周期

Android文件支持可读content URI并读取真实DISPLAY_NAME，不要求另一插件把URI猜成文件路径。图片/视频可先用宿主选择API取得本地临时路径；文件来源不足或无访问权限时明确失败。调用方负责保持源文件在提交期间可读，不删除客户原件。

import { shareFile, shareMiniProgram, release, getDiagnosticsSnapshot } from '@/uni_modules/lizhao-wecom'

export function sendExistingFile(filePath: string, fileName: string): string {
  return shareFile({ filePath: filePath, fileName: fileName,
    success: (result) => { console.log('文件提交已受理', result.requestId) },
    fail: (error) => { console.error(error.errCode, error.errMsg) }
  })
}
export function sendAssociatedMiniProgram(userName: string, path: string, title: string): string {
  return shareMiniProgram({ userName: userName, path: path, title: title,
    success: (result) => { console.log('小程序提交已受理', result.requestId) },
    fail: (error) => { console.error(error.errCode, error.errMsg) }
  })
}
export function disposeEnterpriseModule(): void {
  release({
    success: () => { console.log('本模块可释放资源已处理') },
    fail: (error) => { console.error('释放未完全成功', error.errCode, error.errMsg) },
    complete: () => { const snapshot = getDiagnosticsSnapshot(); console.log('保留诊断条数', snapshot.entries.length) }
  })
}

双宿主完整页面及复制路径见uni_modules/lizhao-wecom/example/uniapp/index.vue、uni_modules/lizhao-wecom/example/uniappx/index.uvue。示例所有外部操作都由用户点击，不自动登录或发送资料。

API 用途速查

参数、默认值和限制

超时可选参数的null与省略相同；NaN、无穷、小数、越界或错误类型不能用默认值掩盖。文件类资源保护上限100MiB，这是插件策略。Android上游文本限制按UTF-16字符计数，插件为跨端保护收紧到UTF-8字节；不要把插件限制误解为全部SDK的原始限制。

返回、事件与诊断

能力快照中，六类分享的available同时检查初始化、客户端安装与最低SDK接口能力；reason说明不可用原因。loginSupported表示当前原生SDK接口能力，业务成员身份由后端继续验证。

登录成功包含requestId/platform/code/state/elapsedMs。code/state只在该回调交付，不进入complete、错误或诊断。complete包含errSubject/errCode/errMsg/operation/requestId/stage/status/elapsedMs，其中status描述这次本地API调用终态。

分享成功包含requestId/shareType/stage=dispatched/receiptSupport/elapsedMs。最终事件包含requestId/shareType/source=sdkResponse/status/errCode/error；confirmed仅代表SDK确认，不保证收件人收到或阅读。没有可靠关联的回应时不发布假事件，快照观察状态为unknown。

取消结果包含cancelled/scope/externalResult，scope为request、receipt或none。错误对象在统一字段外保留stage/operation/requestId/externalResult/nativeCode/nativeType/nativeMessage/nativeCause/nativeStack，原生字段无法采集时为null；原生错误码和插件错误码分开保存。

诊断返回独立快照，保留原始错误语义、时间、级别、模块、关联编号和耗时，限制500条/524288个UTF-8字节并显式计数丢弃/截断。深度日志关闭仍保留关键操作与错误。复制报告来自固定快照；系统复制API成功回执与实际剪贴板回读是不同验证层次。

错误码说明

统一errSubject='lizhao-wecom'。SDK原生码在nativeCode中，不能直接当作下表插件错误码。取消、超时与结果未知不代表外部操作已撤销。

注意事项

发布兼容性状态

Vapor兼容性声明为支持。nvue、Harmony、Web、小程序和云端不提供企业微信原生业务。平台集成支持不代表无需企业后台配置即可登录，也不代表分享已送达；真实企业应用、账号及最终回执仍需接入方验收。标题中的iOS表示提供对应实现，当前发布兼容性保留待确认。

• 宿主目标为uni-app Vue2/Vue3和uni-app x；Android目标API21起、iOS目标12起，实际最低要求还受当前宿主和依赖限制。Harmony、Web、小程序不提供原生登录/分享，不能因这些端可导入就标为业务支持。
• 当前Windows可以核对资源生成、Android原生与依赖；Apple SwiftCompile/链接、完整匹配宿主回跳和真实企业微信账号验收必须分别取得证据，不能用本地资源导出代替。候选源码不代表已完成全部宿主/设备验收。
• Android只使用正常网络权限和精确包查询，不请求全盘文件、通讯录、定位或电话权限。content URI需要调用方已经持有合法读取许可；插件不会为了日志额外申请无关权限。
• iOS需要URL查询白名单和宿主真实回跳scheme。iOS SDK没有unregister方法，release只清本模块会话、回调与本地配置，不承诺撤销SDK全局注册。Android实际detach与本模块会话清理分别处理。
• uni_modules/lizhao-wecom/utssdk/app-ios/PrivacyInfo.xcprivacy按Apple官方用途说明声明系统单调时钟用于应用内请求耗时和计时器（35F9.1）。报告仅保留本次操作的耗时，不输出原始系统启动时间；该清单不代替接入方对企业微信SDK及整个App数据处理的隐私说明。最终合并结果须在Apple归档中核对。
• 显式图片不静默压缩；默认小程序图取真实宿主图标，读取或准备失败会返回真实错误。远程文件不在插件内自动下载；代码包静态资源由平台官方路径接口解析，实际原生可读性仍会检查。
• SDK受理后的文件可能仍被外部消费，取消/释放不会立即删除仍需保留的自有副本。缓存有条数/体积/有效期边界，诊断会记录保留与清理；不删除调用方原件，不把本地清理称为撤回分享。
• 用户主动授权/分享时，官方SDK向企业微信客户端传递必要授权参数或所选分享内容。请在业务隐私政策披露SDK用途与腾讯规则：企业微信登录/分享SDK个人信息保护规则。插件不接收企业Secret/access_token，不默认上传客户日志。
• 诊断必须去除授权码、state、Token、Cookie、个人信息、客户文件内容及敏感路径。请通过示例底部完整报告提供故障信息，避免把原始账号凭据或客户文件发到聊天/代码库。
• 增删UTS原生代码、SDK依赖或平台配置后，必须重新原生联编或制作对应自定义基座。仅更新页面资源或WGT不能修复旧基座缺少SDK/入口类的问题。

作者系列 UTS 插件

下表来自项目统一的已发布作者插件清单；当前企业微信候选不加入已上架列表。