微信 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
+45 -19
View File
@@ -1,36 +1,62 @@
# WechatOpenSDK
# WechatOpenSDK 1.8.2(与 daoqi msext 同款)
> 闭源 SDK,按 daoqi `CLAUDE.md` ADR-006 走 **Vendor `.xcframework`** 路径。
> **决策原因**:微信 OpenSDK 2.0.x 强制 Universal Link,需要项目方配合:
> HTTPS 域名 + AASA 部署 + Xcode Associated Domains entitlement + 微信
> 开放平台后台审核(30min1d)。daoqi msext 多年使用 1.8.2 上线稳定,
> ylgamehall 沿用同款避免无谓运维负担。1.x 不强制 UL,URL Scheme 即可。
>
> 历史选型对比:曾考虑 Tencent 官方 SPM`https://github.com/Tencent/WechatOpenSDK-XCFramework`),但该仓库**不存在**404);社区 wrapper`yanyin1986/WechatOpenSDK`、`anotheren/WechatOpenSDK`)存在但非 Tencent 官方维护,仓库一旦停更/删除即为定时炸弹,被否决。
> 历史记录:曾尝试 SDK 2.0.5 + 空 universalLink,结果 `sendAuthReq`
> 直接 `success=false`SDK 拒绝),无法授权。改回 1.8.2 后行为与 msext 等价。
## 二进制来源
| 项 | 值 |
|---|---|
| 官方下载页 | <https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=215840645315192a89cc59f0f9b4a1ccff0fed81&lang=zh_CN> |
| 推荐版本 | OpenSDK **2.0.5** 或更新(避免 1.x 的 ITMS-90809 历史包袱;新外壳不上 App Store 仍建议用 2.x,与 msext 行为差异最小) |
| 形态 | `OpenSDK*_NoPay.zip`(不含支付能力,符合本项目需求 |
| 解压产物 | `WechatOpenSDK.xcframework`(含 ios-arm64 + ios-arm64_x86_64-simulator slice |
| 模块名 | `WechatOpenSDK``import WechatOpenSDK` / `#import <WechatOpenSDK/WXApi.h>` |
| 来源 | 直接从 daoqi/msext/Class/SDKExport/ 拷贝(与现网 msext 同版本) |
| 版本 | 1.8.2 |
| 形态 | fat 静态库 `.a` + 头文件(无 Swift module,需 Bridging Header |
| 架构 | i386 + armv7 + armv7s + x86_64 + arm64**不含 ios-arm64-simulator** |
## 放置路径
## 文件结构
```
ylgamehall/
├── Vendor/
│ └── WechatSDK/
├── README.md ← 本文件
│ └── WechatOpenSDK.xcframework/ ← 用户从官方下载后放这里
Vendor/WechatSDK/
├── README.md ← 本文件
└── v1.8.2/
├── README.txt ← Tencent 官方版本历史
├── WXApi.h ← 主 APIregisterApp/sendAuthReq/sendReq/handleOpenURL
├── WXApiObject.h ← 数据对象(SendAuthReq/SendMessageToWXReq/WXMediaMessage 等)
├── WechatAuthSDK.h ← 扫码授权扩展(项目未用)
└── libWeChatSDK.a ← fat 静态库
```
## Xcode 接入
## Xcode 接入步骤(用户在 Xcode 手动)
`docs/SDK-Integration-Guide.md §A.1`。要点:
1. **删除当前 xcframework 引用**Project Navigator → 选中 ylgamehall target → General →
Frameworks, Libraries, and Embedded Content → 选中 `WechatOpenSDK-NoPay.xcframework`
`-` 删除(文件本身已在上次 commit 从 git 移除)
2. **加 `.a` 静态库**:同位置点 `+` → Add Other → Add Files → 选
`Vendor/WechatSDK/v1.8.2/libWeChatSDK.a`**Do Not Embed**(静态库不能 embed
3. **加 4 个微信 1.x 依赖的系统库**(同位置点 `+` 搜索):
- **libz.tbd**
- **libsqlite3.tbd**(旧的 `libsqlite3.0.tbd` 也可)
- **Security.framework**
- **CFNetwork.framework**
全部 Do Not Embed
4. **配置 Build Settings**
- **Header Search Paths**:加 `$(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2`recursive 不必要)
- **Objective-C Bridging Header**:设为 `ylgamehall/ylgamehall-Bridging-Header.h`
5. **确认 Info.plist 已配**(之前 SDK 2.0.5 时已加,沿用即可):
- `CFBundleURLTypes``wx586a9b321e56efb7`
- `LSApplicationQueriesSchemes``weixin` / `weixinULAPI` / `weixinURLParamsAPI`
6. Clean Build Folder + ⌘B
- Target → General → Frameworks, Libraries, and Embedded Content → `+` → Add Files → 选 `Vendor/WechatSDK/WechatOpenSDK.xcframework`
- **Embed 选 `Embed & Sign`**xcframework 是动态库,与 AMap 静态 `.framework``Do Not Embed` 不同)
## 已知限制:M Mac 模拟器无法链接
fat 库不含 `ios-arm64-simulator` slice,M 芯片 Mac 模拟器链接会报与 AMap 相同的
arch 冲突错。**接受现状,开发期跑真机**(与 AMap 同款决策,详见
`Vendor/AMap/README.md` 「已知限制」)。
## 凭证
AppID + AppSecret + AuthScope + AuthState 沿用 msext,参 `docs/SDK-Integration-Guide.md §0`
AppID + AppSecret + AuthScope 沿用 msext,参 `docs/SDK-Integration-Guide.md §0`