Appearance
功能说明
在基于 view/uniapp 打包发布原生 App(iOS / Android)时,若需支持“微信一键登录”及“微信分享/微信支付”,必须在微信开放平台创建移动应用并配置 App 权限。
详细配置步骤
在微信开放平台创建“移动应用”
- 登录 微信开放平台 -> 【管理中心】 -> 【移动应用】 -> 点击【创建移动应用】。
- 填写应用名称、简介与图标,提交审核。
- Android 平台配置:
- 填写 Android 应用包名(如
com.ebaozu.app)。 - 填写应用签名(通过签名生成工具获取 APK 签名的 32 位 MD5 指纹)。
- 填写 Android 应用包名(如
- iOS 平台配置:
- 填写 Bundle ID(如
com.ebaozu.ios)。 - 填写 iOS 通用链接(Universal Links,必须支持 HTTPS 且配置了
apple-app-site-association文件)。
- 填写 Bundle ID(如
- 审核通过后,获得该移动应用的 AppID 与 AppSecret。
在 Uni-app 打包配置中填入凭证
打开移动端前端工程 view/uniapp/manifest.json:
- 切换到【App SDK 配置】。
- 找到【登录鉴权】 -> 勾选【微信登录】。
- 填入在微信开放平台申请的 AppID 和 AppSecret(以及 iOS Universal Links)。
- 若支持微信支付,在【App 支付配置】中同步填入微信支付 AppID。
常见失败原因与排查
- Android 提示签名不一致 / 登录无响应(错误码 -1):
- 检查打包使用的 keystore 证书指纹是否与开放平台填写的签名完全一致;若为测试环境使用 DCloud 公共证书,需先更换为自定义私有证书打包。
- iOS 微信登录无法返回 App:
- 检查 Universal Links 通用链接配置是否有效,确保能在 Safari 浏览器中通过该链接正常呼起 App。