joywayerandClaude Opus 4.7
1d7e258130
选型（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>
AMap 高德定位 SDK
| 项 | 值 |
|---|---|
| AMapFoundationKit | 1.9.0+foundation.1b6fcf5 |
| AMapLocationKit | 2.12.0+loc.4f55976 |
| 来源 | 高德开放平台 iOS 定位 SDK 下载页 |
| 路径 | Vendor/AMap/AMapFoundationKit.framework / Vendor/AMap/AMapLocationKit.framework |
| 架构 | fat（x86_64 + arm64，单 .framework 同时支持设备 + 模拟器） |
| 模块名 | AMapFoundationKit / AMapLocationKit |
| 引入日期 | 2026-06-22 |
工程接入步骤（用户在 Xcode 手动）
⚠️ 高德官方发布的还是旧式 fat
.framework（不是.xcframework）。Xcode 26+ 接受 fat.framework，但若构建报「Could not find module ... for 'arm64-apple-ios-simulator'」可能要先用xcodebuild -create-xcframework转封。先按下面流程跑，遇到问题再处理。
- Project Navigator → 选中 ylgamehall target → General → Frameworks, Libraries, and Embedded Content
- 点
+→ Add Other → Add Files → 把Vendor/AMap/AMapFoundationKit.framework和AMapLocationKit.framework一起加入 - 两个都设为 Do Not Embed（高德 fat
.framework是静态库，不能 Embed；Embed 会触发链接器对__OBJC段重复符号错误） - Build Settings → Framework Search Paths 自动会被 Xcode 写入
$(PROJECT_DIR)/Vendor/AMap - Clean Build Folder 后 BuildProject
接入完毕后，源码内 #if canImport(AMapLocationKit) 守卫将激活真实路径。
凭证
参 docs/SDK-Integration-Guide.md §0 凭证总表。APIKey 沿用 msext（b0d4a8e3fcbbcc0dd96283b7df6a4494，与 Bundle ID com.skyapp.ylgamehall 绑死）。
Info.plist 必需
NSLocationWhenInUseUsageDescription：定位权限文案（已由工程接入时统一添加，见 SDK-Integration-Guide §2.2）