Phase 4.E + Phase 5 + Phase 3.C 七牛上传:代码侧 SDK 接入(SPM 优先 / Vendor 兜底)
选型(CLAUDE.md ADR-006「SPM 优先 + Vendor xcframework 兜底」): - 微信 → SPM(Tencent 官方 https://github.com/Tencent/WechatOpenSDK-XCFramework); 项目方下载的 WechatOpenSDK-NoPay.xcframework 已撤出 Vendor,docs/res 内副本作离线备份 - 高德 → Vendor 手动(官方未提供 SPM;Vendor/AMap/{AMapFoundationKit,AMapLocationKit}.framework 随仓库分发,fat .framework 同时含 x86_64 + arm64,Do Not Embed) - 七牛 → SPM(https://github.com/qiniu/objc-sdk v8.9.x) 代码侧(全部 #if canImport 守卫,Xcode 加 SDK 前编译为 no-op): - Source/SDK/WeChat/WeChatSDK.swift:WXApi.registerApp + handleOpenURL(沿用 msext AppID wx586a9b321e56efb7,universalLink 空字符串走非 ULAPI 路径) - Source/SDK/WeChat/WeChatManager.swift:WXApiDelegate + state UUID 配对的 authorize + FIFO 串行 share async/await wrapper - Source/Login/WeChatAuth.swift:客户端直拼 sns/oauth2/access_token + sns/userinfo → 7 字段(Province 大写 P / city 经 danbian 去单引号),沿用 msext 同款路径 - Source/SDK/AMap/AMapWrapper.swift:iOS 14+ 隐私合规 3 步 + apiKey 注入 - Source/Location/LocationService.swift:actor + AMapLocationManager 异步包装 + 9 字段 - Source/Network/QiniuConfig.swift:4 项常量沿用 msext(AccessKey/SecretKey/Bucket/Domain) - Source/Network/QiniuTokenSigner.swift:纯 Swift CryptoKit HMAC-SHA1 + Base64URL 自签 token(与 msext QiniuManager.m:200-230 等价,不依赖 Qiniu SDK 工作) - Source/Network/QiniuUploader.swift:actor 包 QNUploadManager async/await Handler 升级: - AccreditLoginHandler:拉起授权 → 反向 callback sharelogin 7 字段 - WechatShare:真实链接分享(type=2/3 截图待 Phase 4.F) - StartLocationHandler:真实定位 → 9 字段(latitude/longitude string, province 小写 p) 生命周期: - AppDelegate.didFinishLaunchingWithOptions:WeChatSDK.register + AMapWrapper.bootstrap - SceneDelegate.openURLContexts:WeChatSDK.handleOpenURL 接入回调 - BackGameDataHandler:子游戏 backgameData pop 时 WXApi.delegate=nil + LocationService.stop() Info.plist:CFBundleURLTypes 加 wx586a9b321e56efb7;LSApplicationQueriesSchemes 追加 weixin/weixinULAPI/weixinURLParamsAPI;NSLocationWhenInUseUsageDescription + NSMicrophoneUsageDescription(gamehallname 中文文案)。 .gitignore:排除 docs/res/{AMap_iOS_Loc_ALL,objc-sdk-8.9.2}/(235MB 项目方下载副本, 已走 SPM/Vendor 接入不需要副本)。 文档:docs/SDK-Integration-Guide.md 重写 §A 用户手动 Xcode UI 三步(SPM × 2 + Add Files × 2);Vendor/{AMap,WechatSDK}/README.md 记录各自接入路径选型。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.7
parent
a2baf742b6
commit
1d7e258130
@@ -17,29 +17,24 @@
|
||||
// msext 同款行为 — 这是契约边界,不在原生侧兜底。
|
||||
//
|
||||
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
// ⚠️ 接入新 SDK 时必须回到此处补对应清理钩子(msext 在 backgameData / cleanUpAction
|
||||
// 里逐项清理;我们当前是 stub,所以暂无需要清的状态。一旦真实接入下列任一 SDK,
|
||||
// 在 MainActor.run 块里加对应清理一行):
|
||||
// SDK 清理钩子状态(每接入新 SDK 都必须确认或新增):
|
||||
//
|
||||
// - Phase 4.E 微信 SDK:`WXApi.delegate = nil`
|
||||
// (msext gameController.m:699;防止 pop 后微信回调指向已销毁的 SubGameVC)
|
||||
//
|
||||
// - Phase 5 高德定位:`LocationService.shared.stop()` + delegate nil
|
||||
// (msext gameController.m:2473-2478 cleanUpAction;防止后台定位继续耗电 +
|
||||
// 回调指向悬空对象)
|
||||
//
|
||||
// - Phase 3.B/C/D 录音 / 七牛上传:`Recorder.shared.cancel()` +
|
||||
// `Uploader.shared.cancelInFlight()`
|
||||
// (msext 通过 ChatVoiceRecorderVC 生命周期间接清理;我们的实现不会跟 VC 绑死,
|
||||
// 必须显式 cancel 否则上传任务在 pop 后继续写网络)
|
||||
//
|
||||
// - Phase 8 Agora(若未来重启视频):`agoraKit.leaveChannel(...)`
|
||||
// (目前 VideoRoomHandlers 是 stub 无需清理)
|
||||
// ✅ Phase 4.E 微信:`WXApi.delegate = nil`(已加,canImport 守卫,Xcode Embed 后激活)
|
||||
// ✅ Phase 5 高德定位:`LocationService.shared.stop()`(已加,canImport 守卫,
|
||||
// Xcode Embed AMapLocationKit 后激活)
|
||||
// ⏳ Phase 3.B/C/D 录音 / 七牛上传:`AudioRecorder.shared.cancel()` 待 opencore-amr
|
||||
// 接入后取消注释;`QiniuUploader.cancelInFlight()` 依赖 Task.cancel 传播无需显式调
|
||||
// ⏳ Phase 8 Agora(若未来重启视频):`agoraKit.leaveChannel(...)`
|
||||
// (目前 VideoRoomHandlers 是 stub 无需清理)
|
||||
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
//
|
||||
|
||||
import Foundation
|
||||
|
||||
#if canImport(WechatOpenSDK)
|
||||
import WechatOpenSDK
|
||||
#endif
|
||||
|
||||
public enum BackGameDataHandler {
|
||||
|
||||
public static func register(on bridge: any BridgeProtocol) {
|
||||
@@ -52,7 +47,25 @@ public enum BackGameDataHandler {
|
||||
// - 直接是 .string → 取字面
|
||||
// - 其它类型 → JSON 序列化(保留对象结构传给大厅 H5)
|
||||
let payload = serialize(data)
|
||||
|
||||
// 子游戏 push 期间挂载的 SDK 资源在 pop 前显式清理(避免 delegate 悬挂 /
|
||||
// 后台任务残留),与 msext gameController.m:691-709 + cleanUpAction 等价。
|
||||
AudioPlayer.shared.stopAllBackground()
|
||||
|
||||
#if canImport(WechatOpenSDK)
|
||||
// msext gameController.m:699 等价:清 WXApi delegate 防止子游戏回调指向已销毁 VC
|
||||
WXApi.delegate = nil
|
||||
#endif
|
||||
|
||||
#if canImport(AMapLocationKit)
|
||||
// msext gameController.m:2473-2478 cleanUpAction 等价
|
||||
LocationService.shared.stop()
|
||||
#endif
|
||||
|
||||
// Phase 3.C 录音 / Phase 3.B 七牛上传 清理(QiniuUploader.cancelInFlight 当前
|
||||
// 依赖 Task.cancel 传播;AudioRecorder 待 opencore-amr 接入后激活清理)
|
||||
// AudioRecorder.shared.cancel() // ← Phase 3.C 接入时取消注释
|
||||
|
||||
AppCoordinator.shared.popSubGame(returningData: payload)
|
||||
}
|
||||
callback?(.string("backgameData"))
|
||||
|
||||
Reference in New Issue
Block a user