Phase 2.A:大厅 8 个简单 handler 落地 + BridgeData 加 nonisolated

闭合 Phase 1.17 联调最后一公里(解决 Xcode 日志 4 个 "no handler registered"
+ 提前落地 4 个无外部依赖的简单 handler)。

新增 7 个 handler 模块(Source/Bridge/Handlers/):
  - ClipboardHandler.swift           §3.1 [13][14]剪贴板 UIPasteboard.general
  - ShakeHandler.swift               §3.1 [7][8][9]摇一摇 + §3.2 [5]shakeEnd 反向
                                       canShake / canVoice 状态 + motionEnded 转发钩子
  - VoicePlayingHandler.swift        §3.1 [6]actor VoiceCenter.shared 开关位
  - DeviceInfoHandler.swift          §3.1 [21]+ §3.2 [1]getphoneInfo 大写 I 入、
                                       getphoneinfo 小写 i 出反向 callback
                                       DeviceInfoSnapshot 6 字段(IDFA 用 idfv 兜底,
                                       CLAUDE.md 不接 ATT/IDFA)
  - BrowserHandler.swift             §3.1 [16]UIApplication.open async(Task @MainActor
                                       异步打开,闭包先 cb 不等 open 完成)
  - OpenSaomaHandler.swift           §3.1 [22]空 stub(契约要求注册)
  - StartLocationHandler.swift       §3.1 [20]Phase 5 完整实现,Phase 2 stub

扩展 VibratorHandler.swift:
  - §3.1 [10]vibrator(原有)+ [11]repeatvibrator(msext RootVC.m:1820 沿用:
    实际单次 vibrate 不真循环)+ [12]canclevibrator

BridgeProtocol.swift BridgeData 加 nonisolated:
  - 项目默认 SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor 让 BridgeData 跨 actor
    访问被拦;asString / asDouble / asInt / asBool / asArray / asObject /
    subscript 全部标 nonisolated(纯值类型本就该是 isolation-free)
  - 影响所有 @Sendable async handler 闭包内的 data?.asXxx 访问

WebContainerViewController 接入:
  - 加 private let shakeHandler = ShakeHandler() 持有
  - registerBridgeHandlers() 注册 8 个 handler 模块
  - 加 canBecomeFirstResponder = true + viewDidAppear becomeFirstResponder
  - 加 motionEnded(_:with:) 转发到 shakeHandler.handleMotionEnded
    (motion 检测必需 first responder,否则不触发)

BuildProject 通过。重装 app 后 H5 启动应不再报 "no handler registered" 错误。

Plan §5 Phase 2.A 全部勾选(含 startlocation bonus stub + BridgeData
nonisolated 重构)。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
joywayer
2026-06-22 18:38:00 +08:00
co-authored by Claude Opus 4.7
parent 0a313afe8e
commit d38ff0f8c4
11 changed files with 364 additions and 33 deletions
+9 -7
View File
@@ -347,13 +347,15 @@ Contract Design Plan(本文档)
##### 2.A H5→Native handler(无外部依赖)
- [ ] **2.1** `gameCopytext` / `gamepastetext`(剪贴板)
- [ ] **2.2** `vibrator` / `repeatvibrator` / `canclevibrator`已有,扩展
- [ ] **2.3** `startshake` / `stopshake` / `SwitchShake`摇一摇开关 + 音效开关
- [ ] **2.4** `voicePlaying`语音播放总开关
- [ ] **2.5** `getphoneInfo` → 触发反向 callback `getphoneinfo`注意小写 i
- [ ] **2.6** `browser` → 系统 Safari 打开 URL
- [ ] **2.7** `opensaoma` 空实现注册(契约 §3.1【22】要求)
- [x] **2.1** `gameCopytext` / `gamepastetext`(剪贴板)`Source/Bridge/Handlers/ClipboardHandler.swift`UIPasteboard.general
- [x] **2.2** `vibrator` / `repeatvibrator` / `canclevibrator`VibratorHandler.swift 扩展 2 项
- [x] **2.3** `startshake` / `stopshake` / `SwitchShake`ShakeHandler.swiftcanShake / canVoice 状态 + WebContainer motionEnded 转发 + shakeEnd 反向
- [x] **2.4** `voicePlaying`VoicePlayingHandler.swiftactor VoiceCenter.shared.isEnabled 开关位,Phase 3 mediaTypeAudio 读此
- [x] **2.5** `getphoneInfo` → 触发反向 callback `getphoneinfo`DeviceInfoHandler.swift,注意大小写:大写 I 入、小写 i 出;DeviceInfoSnapshot 6 字段,IDFA 用 idfv 兜底因为 CLAUDE.md 不接 ATT
- [x] **2.6** `browser` → 系统 Safari 打开 URLBrowserHandler.swiftUIApplication.open async
- [x] **2.7** `opensaoma` 空实现注册(OpenSaomaHandler.swift契约 §3.1【22】要求)
- [x] **Bonus** `startlocation` stubStartLocationHandler.swift,让 H5 启动不报 "no handler"Phase 5 接 LocationKit 完整实现)
- [x] **Bridge 重构** `BridgeData.asXxx` 全部加 `nonisolated`,让 handler 闭包(@Sendable async)可以自由访问数据值;契约不变
##### 2.B Native→H5 反向 callback