 joywayer
|
7fe089577b
|
补齐非 console.error 类 H5 报错的观察通路
排查「H5 有输出但 Safari 看不到」时发现，即便绕开 Safari 只看 Xcode，也有三类
故障是完全静默的：
1. 资源 404（<script>/<img>/<audio> 加载失败）
error 事件只在元素自身触发且不冒泡，原先 addEventListener('error', fn) 收不到。
改为捕获阶段 (capture=true)，JS 异常的 ev.target 是 window，据此在同一 listener
内分流 onerror / resourceerror 两类。缺图缺 js 是 H5 最常见的线上故障，此前零信号。
2. WebView 加载失败（didFailProvisionalNavigation / didFail）
两个 VC 的 WKNavigationDelegate 此前只实现了 didFinish。AppSchemeHandler 找不到
index.html、子游戏 zip 解压残缺时，splash 永不淡出、卡在启动图，Xcode 无任何输出。
3. WebContent 进程终止（webViewWebContentProcessDidTerminate）
canvas 游戏 JSC OOM 被系统回收时页面白屏，同样静默。
⚠️ 只 log 不自动 reload —— 自动恢复是行为变化，msext 没有，不引入。
另：H5ErrorRelay.install 增加 label 参数，输出前缀从 [H5 xxx] 变为
[H5:lobby xxx] / [H5:subGame xxx]。同时存在多个 BridgedWebView 时原先分不清
日志来自谁，也就无法反推该在 Safari「开发」菜单里选哪个条目。
无契约影响：H5 可观察行为不变，新增回调仅记录不改流程。
Debug / Release 两个配置均已编译验证。
docs/H5-Debug-Guide.md §8.1 更新能力表，新增 §8.2 已知盲区 / §8.3 设计要点。
|
2026-08-08 14:19:58 +08:00 |
|
|
joywayer
|
f4acccdd6c
|
H5ErrorRelay 增加 console.log/info 转发，查明 Console 空的根因
排查「Safari Web Inspector 里 H5 控制台没输出」时定位到首要原因不在原生侧：
gamehall.zip 的 js/01_SubGame/00_SubGame_Config.js 里 Game_Config.Debugger
.isDebugger 出厂为 false，把「发送数据 / 接收数据」等高频日志全挡住了；未被
挡住的 Connect:... 又在建 websocket 时就打完，挂上 Inspector 时早已过去。
调试时在 Safari 控制台运行时改 Game_Config.Debugger.isDebugger = true 即可，
不动 H5 任何文件（原则 A）。
顺带补齐原生转发能力：
- 新增 console.log / console.info 转发，仅 Debug 构建注入（#if DEBUG 编译期
摘掉那段 JS）。Release 包不为每条业务日志付 JS→Native IPC，也不把 H5 内部
输出暴露给外部审阅；已验证 Release 二进制中该 hook 字符串命中 0 次
- log/info 走裸 print 而非 diagLog：diagLog 会落盘到 Documents/diag.log，而该
sink 无轮转无上限（BridgeBus.swift:47），isDebugger 打开后 firehose 会吃光磁盘
- 参数格式化统一走 fmt()，对象改用 JSON.stringify —— 大厅业务大量 console.log(msg)
打整包，原先 String(obj) 只得到无用的 [object Object]；循环引用逐级回退
- 原始 console 调用照常透传，不影响 Safari 侧同时查看
无契约影响：H5 可观察行为不变，Release 行为完全不变。
docs/H5-Debug-Guide.md 同步补 §7 Q3 根因 + 新增 §8.1 转发能力表。
|
2026-08-08 14:05:37 +08:00 |
|
|
joywayer
|
1203957924
|
修复定位的回调问题
|
2026-08-07 12:18:44 +08:00 |
|
|
joywayerandClaude Opus 5
|
3f8b382ad3
|
加桥/定位边界诊断日志，排查子游戏收不到 getlocationinfo
现象：大厅 H5 能正确拿到定位，子游戏拿不到。已静态排除「子游戏未注册
handler」与「回调错发给大厅」两个猜测（BridgeBus 是 per-WebView 实例、
handlers 是实例状态，反向 call 捕获各自的 bridge，物理上不可能串台；
下载真实子游戏 zip 比对后确认 H5 侧大厅/子游戏逻辑完全对称）。
为定位真正的失败层，在各组件边界加日志（纯诊断，不改任何行为）：
- BridgeBus 加 label（lobby / subGame）区分来源，记录 ← H5 调用、
→ H5 反向 call、native handler 未注册、evaluateJavaScript 失败
- sendToJS 改为返回 'ok'/'no-bridge'，H5 侧 bridge 未就绪导致的静默丢包
现在会打错误日志（原实现 `if (window.X)` 直接丢弃，完全不可见）
- LocationService 记录 requestOnce 序号 / shared manager id /
requestLocation 的 BOOL 返回值 / completionBlock 是否回来 / stop() 调用
—— 高德文档明确 requestLocation 返回 NO 时 completionBlock 永不调用，
当前代码忽略该返回值会让 continuation 永挂，H5 连 errorCode 12 都收不到
- H5ErrorRelay 补 console.warn 中继，让 WVJB「H5 侧无对应 handler」的
warn 能出现在 Xcode console
契约影响：无。仅新增日志与可选 label 参数，桥接接口名 / 字段名 / 数据结构
均未变动（docs/H5-Native-Contract.md §3.1［20］/ §3.2［6］不变）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UMPCLfsuxvwgMotzsb67QH
|
2026-08-07 01:54:18 +08:00 |
|
|
joywayerandClaude Opus 4.7
|
a1c5883cc5
|
Phase 9.2：H5ErrorRelay 把 H5 异常中继到原生 print
零修改 H5（原则 A）：WKUserScript .atDocumentStart 在业务 JS 跑前 hook
三类异常源：
- `console.error(...)`：保留原函数链式调用 + 转发 args
- `window.onerror`：onmessage / filename / lineno / colno / error.stack
- `unhandledrejection`：reason + reason.stack
走独立的 webkit.messageHandlers.h5error 通道（与 WVJB 不同 channel，不冲突）。
原生侧 MessageProxy weak target 切断 retain cycle。仅 BridgedWebView 安装
（大厅+子游戏），OverlayViewController 是第三方外链，不挂。
开发期价值：H5 出错时 Xcode console 直接能看到 "[H5 onerror] ... at xxx.js:42:8"，
减少调试盲点。生产期 print 走 OSLog，对体积/性能影响极小。
新增：
- Source/Bridge/H5ErrorRelay.swift（@MainActor singleton）
接入：
- BridgedWebView.init：H5ErrorRelay.shared.install(into:) 在 WVJB 之后
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
2026-06-23 02:04:46 +08:00 |
|