From a6095ef4c877cb86563ff9715c61c36f9ae4c772 Mon Sep 17 00:00:00 2001 From: joywayer Date: Mon, 22 Jun 2026 19:45:12 +0800 Subject: [PATCH] =?UTF-8?q?Phase=204=20=E6=96=B9=E5=90=91=E6=9C=80?= =?UTF-8?q?=E7=BB=88=E5=86=B3=E7=AD=96=20A=EF=BC=9AQQ=20=E4=B8=8D=E5=9C=A8?= =?UTF-8?q?=20H5=20=E6=A1=A5=E8=8C=83=E5=9B=B4=EF=BC=8C=E4=B8=8D=E5=AE=9E?= =?UTF-8?q?=E6=96=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 深度 grep msext NewRootVC.m / gameController.m 未发现 QQShareManager 引用 — QQ 完全不接 H5 桥。Contract §3.1 ［2］ sharetype 取值仅 "1"/"2"= 微信 / "3"=闲聊，无 QQ 选项。 按 CLAUDE.md 原则 A（H5 端零修改不可妥协）：契约不变 → H5 桥不实现 QQ 分享。msext 里 QQShareManager 只服务于原生 SharePanel（独立功能）， 新外壳无原生 SharePanel-like 入口需求 → 也不需要 QQShareManager。 文档同步调整为"不实施"： - Plan §2.3 阻塞表：QQ OpenSDK 改写为详细理由（H5 桥契约无 QQ 选项 + msext QQShareManager 不接 H5 桥的 grep 证据） - Plan §5 Phase 4.2：从"QQ 改走 URL Scheme"改为"不实施"，但保留 URL Scheme 备用知识库（未来如需原生入口可参 msext fallback） - CLAUDE.md 依赖管理段："不接入 QQ SDK 也不实现 QQ 分享"，明示 原因（契约无 QQ + msext 行为） - Verification-Checklist L 章节：QQ 验证项删除（不实施无需验证） Phase 4 至此剩 4.B 微信 SDK 接入（项目方阻塞）+ 4.D 截图/远端图分享 （依赖 4.B）。当前 stub 已让 H5 调登录/分享不报 "no handler"， 等微信 SDK 到位后升级。 Plan §6.4 里程碑加一行决策记录。 Co-Authored-By: Claude Opus 4.7 --- CLAUDE.md | 2 +- docs/Development-Plan.md | 14 ++++++-------- docs/Verification-Checklist.md | 9 ++++----- 3 files changed, 11 insertions(+), 14 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 55709b5..b09590a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -128,7 +128,7 @@ daoqi 仓库当前并存两条工作线： - **首选 SPM**：开源 / 官方提供 Swift Package 的库（Sentry / ZIPFoundation / 七牛 `https://github.com/qiniu/objc-sdk` v8.9.x 等） - **Vendor `.xcframework` 手动**：所有闭源二进制（微信 / 高德 AMap / opencore-amr 等），按 Design §14.1「Vendor 接入标准流程」放 `Vendor//` + Target → General → Frameworks 加入 + `Vendor//README.md` 记录版本与来源 -- **不接入 QQ SDK**：QQ 分享走 URL Scheme 直接调起 QQ app（`mqqapi://share/to_fri?...` 等），参 msext `QQShareManager.m` line 14 `__has_include` 条件编译的 fallback 路径。不需要 SDK、不需要 AppID 注册、不需要 handleOpenURL 回调（URL Scheme 单向调起，调起即视为 success）。Info.plist 仅需加 `LSApplicationQueriesSchemes`（`mqq` / `mqqapi` / `mqqopensdkfriend` 等） +- **不接入 QQ SDK / 也不实现 QQ 分享**：Contract §3.1 ［2］`friendsShare.sharetype` 取值仅 "1"/"2"=微信 / "3"=闲聊，**无 QQ 选项**。msext 的 QQShareManager 只服务于原生 SharePanel（独立功能，不接 H5 桥）。新外壳契约不变 → H5 桥不实现 QQ 分享。如未来需 QQ 入口（原生 SharePanel-like），可走 URL Scheme 方案（`mqqapi://share/to_fri?...`，参 msext `QQShareManager.m:14` `__has_include` fallback）—— 但**不会触发 H5 桥 sharesuccess**，是独立于契约的另一条路径 - **禁止 CocoaPods**：项目内不放 `Podfile` / `Podfile.lock` / `Pods/` / `.xcworkspace`。工程入口固定为 `ylgamehall.xcodeproj` - **新增第三方依赖时**：按 SPM → Vendor 顺序尝试，PR 描述写明选型理由；若发现某 SDK 既无 SPM 又无 XCFramework，回到 ADR-006 决策框架重新评估 diff --git a/docs/Development-Plan.md b/docs/Development-Plan.md index 0e8e1ea..d7747ab 100644 --- a/docs/Development-Plan.md +++ b/docs/Development-Plan.md @@ -62,7 +62,7 @@ Contract Design Plan（本文档） | 11 个渠道注入目录的目录名值 | 渠道 / 游戏 ID / 七牛域名 / market 等 | Phase 1 | 项目方/运营 | | 微信 OpenSDK `.framework` | 登录 / 分享 | Phase 4 | 项目方（可从 msext/Vendor 拷贝） | | 微信 AppID（`wx586a9b321e56efb7`）+ Universal Links 配置 | 微信回调 | Phase 4 | 项目方 | -| ~~QQ OpenSDK `.framework` + AppID~~ | ~~QQ 分享~~ | **不需要** — 改用 `mqqapi://` / `mqq://` URL Scheme 直接调起 QQ app（参 msext `QQShareManager.m:14` `__has_include` fallback 路径），无需 SDK 无需 AppID 验证。仅需 Info.plist 加 `LSApplicationQueriesSchemes` (`mqq`/`mqqapi`/`mqqopensdkfriend` 等) | — | +| ~~QQ OpenSDK `.framework` + AppID~~ | ~~QQ 分享~~ | **不需要** — Contract §3.1 ［2］`friendsShare` 的 `sharetype` 取值仅 "1"/"2"=微信 / "3"=闲聊，**没有 QQ 选项**。msext 里 QQShareManager 只服务于原生 SharePanel（独立功能），不接 H5 桥。新外壳契约不变 → 不实现 QQ 分享。grep 验证：msext `NewRootVC.m` / `gameController.m` 全文未引用 QQShareManager | — | | 后台 `/wechat/login` 中转接口 | secret 不入 IPA 的前提 | Phase 4 | 后台团队 | | 高德地图 `APIKey` + SDK XCFramework | 定位 | Phase 5 | 已有 key `b0d4a8e3fcbbcc0dd96283b7df6a4494`（但绑死 msext Bundle ID，需用新 Bundle ID 重新申请）；SDK 走 Vendor 手动接入（ADR-006），下载页 https://lbs.amap.com/api/ios-location-sdk/download | | 七牛上传 token 颁发接口 | 录音上传 | Phase 3 | 后台团队 | @@ -477,12 +477,9 @@ Contract Design Plan（本文档） - [ ] **4.1** `Vendor/WechatSDK/` 拷贝微信 SDK - Info.plist 加 URL Scheme（`wx586a9b321e56efb7`）+ `LSApplicationQueriesSchemes`（`weixin` / `weixinULAPI` / `weixinURLParamsAPI`） - Entitlement 加 Associated Domains（Universal Links） -- [ ] **4.2** **QQ 分享走 URL Scheme，不依赖 SDK**（按项目方约定） - - 参 msext `QQShareManager.m:14`（`__has_include()`）+ `:225-280` URL Scheme fallback 实现 - - Info.plist 加 `LSApplicationQueriesSchemes`：`mqq` / `mqqapi` / `mqqopensdkfriend` / `mqqopensdkapiV2` / `mqqopensdkapiV3` / `mqqopensdkapiV4` / `mqqopensdkdataline` 等（具体见 msext Info.plist） - - URL 构造（链接分享）：`mqqapi://share/to_fri?` + URL 编码的 `title` / `description` / `url` / `thumbnailURL` / `version=1` / `src_type=app` 等参数 - - 不需要 AppID 注册、不需要 QQApi handleOpenURL 回调（URL Scheme 单向调起，无回调） - - `sharesuccess` 反向 callback 无法精确判断分享成功失败（URL Scheme 不返回状态）；msext 沿用"调起即视为 success"的乐观策略 +- ✗ ~~**4.2** QQ 分享~~ **不实施**（按 A 方向最终决策） + - **理由**：H5 桥契约 §3.1 ［2］`friendsShare.sharetype` 取值仅 "1"/"2"=微信 / "3"=闲聊，**无 QQ 选项**。msext 的 QQShareManager 只接原生 SharePanel（独立功能），不接 H5 桥。新外壳契约不变 → 不实现 QQ 分享 + - **保留路径**：未来项目方如确需 QQ 入口（如原生 SharePanel-like 触发），可参 msext `QQShareManager.m:14` `__has_include` fallback（URL Scheme `mqqapi://share/to_fri?` 直接调起），无需 SDK 无需 AppID。但**不会触发 H5 桥 `sharesuccess`**——这与契约无关，是另一条独立路径 - [ ] **4.3** `Source/SDK/WeChat/WeChatSDK.swift` 启动注册（Design §4.2 `registerFull` + 全部 12 个 `MMAPP_SUPPORT_*` flag） - [ ] **4.4** `Source/SDK/WeChat/WeChatManager.swift`（@MainActor） - 持久 delegate @@ -788,7 +785,8 @@ H5 调 `OpenurlTitleData` 打开弹层 WebView，弹层内 H5 用 `window.settin | 2026-06-22 | **Phase 2.C ExternalSubscriptions 生命周期管理**：setup/teardown 配对挂 viewWillAppear/viewWillDisappear，Phase 6 子游戏 push 时防双发 | `09f071e` | | 2026-06-22 | 新增 `docs/Verification-Checklist.md` 功能验证清单：累积各 Phase 验证步骤、不在 Phase 进行中频繁验证、完成后统一跑。与 Contract §10 契约边界保持独立 | `b2ee1b3` | | 2026-06-22 | Phase 3.A srcIsloop 本地音频 + 3.B/C/D RemoteAudio stub。AudioPlayer @MainActor 实现 playOnce/loopBackground/stopBackground 三方法与 msext 等价 | `0602b9d` | -| 2026-06-22 | **Phase 4.A 登录+分享 stub + QQ 改走 URL Scheme 不依 SDK**：AccreditLoginHandler + FriendsShareHandler stub；Plan §2.3 阻塞表去掉 QQ SDK；Plan §5 4.2 改为 URL Scheme 路径（参 msext QQShareManager.m fallback）；CLAUDE.md 依赖管理段补"不接入 QQ SDK"约定；Verification-Checklist 加 Phase 4 章节 | 本次 commit | +| 2026-06-22 | **Phase 4.A 登录+分享 stub + QQ 改走 URL Scheme 不依 SDK**：AccreditLoginHandler + FriendsShareHandler stub；Plan §2.3 阻塞表去掉 QQ SDK | `aa80aec` | +| 2026-06-22 | **Phase 4 方向最终决策（A）**：grep msext NewRootVC.m / gameController.m 未发现 QQShareManager 引用 — Contract §3.1 ［2］ `sharetype` 取值仅"1"/"2"=微信 / "3"=闲聊无 QQ；msext 的 QQShareManager 只接原生 SharePanel（独立功能不接 H5 桥）。新外壳契约不变 → 不实现 QQ 分享。Plan §2.3 + §5 4.2 + CLAUDE.md + Verification-Checklist 同步调整为"不实施"+ 保留 URL Scheme 备用知识库 | 本次 commit | > **§3.4.1 撤销说明**：早期 commit `82bad8a` 实现的 `window.settings.getXxx()` polyfill 已撤销 — Contract §附录 A 自身明示「iOS<9 路径，新外壳如最低系统 ≥ iOS 14 可不实现」，本项目最低 iOS 15.6 → polyfill 路径未启用，H5 用 §7.5 的 `app_*.js` 文件路径作为唯一主路径。详细缘由见 Design §3.4.1（撤销说明）和 CLAUDE.md「典型案例」段。 diff --git a/docs/Verification-Checklist.md b/docs/Verification-Checklist.md index 30dfe78..0402f37 100644 --- a/docs/Verification-Checklist.md +++ b/docs/Verification-Checklist.md @@ -185,12 +185,11 @@ H5 需先用 `bridge.registerHandler('callbackName', fn)` 注册： > - sharesuccess({success:"2", type:"1"/"2"}) > - app 切到后台微信授权 → 切回 app sharelogin 触发 -### L. QQ URL Scheme 分享（4.C 待实现，**不依赖 SDK**） +### L. ~~QQ URL Scheme 分享~~（不实施，按 A 方向最终决策） -> 移植 msext QQShareManager.m URL Scheme fallback 后填充。预备验证项： -> - 链接分享 → `mqqapi://share/to_fri?` 调起 QQ app -> - 朋友圈分享 → `mqqapi://share/to_qzone?` 调起 QQ 空间 -> - 调起即视为 success（URL Scheme 单向无返回，msext 同款乐观策略） +> Contract §3.1 ［2］`sharetype` 取值仅 "1"/"2"=微信 / "3"=闲聊，无 QQ 选项。 +> msext 的 QQShareManager 只服务于原生 SharePanel，不接 H5 桥。新外壳契约 +> 不变 → 不实现 QQ 分享，无需验证。 ---