更新记录

1.0.0（2026-06-04）

1. 新增 App 端微信授权登录。
2. 新增微信网页分享到好友、朋友圈、收藏。
3. 支持 Android、iOS、HarmonyOS 三端。
4. iOS 配置改为插件 Info.plist 统一管理。

平台兼容性

uni-app x(4.81)

其他

auth

uni-app x App 端微信授权登录与网页分享 UTS 插件。

能力

• Android 微信授权登录
• Android 微信网页分享
• iOS 微信授权登录
• iOS 微信网页分享
• HarmonyOS 微信授权登录
• HarmonyOS 微信网页分享

特性

• 页面直接传入微信 AppID
• iOS 配置放在插件 Info.plist
• Android 回调入口按宿主 applicationId 自动生成
• 支持授权登录、网页分享、安装检测
• 回调结果统一返回对象，便于页面处理

安装

将 uni_modules/auth 拷贝到项目的 uni_modules 目录下即可使用。

运行要求

本插件必须使用自定义基座运行，不能直接用普通 HBuilderX 运行包测试微信能力。

页面调用

import { ***Auth } from '@/uni_modules/auth'

微信授权登录

***Auth.login({
  appId: 'wx0000000000000000',
  scope: 'snsapi_userinfo',
  state: 'auth_login'
}, (res) => {
  console.log(res.errCode, res.errMsg, res.code)
})

检测微信是否安装

const installed = ***Auth.isInstalled('wx0000000000000000')

微信网页分享

***Auth.shareWebpage({
  appId: 'wx0000000000000000',
  href: 'https://example.com/',
  title: '网页标题',
  summary: '网页摘要',
  scene: 'WXSceneSession'
}, (res) => {
  console.log(res.errCode, res.errMsg)
})

返回结果

授权登录

***Auth.login 回调返回：

• errCode
• errMsg
• code
• state
• lang
• country

网页分享

***Auth.shareWebpage 回调返回：

• errCode
• errMsg

Android 配置

插件会自动按宿主 App 的 applicationId 暴露微信回调入口：

${applicationId}.wxapi.WXEntryActivity

微信开放平台 Android 配置中的包名、签名，必须与实际发布包一致。

iOS 配置

插件 iOS 端按微信 OpenSDK 方式接入。

请在 utssdk/app-ios/info.plist 中配置微信相关信息：

• ***.appid
• ***.universalLink
• CFBundleURLTypes 里的 CFBundleURLSchemes

如果你的宿主工程没有正确接入微信 OpenSDK，login 会返回 微信SDK未集成，isInstalled 会返回 false。

HarmonyOS 配置

HarmonyOS 需要在宿主工程的 module.json5 中声明微信 Scheme 查询权限：

{
  "module": {
    "querySchemes": [
      "weixin"
    ]
  }
}

如果使用 HBuilderX，可在项目根目录创建或维护 harmony-configs/entry/src/main/module.json5，并加入上面的 querySchemes。

参数说明

***Auth.login

• appId：微信开放平台 AppID
• scope：授权范围，默认 snsapi_userinfo
• state：登录状态标识，默认 auth_***_login

***Auth.shareWebpage

• appId：微信开放平台 AppID
• href：网页链接
• title：分享标题
• summary：分享摘要
• scene：分享场景
  • WXSceneSession：好友
  • WXSceneTimeline：朋友圈
  • WXSceneFavorite：收藏

注意事项

• AppSecret 不能放在客户端，必须放在服务端
• iOS 的 AppID、Universal Link、URL Scheme 必须与微信开放平台配置一致
• Android 的签名必须与微信开放平台登记签名一致
• 必须使用自定义基座运行，否则微信 OpenSDK 相关能力可能无法正常拉起或回跳
• 如果 isInstalled 返回 false，通常是微信未安装、AppID 不匹配、或原生配置未正确接入

示例

import { ***Auth } from '@/uni_modules/auth'

function login***() {
  ***Auth.login({
    appId: 'wx0000000000000000',
    scope: 'snsapi_userinfo',
    state: 'auth_demo'
  }, (res) => {
    console.log('login result', res)
  })
}