Phase 4 方向再次纠正:撤销 A,QQ + 抖音 SharePanel 三选一不依 SDK
用户提示"原项目还有 QQ 分享、抖音分享"。深度调研发现: 上一轮 A 方向决策 (a6095ef) 错了 — grep 范围之前仅看 NewRootVC.m, 漏了 gameController.m。msext gameController.m:575-597 显示 H5 调 friendsShare 时原生**弹 SharePanel 三选一面板**: sharefriend == 1 → SharePanel.showWithDictionary(微信好友 / QQ / 抖音) sharefriend == 2 → WechatShareManager.shareWithContent(朋友圈) Contract §3.1 [2]旧描述(sharetype=3 闲聊)已被 msext 新代码覆盖; sharetype 字段在新代码里读了但不用。 调研 QQ + 抖音是否需要 SDK: - QQShareManager.m:14: __has_include(<TencentOpenAPI/QQApiInterface.h>) 条件编译 + line 716-771 simpleShareToQQFriend URL Scheme fallback (mqqapi://share/to_fri?...) — **不依赖 SDK** - DouyinShareManager.m: 只 import Photos + MobileCoreServices; 全程 URL Scheme(snssdk1128://share/video / camera)+ 保存截图到 相册让用户在抖音里选 — **不依赖 SDK** 撤销 A 决策。新方向(Plan §5 4.2-4.4): - 4.2 SharePanel 三选一面板(msext gameController.m:585 等价行为) - 4.3 QQShare URL Scheme(移植 simpleShareToQQFriend) - 4.4 DouyinShare URL Scheme + Photos - 4.5(原 4.B)微信 SDK 接入(仍需项目方提供 framework + AppID + UL) 文档同步: - Plan §2.3 阻塞表:QQ 改为"不需要 SDK,走 URL Scheme";抖音同款 - Plan §5 Phase 4:4.2 重写为 SharePanel 设计 + 4.3 QQ + 4.4 抖音 + 4.5 微信 - CLAUDE.md 依赖管理段:"不接入 QQ SDK / 也不接入抖音 SDK", 含 LSApplicationQueriesSchemes + NSPhotoLibraryAddUsageDescription 说明 - Verification-Checklist L/M/N 章节:SharePanel + QQ + 抖音验证项 - Plan §6.4 里程碑加纠正记录(标a6095ef已撤销) 下一步:代码实施 4.B SharePlatform 协议 + SharePanel UI + ShareCenter 分发。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.7
parent
a6095ef4c8
commit
b071ced657
@@ -62,7 +62,8 @@ 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 分享~~ | **不需要** — Contract §3.1 [2]`friendsShare` 的 `sharetype` 取值仅 "1"/"2"=微信 / "3"=闲聊,**没有 QQ 选项**。msext 里 QQShareManager 只服务于原生 SharePanel(独立功能),不接 H5 桥。新外壳契约不变 → 不实现 QQ 分享。grep 验证:msext `NewRootVC.m` / `gameController.m` 全文未引用 QQShareManager | — |
|
||||
| ~~QQ OpenSDK `.framework`~~ | QQ 分享 | **不需要 SDK** — msext `QQShareManager.m:14` `__has_include` fallback 路径已有完整 URL Scheme 实现(`mqqapi://share/to_fri?...`),新外壳直接照搬即可。Info.plist 仅需加 `LSApplicationQueriesSchemes`(`mqq` / `mqqapi` / `mqqopensdkfriend` 等) | — |
|
||||
| ~~抖音 OpenSDK `.framework`~~ | 抖音分享 | **不需要 SDK** — msext `DouyinShareManager.m` 全程 URL Scheme(`snssdk1128://share/video` / `snssdk1128://camera`)+ Photos 框架(保存图片到相册让用户在抖音里选)。Info.plist 仅需加 `LSApplicationQueriesSchemes`(`snssdk1128`)+ `NSPhotoLibraryAddUsageDescription` 写入相册权限文案 | — |
|
||||
| 后台 `/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 | 后台团队 |
|
||||
@@ -467,7 +468,8 @@ Contract Design Plan(本文档)
|
||||
#### 前置
|
||||
- Phase 1 完成
|
||||
- ⏳ 微信 OpenSDK `.framework` + AppID + Universal Links
|
||||
- ✗ ~~QQ OpenSDK~~ **不需要**:QQ 分享走 URL Scheme 路径(msext `QQShareManager.m` 已实现的 fallback),无 SDK 无 AppID 验证
|
||||
- ✗ ~~QQ OpenSDK~~ **不需要**:URL Scheme(参 msext `QQShareManager.m:14` `__has_include` fallback)
|
||||
- ✗ ~~抖音 OpenSDK~~ **不需要**:URL Scheme + Photos 框架(参 msext `DouyinShareManager.m` 全程无 SDK)
|
||||
- ⏳ 后台 `/wechat/login` 接口(或先用客户端直拼 fallback)
|
||||
|
||||
#### 任务清单
|
||||
@@ -477,9 +479,21 @@ 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 分享~~ **不实施**(按 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.2** **SharePanel 三选一面板(msext gameController.m:585 等价行为)**
|
||||
- **关键发现**:msext `gameController.m:575-597` 表明 H5 调 `friendsShare` 时:
|
||||
- `sharefriend == 1`(好友/私聊)→ 弹 **SharePanel 三选一面板**(微信好友 + QQ + 抖音)
|
||||
- `sharefriend == 2`(朋友圈)→ 直接 `WechatShareManager.shareWithContent`(朋友圈)
|
||||
- Contract §3.1 [2]旧描述(sharetype=3 闲聊)已被 msext 新代码覆盖;`sharetype` 字段在新代码里读了但不用
|
||||
- 新外壳按 SharePanel 模式实现,不依赖 Contract 旧描述
|
||||
- [ ] **4.3** **QQ 分享走 URL Scheme,不依赖 SDK**
|
||||
- 移植 msext `QQShareManager.m:716-771` `simpleShareToQQFriend` 简化版
|
||||
- URL 构造:`mqqapi://share/to_fri?version=1&cflag=0&req_type=1&url=...&title=...&description=...`
|
||||
- `canOpenURL` 检查 + `openURL` 异步打开
|
||||
- [ ] **4.4** **抖音分享走 URL Scheme + Photos,不依赖 SDK**
|
||||
- 移植 msext `DouyinShareManager.m` 简化版
|
||||
- URL Scheme:`snssdk1128://share/video` / `snssdk1128://camera`
|
||||
- Photos:保存截图到相册让用户在抖音 app 里选取(H5 截图 / 远端图共用此路径)
|
||||
- Info.plist 加 `NSPhotoLibraryAddUsageDescription` 写入权限文案
|
||||
- [ ] **4.3** `Source/SDK/WeChat/WeChatSDK.swift` 启动注册(Design §4.2 `registerFull` + 全部 12 个 `MMAPP_SUPPORT_*` flag)
|
||||
- [ ] **4.4** `Source/SDK/WeChat/WeChatManager.swift`(@MainActor)
|
||||
- 持久 delegate
|
||||
@@ -786,7 +800,8 @@ H5 调 `OpenurlTitleData` 打开弹层 WebView,弹层内 H5 用 `window.settin
|
||||
| 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 | `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 |
|
||||
| 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 分享 | `a6095ef`(**已被下一行撤销**) |
|
||||
| 2026-06-22 | **Phase 4 方向再次纠正**:用户提示"原项目还有 QQ 分享、抖音分享"。深度调研发现 grep 范围之前不够 — msext `gameController.m:575-597`(不是 NewRootVC)显示 H5 调 `friendsShare(sharefriend=1)` 时原生**弹 SharePanel 三选一面板**(微信好友 / QQ / 抖音);Contract §3.1 [2]旧描述(sharetype=3 闲聊)已被 msext 新代码覆盖(sharetype 字段读了但不用)。QQ + 抖音都不依赖 SDK:QQ 走 URL Scheme(`QQShareManager.m:14` `__has_include` fallback),抖音走 URL Scheme + Photos(`DouyinShareManager.m` 全程无 SDK)。撤销 A 决策,新方向:Phase 4.2 SharePanel + 4.3 QQ URL Scheme + 4.4 抖音 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「典型案例」段。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user