微信 SDK 降级 2.0.5 → 1.8.2(与 daoqi msext 同款,避开 UL 强制)

H5 调 accreditlogin 后 sendAuthReq success=false,根因:微信 OpenSDK
2.0.x 强制 Universal Link,传空串被 SDK 拒绝;daoqi msext 用 1.8.x 不强制
UL,多年稳定上线。沿用 1.8.2 避免无谓的 UL 运维负担(HTTPS 域名 + AASA +
微信开放平台审核 30min-1d)。

文件改动:
- 新增 Vendor/WechatSDK/v1.8.2/{WXApi,WXApiObject,WechatAuthSDK}.h +
  libWeChatSDK.a(16MB,fat: i386+armv7+armv7s+x86_64+arm64,从 daoqi
  msext/Class/SDKExport/ 直接拷贝)
- 删除 Vendor/WechatSDK/WechatOpenSDK-NoPay.xcframework(2.0.5)
- 新增 ylgamehall/ylgamehall-Bridging-Header.h(1.x .a 无 Swift module,
  必须通过 Bridging Header 导入 WXApi.h / WXApiObject.h)

代码侧(5 个 Swift 文件):
- WeChatSDK.swift:register() 改为 1.x 单参数 WXApi.registerApp(appID),
  去掉 universalLink 参数;handleOpenURL 不变(1.x/2.x 同款)
- WeChatManager.swift:去掉 #if canImport(WechatOpenSDK) 守卫(Bridging
  Header 直接导入,符号编译期必在);authorize sendAuthReq 改 1.x BOOL
  返回(无 completion);shareLink/shareImage 改 WXApi.sendReq(req)
  (1.x BOOL 返回,无 completion);getVersion → getApiVersion
- AccreditLoginHandler / WechatShare:同样去掉 canImport 守卫和 stub 分支
- BackGameDataHandler:更新注释说明 1.x WXApi delegate 由 sendAuthReq
  逐次传入,WeChatManager singleton 持有不需要清理(1.x 早期 setDelegate:
  API 已废弃)

文档:
- Vendor/WechatSDK/README.md 重写,说明 1.8.2 决策原因 + 文件结构 +
  Xcode 接入 5 步 + M Mac simulator 已知限制
- docs/SDK-Integration-Guide.md §A.1 同步重写

⚠️ **本 commit 后 BuildProject 会失败**,需要用户在 Xcode UI 完成 5 步:
1. 删 Frameworks 里旧 WechatOpenSDK-NoPay.xcframework 引用
2. Add Vendor/WechatSDK/v1.8.2/libWeChatSDK.a(Do Not Embed)
3. Add 4 个系统库:libz.tbd / libsqlite3.tbd / Security.framework /
   CFNetwork.framework(Do Not Embed)
4. Build Settings → Header Search Paths += $(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2
5. Build Settings → Objective-C Bridging Header = ylgamehall/ylgamehall-Bridging-Header.h

详细操作步骤见 Vendor/WechatSDK/README.md「Xcode 接入步骤」。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
joywayer
2026-06-23 08:27:40 +08:00
co-authored by Claude Opus 4.7
parent a060f29070
commit 05f1396645
26 changed files with 1076 additions and 3530 deletions
+15 -9
View File
@@ -18,17 +18,23 @@
>
> 这 3 件事都是 Xcode UI 操作,无法 AI 自动完成。完成后 `BuildProject` 即激活所有真实路径。
### A.1 添加微信 OpenSDKVendor 手动)
### A.1 添加微信 OpenSDK 1.8.2Vendor 手动,与 daoqi msext 同款
> Tencent 官方至今未维护 SPM 仓库(`Tencent/WechatOpenSDK-XCFramework` 不存在,404);社区 wrapperyanyin1986 / anotheren)非官方,被否决。改走 Vendor `.xcframework`,与 AMap 同款处置方式
> **改用 1.8.2 的原因**2.0.x 强制 Universal LinkHTTPS 域名 + AASA + 微信开放平台后台审核),运维负担大;daoqi msext 多年 1.8.2 上线稳定,沿用避免无谓改造。详见 `Vendor/WechatSDK/README.md`
>
> SDK 已入库 `Vendor/WechatSDK/v1.8.2/`4 个文件 + README,从 daoqi 同步),无需额外下载。
**预先准备**:从腾讯开放平台下载 `OpenSDK*_NoPay.zip`(推荐 2.0.5+),解压取出 `WechatOpenSDK.xcframework`,放到 `Vendor/WechatSDK/`。下载页与详细说明见 `Vendor/WechatSDK/README.md`
1. 选中 `ylgamehall` Target → General → Frameworks, Libraries, and Embedded Content
2.`+` → Add Other → Add Files
3.`Vendor/WechatSDK/WechatOpenSDK.xcframework`
4. **Embed** 列选 **Embed & Sign**xcframework 是动态库,与下面 AMap 的 `Do Not Embed` 不同,别错)
5. ⌘B 编译
1. **删除(如有)2.0.5 xcframework**Target → General → Frameworks → 选 `WechatOpenSDK-NoPay.xcframework``-` 删除(文件已从 git 移除)
2. **加 libWeChatSDK.a**:点 `+` → Add Other → Add Files → 选 `Vendor/WechatSDK/v1.8.2/libWeChatSDK.a`**Do Not Embed**(静态库不能 embed
3. **加 4 个 1.x 依赖系统库**:同位置 `+` 搜索后逐个加(均 Do Not Embed):
- `libz.tbd`
- `libsqlite3.tbd`
- `Security.framework`
- `CFNetwork.framework`
4. **配置 Build Settings**
- Header Search Paths += `$(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2`
- Objective-C Bridging Header = `ylgamehall/ylgamehall-Bridging-Header.h`
5. ⌘B 编译 — **target 必须选真机**或 Generic iOS Devicefat 库不含 ios-arm64-simulatorM Mac 模拟器链接会失败(与 AMap 同款已接受现状)
### A.2 添加高德定位 framework × 2Vendor 手动,无 SPM 替代)