daoqi/youle_app_ohos
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
25 Commits 1 Branch 0 Tags
40b8c2e91cc72006cfab23d26c396eb5568e221b
Commit Graph
24 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
lanterngamescn 40b8c2e91c 计划进度：M2 完成、R-02(V2 file:// 跨域)关闭 
- 01_任务分解WBS：M2 标记完成(13 任务)，新增 M2 任务明细块与决策/偏差记录
- 03_风险登记册：R-02 关闭（setPathAllowingUniversalAccess 方案 + 真机复测 OK）
- 框架 §7.3：file:// 跨域改为已验证的具体方案（setPathAllowingUniversalAccess），保留 onInterceptRequest 回退
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:43:18 +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
lanterngamescn d2da223c8d M2(领域层): ConfigManager/VersionResolver/ResourceManager/AppDataInjector/StartupOrchestrator 
T-M2-05 ConfigManager：本地 rawfile/app_config.json(§4.2 实测值)、远程 URL 拼装('-'→'/'+.txt+?a=ts 禁缓存)、
        长度<30 走 showmessage 阻断、二级 url 二次请求(语义待真机校验)、产出版本决策
T-M2-06 VersionResolver：纯函数，agentlist/gamelist 两棵树 + agent→channel→market→game 后层覆盖 +
        两树取更高 version（§4.4）。单测 8 用例全通过，覆盖率 81.8%（≥80%）
T-M2-07 ResourceManager：沙箱路径规范、内置包拷贝解压、version.xml 解析(@ohos.xml)、远程 zip 下载/删旧/解压、版本比较
T-M2-09 AppDataInjector：加载前写 <gameDir>/app_data.js（§6 全局变量同名同义，JSON.stringify 安全字面量）
T-M2-11 StartupOrchestrator：INIT→…→ENTER_HALL 状态机，远程失败降级本地、showmessage 阻断、weburl 空/非空入口规则
配套：module.json5 声明 ohos.permission.INTERNET + reason_internet 字符串

devecocli build 通过；scripts/test.sh 单测全通过（修复 PermissionRequestResult 顶层导入）。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:29:45 +08:00
lanterngamescn ecb0e4642a M2(平台层): KvStore/FileSystem/HttpClient/Downloader/Unzipper/PermissionGuard/LocalUploadServer 
T-M2-01 存储/文件：KvStore(preferences 持久化 urlpath/upurlpath)、FileSystem(fileIo 建删读写/列目录/拷贝内置 rawfile)
T-M2-02 网络/下载：HttpClient(GET 禁缓存，契约 §4.3)、Downloader(http 流式写盘+进度，原生异步不阻塞 UI)
T-M2-03 解压：Unzipper(zlib.decompressFile，原生异步)。偏差：下载/解压用原生异步 API 即满足"UI 不阻塞"，
        独立 TaskScheduler(TaskPool) 推迟到 M5 真有 CPU 密集任务(MD5)时再加，避免投机性死代码。
T-M2-04 权限/上传：PermissionGuard(用时申请，沙箱文件免存储权限)、LocalUploadServer(骨架，本机端口服务 M3 落地)

devecocli build 通过。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:14:41 +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 74b302e131 计划进度：M1 完成、R-18 关闭 
- 01_WBS：M1 ☑ 完成（8 任务全 ☑，V1 通过、桥核心覆盖 87.3%）
- 03_风险登记册：R-18 关闭（探明 hvigorw 本地单测命令，封装 scripts/test.sh）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:27:18 +08:00
lanterngamescnandClaude Opus 4.8 159dcf2687 M1: 桥引擎单测跑通，桥核心覆盖率 87.3%（T-M1-08 完成，R-18 处置） 
- 修复 2 个测试用例（漏先触发 flushMessageQueue 注册 _fetchQueue 回调）
- 补 set_default/remove、FakeWebController、send 用例，共 15 用例全通过
- 桥核心覆盖率 87.3%（MessageCodec/Message 100%、BridgeController 83%、
  HandlerRegistry 88%）≥80% 达标；Adapter/BridgeJsLoader 系统耦合由 V1 真机覆盖
- scripts/test.sh：本地单测 + 覆盖率运行脚本（devecocli 无 test，用 DevEco hvigorw
  + 强制 DEVECO_SDK_HOME 指向自带 sdk）；ci.sh 集成单测（SKIP_TESTS=1 可跳过）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:26:23 +08:00
lanterngamescnandClaude Opus 4.8 38307e8d71 计划进度：M1 核心+V1 通过、单测受阻登记 R-18 
- 01_WBS 进度总览：M1 近完成，T-M1-01~07 全 ☑、V1 真机通过；T-M1-08 单测代码就位待运行
- 03_风险登记册：新增 R-18（单测运行工具链缺口）+ 受阻任务记录 T-M1-08

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:07:49 +08:00
lanterngamescnandClaude Opus 4.8 5587df0562 M1: 桥引擎单测代码（T-M1-08，运行待工具链） 
- entry/src/test/Bridge.test.ets：13 用例覆盖
  MessageCodec(toJson省略/response/escape转义/toArray)、
  HandlerRegistry(put/get/默认兜底不抛错)、
  BridgeController(入站分发+回执/出站callHandler/启动队列补发/
  responseId回执路由/未注册名默认兜底) —— 用 FakeWebController 纯逻辑、不依赖设备
- 接入本地单测入口 List.test.ets
- ⚠ 运行受阻：devecocli 无 test 子命令，本地单测 hvigor task 未常规暴露，
  待定运行方式（DevEco IDE / CI / 其他）后跑覆盖率（目标 ≥80%）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:06:55 +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 206db9730a M1: 桥引擎核心（T-M1-01~04） 
100% 复刻 lzyzsd/JsBridge（对照原 Android com.tagmae.jsbridge 逐字）：
- IWebController + WebviewControllerAdapter(emitter UI 线程守卫,§5.5) + FakeWebController(单测用)
- Message(5字段,undefined省略) + MessageCodec(toJson/toArray + dispatchMessage 两次正则转义逐字复刻)
- HandlerRegistry + 空实现 DefaultHandler 兜底(H5 调用永不报错最后防线)
- BridgeController:onLoadIntercept(decode→yy://return/yy://)/callHandler/send/onPageEnd/
  flushMessageQueue(_fetchQueue 经 yy://return 回传,非 runJavaScript 返回值)/handleReturnData/
  启动队列补发;对能力零感知、纯逻辑可测
- build 编译通过(ArkTS 严格)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:51:11 +08:00
lanterngamescnandClaude Opus 4.8 9280c00809 计划进度更新机制 + 标记 M0 完成 
- CLAUDE.md 工作约定新增「及时更新计划进度」：按 Plan 实施时主动更新
  01_任务分解WBS 任务状态，与代码提交同节奏
- 01_任务分解WBS 新增「进度总览」：M0 全部 7 任务标记完成 ☑，M1~M6 未开始；
  记录 M0 期间确立的项目决策（包名/横屏/验证策略/devecocli 无 test）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:40:24 +08:00
lanterngamescnandClaude Opus 4.8 82459c708c 横屏改为 auto_rotation_landscape：横屏两朝向跟随传感器旋转，不进竖屏 
- module.json5：landscape → auto_rotation_landscape（横屏正/反向 180° 跟随重力
  感应自动旋转，但不进入竖屏），build 校验取值合法、安装启动通过
- 同步契约 §7 与框架 §7.4：'不跟随传感器' 修正为 '横屏两朝向内跟随旋转'
- H5 显式方向控制（含竖屏）仍由 setPreferredOrientation 保留，零改动不变

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:38:05 +08:00
lanterngamescnandClaude Opus 4.8 dbc416a940 entry: EntryAbility 配 orientation:landscape，脚手架默认横屏 
落地横屏项目约束（契约 §7 / 框架 §7.4）：module.json5 配默认横屏、
不随传感器自动旋转；H5 显式方向控制留待 M3 用 setPreferredOrientation 动态实现。
模拟器验证：启动即横屏（2856x1320），SplashPage 布局正常。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:34:34 +08:00
lanterngamescnandClaude Opus 4.8 3a333bfe32 docs: 补充横屏项目约束（默认横屏、不支持竖屏自动旋转） 
- 契约规范 §7：新增屏幕方向约束——默认横屏、不跟随传感器自动旋转；
  但遵守 H5 零改动铁律，保留 orientation/SwitchOverGameData webtype/通用网页
  orientation 三处 H5 显式方向控制（含竖屏），与原 Android 一致
- 框架指南 §7.4：实现落地——module.json5 orientation:landscape 默认横屏 +
  运行时 window.setPreferredOrientation 按 H5 请求动态切换
- 经核对原 Android：上述三处确为真实竖屏切换（非死代码），故定调为
  '默认横屏 + 不破坏 H5 方向控制'

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:26:40 +08:00
lanterngamescnandClaude Opus 4.8 300f6d9b80 更改应用包名 com.example.gamelobby → com.lobby.daoqi 
- AppScope/app.json5 bundleName 更新
- build 通过，产物 pack.info bundleName 已生效
- 注：代码无硬编码包名；原 DevEco 默认签名材料(default_gamelobby_*)按旧包名生成，
  日后配真机/自动签名需重新生成

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:15:04 +08:00
lanterngamescnandClaude Opus 4.8 dca926df5b M0: 构建/签名/CI（T-M0-03） 
- 构建：build-profile 已有 debug/release buildMode，多模块 build 通过
- 签名：本期暂不配（模拟器调试已验证可装可跑）；真机/release 时由 DevEco
  自动签名写入 build-profile.signingConfigs
- CI：scripts/ci.sh 平台无关校验脚本（devecocli build debug/release），任何 CI 可调；
  单测运行待 M1 桥引擎单测落地后启用（devecocli 当前无 test 子命令）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:05:18 +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
lanterngamescnandClaude Opus 4.8 f89275ea4b M0: 引入桥 JS（T-M0-06） 
- WebViewJavascriptBridge.js 原样复刻到 feature_bridge/src/main/resources/rawfile
  （与原 Android assets 去尾随空白后逐字一致，lzyzsd 协议 100% 复刻）
- BridgeJsLoader：从 rawfile 读取桥 JS（getRawFileContentSync + TextDecoder）并缓存，
  供 M1 BridgeController 在 onPageEnd 注入；HarmonyOS 走 runJavaScript 无需去注释
- 经 build smoke 验证 rawfile 读取 API 签名与编译通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:41:11 +08:00
lanterngamescnandClaude Opus 4.8 f7f208e6c8 M0: common 公共设施（T-M0-05） 
框架 §10 横切层：
- Logger：基于 HiLog 的分级日志（d/i/w/e/f），业务域 0x9527，tag 截断 31B
- BridgeTracer：桥消息 traceId 自增 + 阶段打点，可还原全链路
- EventBus：封装 @ohos.events.emitter（on/once/emit/off，string eventId）
- DIContainer：轻量 DI，支持单例/懒单例工厂注册与泛型解析
- ErrorCenter：异常收敛 + 处置策略（Notify/Silent/Report/Block），UI 处置经 sink 注入
- 经 entry 临时 smoke 验证编译通过（含 common→contracts 跨 HAR 引用）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:12:44 +08:00
lanterngamescnandClaude Opus 4.8 26299c06ce M0: contracts 契约类型 SSOT（T-M0-04） 
落地《契约规范》§8/§9/§12，全工程唯一来源：
- InboundHandlers 枚举：45 入站 handler 名，原样拼写（finsh/canclevibrator/opensaoma 等）
- OutboundHandlers 枚举：21 出站 handler 名，含命名陷阱（getphoneinfo≠getphoneInfo、
  getBattery≠getbattery、backgameData-末尾连字符）
- PayloadType：入站/出站 raw|json 标注表 + 入站同步返回类型 + 查询函数
- DTO interface ×17（§12 字段同名同义）：Sharetype/Maplocation/PhoneInfo/savephoto/
  videoinfo/Othervideoinfo/GamePay/PayState/ShareLogin/ShareSuccess 等
- Result<T> + Errors（ErrorKind/LocationErrorCode/AppError）
- 经 entry 临时 smoke 全量引用，CompileArkTS 编译通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:09:17 +08:00
lanterngamescnandClaude Opus 4.8 424c5f4d94 M0: 忽略 hvigor 生成物 BuildProfile.ets（保持仓库干净） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 06:59:12 +08:00
lanterngamescnandClaude Opus 4.8 6de9038a54 M0: 搭建多模块工程骨架（T-M0-01/T-M0-02） 
- 在 entry 基础上新增 6 个 HAR：contracts/common/platform/domain_resource/feature_bridge/feature_capabilities（框架§4 工程结构）
- 依赖单向向下、无环、无传递依赖（T-M0-02）：
  contracts←common←platform←domain_resource；feature_bridge←(contracts,common)；
  feature_capabilities←(全部下层)；entry←(全部下层)
- 各 HAR 含 build-profile/hvigorfile(harTasks)/module.json5(type:har)/Index.ets 导出入口
- devecocli build(debug) 全模块编译通过，entry 打包 HAP 成功

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