 joywayerandClaude Opus 4.7
|
1d7e258130
|
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>
|
2026-06-22 22:22:23 +08:00 |
|
|
joywayerandClaude Opus 4.7
|
a2baf742b6
|
docs：新增 SDK-Integration-Guide.md（微信 / 高德定位 / opencore-amr / 七牛）
按 CLAUDE.md ADR-006「禁 CocoaPods，SPM 优先 + Vendor xcframework」组织，
每个 SDK 章节给出：凭证清单 / 工程接入 / 代码触点 / BackGameData 清理钩子 / 验收 /
风险，便于项目方发凭证后开发者按表落地。
关键约束（写入指南）：
- 微信：不复用 msext AppID；AppSecret 客户端泄露风险，fallback 路径上线前必须切后台
- 高德：APIKey 与 Bundle ID 绑死，必须重新申请（msext 的 key 不可用）；
iOS 14+ 隐私合规三步（updatePrivacyShow → updatePrivacyAgree → apiKey）
- opencore-amr：复用 msext 已 segalign 8 修复版 .a，免重编源码；MRC wrapper 加
-fno-objc-arc 文件级标志
- 七牛：SPM 拉官方 objc-sdk v8.9.x；token 缓存 + 失效前 30s 预刷新
- 每个 SDK 都标明在 BackGameDataHandler 必须加的清理钩子（WXApi.delegate=nil /
LocationService.stop / AudioRecorder.cancel / QiniuUploader.cancelInFlight）
CLAUDE.md 文档索引追加一行指向新文件。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
2026-06-22 21:36:51 +08:00 |
|