微信 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
@@ -11,9 +11,7 @@
import Foundation
import UIKit
#if canImport(WechatOpenSDK)
import WechatOpenSDK
#endif
// 微信 SDK 1.8.2(与 daoqi msext 同款)通过 Bridging Header 导入,无需 import 语句
@MainActor
public final class WeChatManager: NSObject {
@@ -41,10 +39,9 @@ public final class WeChatManager: NSObject {
/// openURL 路径解耦,授权回包独立由 SDK 直接派给 delegate)
/// 旧版 1.x 的 `WXApi.send(req)` 已 deprecated,不传 vc/delegate 会导致 H5 调了无反应。
public func authorize() async throws -> WXAuthCodePayload {
#if canImport(WechatOpenSDK)
print("[WeChat] authorize() 开始")
print("[WeChat] - WXApi.isWXAppInstalled = \(WXApi.isWXAppInstalled())")
print("[WeChat] - WXApi.getVersion = \(WXApi.getVersion() ?? "nil")")
print("[WeChat] - WXApi.getApiVersion = \(WXApi.getApiVersion() ?? "nil")")
let state = UUID().uuidString
return try await withCheckedThrowingContinuation { cont in
authPending[state] = cont
@@ -59,23 +56,16 @@ public final class WeChatManager: NSObject {
return
}
print("[WeChat] 调 sendAuthReq vc=\(type(of: vc)) scope=\(Self.authScope) state=\(state)")
WXApi.sendAuthReq(req, viewController: vc, delegate: self) { [weak self] success in
print("[WeChat] sendAuthReq completion success=\(success)")
// success = SDK 是否成功拉起微信 app;失败立刻 fail(如微信未安装、
// URL Scheme 未配置等)。成功后真实回包由 onResp 路径处理。
guard !success else { return }
Task { @MainActor in
guard let self else { return }
if let pending = self.authPending.removeValue(forKey: state) {
pending.resume(throwing: WeChatError.authFailed(-3))
}
// 1.x 的 sendAuthReq 返回 BOOL(同步知道是否成功拉起),无 completion
let success = WXApi.sendAuthReq(req, viewController: vc, delegate: self)
print("[WeChat] sendAuthReq 返回 success=\(success)")
if !success {
if let pending = authPending.removeValue(forKey: state) {
pending.resume(throwing: WeChatError.authFailed(-3))
}
}
// success=true 时等 WXApiDelegate.onResp 触发(SceneDelegate openURL 链路)
}
#else
print("[WeChat] ⚠️ canImport(WechatOpenSDK)=false")
throw WeChatError.sdkNotLinked
#endif
}
/// 取当前最顶层 ViewController(含 presented / nav.visible),供微信 SDK 作为
@@ -133,7 +123,6 @@ public final class WeChatManager: NSObject {
/// 链接分享(FIFO 串行)。微信回包不携带配对 ID,连续调时按入队顺序消费。
public func shareLink(_ link: ShareLink, scene: ShareScene) async throws {
#if canImport(WechatOpenSDK)
try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in
sharePending.append(cont)
@@ -152,22 +141,15 @@ public final class WeChatManager: NSObject {
case .session: req.scene = Int32(WXSceneSession.rawValue)
case .timeline: req.scene = Int32(WXSceneTimeline.rawValue)
}
// 分享回包路径:用户在微信操作后由 SceneDelegate.openURLContexts →
// WXApi.handleOpen(url:delegate:WeChatManager.shared) → onResp 到达,
// 故 sendReq 这里不需要再传 delegate;completion=nil 让拉起失败时
// 不打扰 sharePending 队列(队列由 onResp 的 FIFO 消费)。
// 新版 SDK 2.x `sendReq:completion:` 替代旧 `send:`(后者 deprecated)。
WXApi.send(req, completion: nil)
// 1.x: sendReq BOOL 返回;分享回包通过 SceneDelegate.openURLContexts →
// WXApi.handleOpen(url:delegate:WeChatManager.shared) → onResp 路径到达。
WXApi.sendReq(req)
}
#else
throw WeChatError.sdkNotLinked
#endif
}
/// 图片分享(FIFO 串行,复用 sharePending)。msext gameController.m:637-678
/// type=2 截图 / type=其它 远端图 共用同一条 WXImageObject + setThumbImage 路径。
public func shareImage(_ img: ShareImage, scene: ShareScene) async throws {
#if canImport(WechatOpenSDK)
try await withCheckedThrowingContinuation { (cont: CheckedContinuation<Void, Error>) in
sharePending.append(cont)
@@ -186,16 +168,8 @@ public final class WeChatManager: NSObject {
case .session: req.scene = Int32(WXSceneSession.rawValue)
case .timeline: req.scene = Int32(WXSceneTimeline.rawValue)
}
// 分享回包路径:用户在微信操作后由 SceneDelegate.openURLContexts →
// WXApi.handleOpen(url:delegate:WeChatManager.shared) → onResp 到达,
// 故 sendReq 这里不需要再传 delegate;completion=nil 让拉起失败时
// 不打扰 sharePending 队列(队列由 onResp 的 FIFO 消费)。
// 新版 SDK 2.x `sendReq:completion:` 替代旧 `send:`(后者 deprecated)。
WXApi.send(req, completion: nil)
WXApi.sendReq(req)
}
#else
throw WeChatError.sdkNotLinked
#endif
}
// MARK: - Internal: resolve callbacks
@@ -222,7 +196,6 @@ public final class WeChatManager: NSObject {
// MARK: - WXApiDelegate
#if canImport(WechatOpenSDK)
extension WeChatManager: WXApiDelegate {
public nonisolated func onReq(_ req: BaseReq) {
@@ -245,9 +218,8 @@ extension WeChatManager: WXApiDelegate {
}
}
}
#endif
// MARK: - Public payload / error types(无 SDK 依赖,可在 canImport 之外使用)
// MARK: - Public payload / error types
public struct WXAuthCodePayload: Sendable {
public let code: String
+9 -21
View File
@@ -2,18 +2,15 @@
// WeChatSDK.swift
// ylgamehall
//
// 微信 OpenSDK 启动注册。沿用 msext AppID(参 docs/SDK-Integration-Guide.md §0 凭证总表)。
// 微信 OpenSDK 1.8.2 启动注册(与 daoqi msext 同款,避免 2.x 强制
// Universal Link 的运维负担:HTTPS 域名 + AASA + 微信开放平台后台审核)。
//
// ⚠️ canImport(WechatOpenSDK) 守卫:在 Vendor/WechatSDK/WechatOpenSDK.xcframework
// 尚未在 Xcode 中 "Frameworks, Libraries, and Embedded Content" 里 Embed & Sign 之前,
// 本文件编译为 no-op,不影响主工程编译。Embed 后自动激活真实路径。
// 通过 Bridging Header 导入 ObjC 头(1.x .a 静态库无 Swift module),
// 详见 ylgamehall-Bridging-Header.h。
//
import Foundation
#if canImport(WechatOpenSDK)
import WechatOpenSDK
#endif
import UIKit
@MainActor
public enum WeChatSDK {
@@ -22,22 +19,13 @@ public enum WeChatSDK {
public static let appID = "wx586a9b321e56efb7"
/// 启动注册:在 AppDelegate.didFinishLaunchingWithOptions 调用一次。
/// universalLink 沿用 msext 路径不走 ULAPI,传空字符串即可(与 msext 行为等价)。
/// 1.x 单参数 registerApp,不需要 Universal Link。
public static func register() {
#if canImport(WechatOpenSDK)
// 不走 Universal Links(msext 同款路径,企业签 / 超签分发场景 ULAPI 无意义)
WXApi.registerApp(appID, universalLink: "")
#else
// SDK 未链接:no-op。Xcode 加完 framework 后这条分支会被替换为上面 WXApi 调用。
#endif
WXApi.registerApp(appID)
}
/// SceneDelegate.openURLContexts 转发入口(QQ → WXApi 顺序,QQ 必须先判 — msext 硬约束)
/// SceneDelegate.openURLContexts 转发入口。
public static func handleOpenURL(_ url: URL) -> Bool {
#if canImport(WechatOpenSDK)
return WXApi.handleOpen(url, delegate: WeChatManager.shared)
#else
return false
#endif
WXApi.handleOpen(url, delegate: WeChatManager.shared)
}
}