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:
co-authored by
Claude Opus 4.7
parent
0a313afe8e
commit
d38ff0f8c4
@@ -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.swift,canShake / canVoice 状态 + WebContainer motionEnded 转发 + shakeEnd 反向)
|
||||
- [x] **2.4** `voicePlaying`(VoicePlayingHandler.swift,actor 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 打开 URL(BrowserHandler.swift,UIApplication.open async)
|
||||
- [x] **2.7** `opensaoma` 空实现注册(OpenSaomaHandler.swift,契约 §3.1【22】要求)
|
||||
- [x] **Bonus** `startlocation` stub(StartLocationHandler.swift,让 H5 启动不报 "no handler";Phase 5 接 LocationKit 完整实现)
|
||||
- [x] **Bridge 重构** `BridgeData.asXxx` 全部加 `nonisolated`,让 handler 闭包(@Sendable async)可以自由访问数据值;契约不变
|
||||
|
||||
##### 2.B Native→H5 反向 callback
|
||||
|
||||
|
||||
Reference in New Issue
Block a user