daoqi/youle_app_ohos
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
85 Commits 1 Branch 0 Tags
db206068c0907f062042250a0c3b06f2f1c3f9c4
Commit Graph
23 Commits
Author SHA1 Message Date
lanterngamescnandClaude Opus 4.8 db206068c0 修复大厅启动页→H5"白闪+二次显示 splash"：启动图覆盖层上移到根层 
现象：大厅资源下载完成、splash 进度满后，进入 H5 前先闪一下白屏、又重新
显示一次 splash 背景图，才进 H5（真机 nova 14 复现）。

根因：原启动图视觉随 SplashPage 渲染，replacePathByName 切到
BridgeGameContainer 时，旧页销毁与新页 Web 首帧之间存在导航空隙（白闪）；
而 BridgeGameContainer 自带的大厅 cover 又在切换后重新挂载，看起来像"第二次
splash"。两者皆因视觉绑定在会被切换/重建的页面上、与时序耦合。

修法（H5 零改动，纯原生）：
- 启动图 + 金色进度条整体上移到 Index 根层 Stack 覆盖层，由 AppStorage
  KEY_SPLASH_VISIBLE 控制，从 app 启动持续显示到大厅首帧上屏（onPageEnd）才撤。
- SplashPage 退化为纯启动逻辑载体（透明 NavDestination），仅把进度/文案/
  阻断写入 AppStorage 供根层覆盖层呈现。
- BridgeGameContainer 移除自带大厅 cover，onPageEnd 置 splashVisible=false。

SplashPage→BridgeGameContainer 的页面切换由此发生在常驻覆盖层之下，时序无关，
彻底消除导航空隙白闪与二次 splash，大厅就绪即直接显示 H5。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 08:57:30 +08:00
lanterngamescnandClaude Opus 4.8 0425123465 消除 splash→大厅的白屏/黑屏闪烁 
大厅 Web 首帧前用启动图(launch_image)盖住，保留到 onPageEnd（页面加载完、已稳定
上屏）再撤——不在 onFirstContentfulPaint 撤，避免首帧绘制到合成上屏间一帧黑屏。
另给容器 Stack 垫白底，使页面切换/Web 初始化的残留缝隙显白色（与启动页白底无缝），
而非刺眼黑屏。

真机验证：splash→覆盖层(品牌图)→大厅 全程白底基调，无黑屏/白屏突兀闪烁。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 02:40:10 +08:00
lanterngamescnandClaude Opus 4.8 de5b950d9b 实现子游戏按需下载，修复点子游戏白屏（§11.1 路径A） 
根因：整包 gamehall.zip 顶层只含 gamehall，子游戏需按需单独下载；原 switchGame
直接 loadUrl 不存在的目录 → ArkWeb invalidFileUrl → 白屏。

对齐 Android NewwebviewActivity 的 updategamezip：
- ConfigManager.resolveGame(remote, gameid)：以 gamedownloadurl 为 gameid 经
  agent→game→channel→market 分层解析子游戏 game_zip/game_version（复用 VersionResolver）。
- ResourceManager.updateSubgame：下载→暂存解压→校验 <dir>/index.html→原子换入 urlpath/<dir>。
  另加 subgameInstalled/subgameLocalVersion/subgameLocalGameId。
- BridgeGameContainer.switchGame 改 async + prepareSubgame：目录缺失先下载、已装比对远程
  版本更高才更新；下载期复用启动页同款金色进度条；远程配置 10 分钟缓存（对齐 gameconfigtime）。
- SwitchGamePayload 增 gameId（gamedownloadurl）。

真机验证：点三个老K → 下载 sangelaok.zip(9.4M) → 解压加载，子游戏正常渲染
（V1.155 与配置 game_version=155 一致）；日志不再 invalidFileUrl。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 02:33:55 +08:00
lanterngamescnandClaude Opus 4.8 4b291396bc 清理排查过程的非必需改动：移除 onActive 保活与 H5 console 调试转发 
定位 touch→mouse 时序为真因后，清理排查途中加入但最终非必需的代码：
- 移除 onActive/notifyShown（基于"ArkWeb 未激活态暂停动画"的误判；实测页面本就 active/visible，无需）。
  含 WebSlot.notifyShown + setup 调用 + BridgeGameContainer NavDestination.onShown。
- 移除 onConsole H5 console→hilog 调试转发（三容器 + webConsoleOn 字段 + logWebConsole + 多余 AppEnv 引入）。
保留：touch→mouse shim（真正修复）、expandSafeArea（白边修复）、debug 版 setWebDebuggingAccess。
（合成保活、SYNC_RENDER 已于 0caf385 移除。）devecocli build 通过、真机正常启动。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 00:48:50 +08:00
lanterngamescnandClaude Opus 4.8 eccd0efb91 onConsole 仅 debug 生效，release 零日志开销 
H5 console 转发开关固化为构造期 DEBUG 常量字段 webConsoleOn；release 下 onConsole 回调
仅一次字段读取即 return，不格式化、不写 hilog；setWebDebuggingAccess 本就仅 debug。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:15:40 +08:00
lanterngamescnandClaude Opus 4.8 5462643ce2 调试：onConsole 覆盖全部三个 Web 容器，全量转发 H5 console 
大厅/子游戏(BridgeGameContainer)/通用网页(GenericWebContainer) 的 Web 均加 onConsole，
统一 tag=WebConsole，带角色(lobby/subgame/genericweb)+级别+来源文件行，debug 限定。
便于从 H5 console 排查问题（如动画/缩放）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:04:23 +08:00
lanterngamescnandClaude Opus 4.8 7179e95da1 调试：onConsole 转发 H5 console 到 hilog（debug 限定） 
便于排查 H5 渲染/行为问题（如动画、缩放）。release 不转发以免噪声。
（移除临时诊断探针，保留 onConsole。）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 21:33:57 +08:00
lanterngamescnandClaude Opus 4.8 d16c7259b4 修复 H5 缩放等动画不播放：大厅 Web 首次显示补 onActive() 
ArkWeb 文档：onInactive 态会暂停"可安全暂停的内容，例如动画"（CSS 动画/rAF），onActive 恢复。
本工程 controller.onActive() 原仅在从子游戏返回(activate)时调，**首次进大厅从未调用**，
大厅 Web 处于未激活态 → CSS transform/keyframes 动画与 requestAnimationFrame 被暂停，
表现为"画面在、但缩放等动画卡住不播放"。

修复：WebSlot 增 notifyShown()（调 controller.onActive()，幂等），在 setup() 激活槽建好即调，
并在 BridgeGameContainer 的 NavDestination.onShown 调用（首次进大厅 + 从通用网页返回均覆盖）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 21:19:33 +08:00
lanterngamescnandClaude Opus 4.8 81ba09b597 H5 全屏适配：Web 扩展系统安全区，消除底部白边 
大厅/子游戏(BridgeGameContainer)与通用网页(GenericWebContainer)的 Web 组件加
.expandSafeArea([SYSTEM],[TOP,BOTTOM])，让 H5 铺满系统安全区（底部导航手势区），
消除底部白边，与原 Android 全屏 WebView 一致。模拟器验证：大厅满屏到底，无白边。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 20:56:51 +08:00
lanterngamescnandClaude Opus 4.8 5cbe5d4dd0 M3(T-M3-13): 分享面板对齐原工程——微信SDK + QQ/抖音系统分享 
对齐 Android SharePanelHelper 流程：H5 friendsSharetypeUrlToptitleDescript →
原生弹自定义面板(微信/QQ/抖音) → 按所选平台分享。

- common ShareEvents：SHOW_PANEL + SharePanelRequest/Result；ShareProvider 经一次性
  resultEvent 与 entry 容器一对一解耦（双槽实例隔离，避免广播串扰）
- ShareProvider 重构：微信走 SDK（type2 Canvas截图→WXImageObject / 其他→WXWebpageObject；
  scene 好友/朋友圈；回传 sharesuccess）；QQ/抖音走 @kit.ShareKit 系统分享(文本/图片/链接/视频，
  不集成对应 SDK、不回传)；截图失败统一降级
- 截图：CapabilityContext.captureCanvas（WebSlot 用 controller.runJavaScript 取 canvas
  toDataURL，非激活/出错返回空）；FileSystem.writeBytes 落盘；fileUri 给 WXImageObject/系统分享
- entry SharePanel 组件 + BridgeGameContainer 顶层叠加；重复面板/销毁均取消回投防 once 悬挂

真机验证项：微信开放平台注册后的真分享、系统分享面板拉起、canvas 截图

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 08:00:03 +08:00
lanterngamescnandClaude Opus 4.8 01e4c0e99e M3 补全：移除 EchoSample 样板 + getcompareCode 接版本决策 + app_gamename 
- 移除 EchoSampleProvider（组装根/导出/文件）：M3 全部 Provider 已就位，
  getTime 由 DeviceProvider 提供；样板回显仅 M1 测试页用，生产无依赖
- getcompareCode：启动期 StartupOrchestrator 把网络 App 版本(VersionDecision.appVersion)
  存 KvStore(KV_KEY_NET_APP_VERSION)，DeviceProvider 同步读出与本地 config.appversion 比较，
  本地>网络→'1' 否则'0'（对齐 Android apputil.code 语义）
- app_gamename：VersionXml.parse 解析子 <game name>；ResourceManager.localGameName 暴露；
  AppDataInjector.buildValues 接 gameName 参数；大厅/子游戏两处注入均填入

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 07:33:13 +08:00
lanterngamescn 9be1a23635 review: M5 双 Web 审查后的质量加固（两轮真机验证） 
八角度审查双 Web 批次。修确凿问题：

铁律风险（最高）
- network_config：base-config cleartextTrafficPermitted 由 false 改 true。我之前的"白名单收紧"比平台默认更严，
  会拦掉 H5 可能访问的任意第三方明文 http 与本地 127.0.0.1 上传 → 违反 H5 零改动。改回允许明文（对齐原 Android）

正确性
- 子游戏 controller 不再复用：每次进子游戏 new WebviewController()（存 slotS.controller），消除"复用同一 controller
  时 onControllerAttached 不再触发致第二个子游戏建不出桥"的竞态。真机两轮验证 subB 桥正常 ✓
- BridgeController.dispose 置 active=false：显式抑制 dispose 后能力延迟异步 callHandler（不靠 adapter emitter-off 偶然安全）
- WebSlot.resumeLoaded 补发 setPostUrl：覆盖"非激活期渲染崩溃重载后 onFirstProgress 被闸门抑制丢失上传地址"。真机验证返回必带 setPostUrl ✓
- onRenderExited 不可见时延迟重载：非激活槽崩溃标记 needReload，激活时再 reload（官方建议可见后重载）；activate 返回是否重载，resumeLoaded 据此避免重复推送
- 容器 aboutToDisappear：先退订 cancels 再 dispose 槽，关闭销毁期事件又建槽窗口
- LocationProvider：权限对话框 await 后加 disposed 守卫（防 onDestroy 后再注册监听泄漏+打已弃桥）
- AudioProvider：createAVPlayer.then 加 disposed 守卫（创建期已销毁则直接 release，防孤儿播放器泄漏）
- NetworkProvider.onForeground：重订阅后补播当前网络（覆盖非激活期网络变化，避免 H5 状态陈旧）

研判驳回：network_config 需 metadata 关联（官方文档证实 profile 路径自动识别）；app 前后台只发 activeSlot（非激活大厅已收 appservice'2'，正确）。
延期：WeChatApi 单例陈旧回调（随微信集成）。

devecocli build + scripts/test.sh 通过；模拟器两轮(大厅↔subA↔大厅↔subB↔大厅)无回归。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 00:13:44 +08:00
lanterngamescn 1aa1ccf9af M5(T-M5-04): onRenderExited 渲染崩溃兜底 
- WebSlot.onRenderExited(reason)：渲染子进程异常退出(崩溃/被杀/OOM)时 controller.refresh() 重载恢复，
  重置 firstDone 使重载后重推 appservice/setPostUrl；disposed 守卫避免子游戏销毁期误刷
- BridgeGameContainer：大厅 Web 与子游戏 Web 各挂 .onRenderExited → 对应 slot 恢复
- 防渲染子进程崩溃白屏（框架 §9 内存/崩溃兜底、附录 B 渲染兜底）
devecocli build 通过。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 23:52:42 +08:00
lanterngamescn 9abd571f43 M5: 显式化导航拓扑约束（无子游戏→子游戏，须经大厅） 
确认当前实现已符合用户拓扑：大厅常驻不销毁、子游戏临时销毁、仅 大厅↔子游戏、
子游戏换子游戏须 backgameData 回大厅再 SwitchOverGameData 进新子游戏。

- switchGame 守卫拆分：已在子游戏中(subgameUrl!='')时忽略 SwitchOverGameData 并告警日志
  （此前静默忽略）；注释说明拓扑约束与正确流程。无功能变更，仅可观测性。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 23:49:47 +08:00
lanterngamescn d7148a72e6 M5(T-M5-01/02): 双 Web 大厅/子游戏架构 + WebSlot 激活协议（真机验证通过） 
- 新增 entry/web/WebSlot：封装单 Web 的桥+能力+激活生命周期（setup/onLoadIntercept/onPageEnd/
  onFirstProgress/activate/resumeLoaded/deactivate/onAppForeground/onAppBackground/dispose）
- BridgeGameContainer 重写为 Stack 双 Web：大厅常驻(始终在 Stack，subgame 时 Hidden+onInactive)、
  子游戏临时(subgameUrl 非空时渲染，onControllerAttached 各自 setup)；替换 M2/M4 单 WebView loadUrl
- 激活协议：进子游戏 deactivate(大厅 appservice'2'+forEachBackground+setActive(false)+onInactive)→
  注入子游戏 app_data(LT'1')→建子游戏 slot→onFirstProgress(appservice'1'+setPostUrl)；
  返回 dispose 子游戏→大厅 resumeLoaded(appservice'1'+getWebdata)
- 每槽独立 BridgeController+buildCapabilities（结构隔离，接口不串）；nav/前后台事件路由到 activeSlot
- 内置测试包升级：gamehall+subA 自动驱动页（大厅→SwitchOverGameData→子游戏→backgameData→大厅）

真机验证（Pura 90 全新装）：LOBBY LT=0 appservice1→SwitchOverGameData→LOBBY appservice2→
SUB LT=1 appservice1+独立 getTime→backgameData→LOBBY appservice1+getWebdata=fromSub。
大厅无二次 ready=未重载=常驻保活 ✓；接口不串 ✓；只一个激活 ✓。无 registration failed/RenderExited。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 23:32:18 +08:00
lanterngamescn 6bec98d584 review: M3+M4 成果审查后的质量加固 
八角度审查 15 Provider+微信/七牛+双容器+导航。桥核心/契约骨架基本无误；修确凿问题：

正确性/健壮性
- ShakeProvider：stop()/onDestroy 取消未决 shakeEnd 计时并复位 pending（修停止后仍触发出站、重启后首摇被吞、计时器泄漏）
- VibrateProvider：startRepeat 先 stopRepeat（修重复 repeatvibrator('1') 叠加出无法取消的孤儿计时链）
- PhotoProvider：JSON.parse 后 Array.isArray 守卫（修 H5 传非数组致 .map 抛错、出站永不下发使 H5 挂死）；去不可达 .catch
- GenericWebContainer：getWebdata 直调改用 JSON.stringify 生成 JS 字符串实参（修 data 含换行/行分隔符断行致注入语法错误）
- LocationProvider：单次请求前先停连续监听（修连续后切单次仍持续推送）；去 push() 中 !continuousOn→stopContinuous 死代码

加固/清理
- BridgeGameContainer：抽 firstReadyPush() 幂等助手（appservice/setPostUrl/pendingWebdata）；保持 100% 触发时序
  （注明为何用 100% 而非更早 onPageEnd：确保 H5 已注册 handler）；aboutToDisappear 置空 hostCtx/config/resource

研判驳回（与原 Android 一致/契约默认/自愈）：getphonestate CallState 值映射、通用容器 orientation 默认横屏、setMuted prepared 自愈、exitDialog backgameData() 无参通知。
延期（随微信集成）：WeChatApi 单例陈旧回调/instanceof（容器重建后回调打旧 bridge；微信运行期本就待开放平台注册）。
记录待重构：AbstractProvider 基类 + parseJson 助手（去 15 Provider 重复 bridge/ctx/解析样板）、AVPlayer 复用、openBrowser/orientation 抽公共。

devecocli build 通过；单测通过；模拟器复测桥往返/appservice/setPostUrl 无回归。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 21:30:06 +08:00
lanterngamescn 98854f7312 M4: 通用网页容器 + SettingsProxy + NavProvider + 子游戏切换 
T-M4-01/02/03 GenericWebContainer（§11.3 第二套机制，不挂桥）：
  - javaScriptProxy 注入 settings 对象 6 方法（SettingsProxy，函数回调避开 ArkTS 对象字面量限制）
  - 首次 100% runJavaScript 直调 getWebdata('<data>')；返回键 isbackfinishweb→gamebackkeydown /
    isexitdialogeshow→退出确认→backgameData()；关闭 pop({data}) 101 语义回上层
  - orientation "1"竖/其他横（window.setPreferredOrientation）；browser 隐式 want
T-M3-06 NavProvider：OpenurlTitleData(开通用容器,onPop→callHandler getWebdata)、
  SwitchOverGameData(同容器 loadUrl 切子游戏+重注入 app_data(launchtype'1')+方向+复位首屏标志)、
  getGameinstall(同步 1/0 查 <解压根>/<dir>/index.html)、backgameData(重载大厅+待加载后 getWebdata)
导航解耦：common NavEvents(名+具名 payload interface)；NavProvider 发 EventBus → BridgeGameContainer 执行
  （容器持 pathStack/controller）。EventBus payload 放宽为 Object（ArkTS 禁 Record 字面量），用 GenericEventData
domain AppDataInjector.buildValues 复用（StartupOrchestrator + 子游戏切换共用，去重）
组装根装配 NavProvider

devecocli build 通过。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 20:58:10 +08:00
lanterngamescn 4590d5bf70 review: M2 成果审查后的质量加固 
三路+对照审查 M2 全部成果。桥核心(M1，本期未改)与契约骨架零问题；发现集中在新的资源/启动/容器代码，已修：

高危
- ResourceManager.updateGame 原子化：下载→解压暂存→校验 <gamestart>/index.html→才删旧并 rename 换入。
  修复"先删旧 gamehall 再解压，失败即把可用资源砖掉"且 catch『keep local』失效的数据丢失风险
- BridgeGameContainer.setupBridge：先建桥并赋值 this.bridge，能力注册/配置加载整体兜底 try/catch。
  修复"config/registration 抛错→bridge 永远 undefined→H5 所有 callHandler 静默"违反 H5 零改动铁律

中危
- VersionResolver：空 gameid 守卫（大厅不参与 game 树匹配，避免误命中 gamelist 空 id 节点）；
  两树 version 平手时取"有下载地址"的一棵（避免选中只有版本号无下载地址的层）。新增 2 单测，覆盖率 83.7%
- Downloader：dataReceive 写盘失败标记并于请求结束后抛出（避免磁盘满致截断文件被当作下载成功）
- FileSystem：rmrf 的 statSync 纳入 try（兑现"不存在/竞态则忽略"承诺）；copyRawFileTo 按
  byteOffset/byteLength 切片写入（避免 Uint8Array 为大池子视图时写入多余字节致 zip 损坏）；新增 rename
- ConfigManager.fetchSecondary：二级节点本层版本字段也并入（此前只换 channellist/agentlist 会丢节点自身版本/下载地址）

清理/抗回归
- 跨域白名单路径改用 ResourceManager.resourceRoot()（单一来源，避免与领域层路径定义漂移致 V2 回归）
- 前后台订阅移到 setupBridge（桥就位后），避免冷启动 FOREGROUND 早于桥到达被丢
- prepareBuiltin 单次读取内置包（去掉"先整包读探测、再整包读拷贝"双读）
- LocalUploadServer 删死码 isRunning/running
- 文档化延期项：weburl 分支不注入 app_data（同 Android，远程大厅自带）、app_gamename 待 M3 扩展 VersionXml、
  子游戏切换 firstProgressDone 复位 TODO(M3 T-M3-06)

devecocli build 通过；单测全通过；模拟器复测 app_data/V2 fetch/桥双向/特殊字符往返均无回归。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 19:05:46 +08:00
lanterngamescnandClaude Opus 4.8 2100faaef7 M2(V2 阻塞性验证通过): setPathAllowingUniversalAccess 解决 file:// 跨域 
T-M2-08 V2：真机验证 file:// 加载下 H5 fetch/XHR 取本地资源——首测被 CORS 拦截
（origin 'null'，file 协议不在允许跨域 scheme 列表，正是框架 §7.3 预判风险）。
启用官方方案 WebviewController.setPathAllowingUniversalAccess([filesDir/tsgames])，
对 H5 完全透明（仍 file:// 加载）。复测：V2 fetch/XHR OK。

真机端到端链路全通（Pura 90 模拟器）：启动编排→远程失败降级本地→解压内置包→
注入 app_data.js→file:// 加载大厅→跨域 fetch OK→桥握手→getTime 回执→nativeEcho
特殊字符往返一致。app_data 全局变量、Launchtype=0、appservice/setPostUrl 下发均正确。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:41:42 +08:00
lanterngamescn 2b0bd1f392 M2(容器+能力骨架+启动接线): CapabilityProvider/Registrar/AppModule + BridgeGameContainer 完整化 + Splash 接编排 
T-M2-13 能力插件框架骨架：CapabilityProvider/CapabilityContext 接口、CapabilityRegistrar(批量注册+生命周期转发)、
        组装根 AppModule.buildCapabilities()(唯一知道全部能力处)、EchoSampleProvider 样板
T-M2-10 BridgeGameContainer 完整化：经 Registrar 注册能力(替换内联 handler)、首次进度 100% 推 appservice/setPostUrl、
        加载 params.entryUrl(回退 test_echo)、前后台 EventBus 联动、aboutToDisappear 全量清理；getContext→getHostContext 去弃用
SplashPage：进入即跑 StartupOrchestrator，完成 replace 进大厅、showmessage 阻断弹公告、进度条
内置测试大厅 rawfile/gamehall_builtin.zip（gamehall/index.html+data/test.json+version.xml，正斜杠标准 zip），
  作 M2 端到端 + V2(file:// XHR) 离线验证页；真实大厅由远程 zip 在生产下发

devecocli build 通过。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:36:59 +08:00
lanterngamescnandClaude Opus 4.8 bdb920f61e review: M0/M1 成果审查后的质量加固 
三路独立审查：桥引擎(对照 lzyzsd 逐字)与契约 SSOT(对照原 Android 44 handler)
两个命门维度【零问题】；以下为架构/质量改进项的修复：

- [安全红线] BridgeGameContainer setWebDebuggingAccess 加 AppEnv.isDebug() 守卫
  （common 新增 AppEnv，用 bundleManager.appInfo.debug 运行时判断，release 自动关闭，
  消除 CLAUDE.md 附录B 红线违反）
- [生命周期] BridgeController 加 dispose() 清回执表/注册表/启动队列；HandlerRegistry 加
  clear()；容器 aboutToDisappear 先 dispose 桥再 dispose adapter 并置空，防残留命中/泄漏
- [事件总线] EventBus.on/once 返回取消函数支持 per-subscriber 精确退订；off→offAll 并
  标注谨慎（避免 M3 多容器订阅 appservice 时误注销他人回调）
- [单测] 加强 escape 断言覆盖内层 " 加倍（命门）；新增 dispose 用例；16 用例全通过，
  桥核心覆盖率 89.0%
- [记录] Index.pageMap param as 运行期不校验，M4 外部 scheme 唤起时需补校验（已注释）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 13:16:37 +08:00
lanterngamescnandClaude Opus 4.8 3e2b1282ba M1: 容器接桥 + V1 阻塞性验证通过（T-M1-05/06/07） 
- BridgeGameContainer 挂 Web + 接桥：onControllerAttached 建桥/注册 handler、
  onLoadIntercept 接桥、onPageEnd 注桥 JS + 补发启动队列、aboutToDisappear 释放
- test_echo.html 最小回显 H5（getTime 往返 + nativeEcho 特殊字符转义往返）
- 修复：dispatch 出站补转义单引号——lzyzsd 原版遗漏，_handleMessageFromNative('...')
  单引号包裹下 data 含 ' 会破坏字符串；补转义对 H5 透明（JSON.parse 仍得原始 data）
- ⚠ V1 真机通过：yy:// 被 onLoadIntercept 捕获、_fetchQueue 经 yy://return 回传、
  双向回执、含 "\/'中文 特殊字符转义往返一致。技术路线成立，无需回退

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:01:35 +08:00
lanterngamescnandClaude Opus 4.8 7fb0c194f7 M0: App 入口与路由壳（T-M0-07） 
框架 §4 路由骨架，Navigation + NavPathStack：
- AppRoutes：路由名(Splash/BridgeGame/GenericWeb)、容器参数类型、前后台事件名
- Index：@Entry 导航宿主，初始进 Splash，navDestination 按名分发
- SplashPage：启动引导壳（weclomeactivity1），replacePathByName 进大厅
- BridgeGameContainer：大厅容器壳（webviewActivity），pushPathByName+onPop 演示
  打开通用网页并接收 101 回传
- GenericWebContainer：通用网页容器壳（openwebActivity1），pop(result) 模拟
  backgameData 带数据返回（§11.2 结果码 101 语义）
- EntryAbility：onForeground/onBackground 经 EventBus 广播应用前后台事件
  （M3 容器订阅后 callHandler('appservice','1'/'2')）
- build 编译通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:44:57 +08:00