Winjs Hybrid

完整配置见 详细用法参考 或 官方文档。

应用入口（src/app.js）

Hybrid 特有钩子：

• render(oldRender): ⚠️ 原生环境中先执行 gmuJSAPI.nativeReady({ complete() { oldRender(); } })，等待原生就绪；非原生环境直接 oldRender()
• onRouterCreated({ router }): 注册路由守卫，可通过 gmuJSAPI.navigateTo 实现容器内跳转
• request: 配置 request 插件，对接 services/request.js
• onAppCreated / onMounted: 通用钩子，可访问 window.LightSDK

原生桥接说明：

• GmuJSAPI: 鸿蒙/券商桥接（nativeReady、isAppOS、navigateTo）
• Light SDK: 挂载到 window.LightSDK，按需使用

详见 详细用法参考。

目录结构（src）

• layouts/index.vue: 全局布局
• pages/: 约定式路由
• assets/: fonts、img、style（variable.less、app.less、main.less）
• services/: 请求封装（request.js、autoMatchBaseUrl.js、constant.js、RESTFULURL.js）
• constant.js: 根级常量
• global.less: 全局样式

常用命令

快速排错

常见问题：

• 页面不渲染/白屏: 检查 render(oldRender) 是否正确调用 nativeReady 的 complete 回调
• 原生 API 报错: 确认调用前已执行 nativeReady 或宿主已注入桥接
• 路由跳转异常: 检查 gmuJSAPI.isAppOS() 与 navigateTo 参数是否符合宿主约定
• 请求 base URL 错误: 检查 appConfig 配置与 autoMatchBaseUrl 映射
• VConsole 不显示: 确认 IS_OPEN_VCONSOLE: true 且 wconsole 插件已启用
• useAppData/getRoute 报错: 仅在组件生命周期中调用

详见 常见问题与排错。

参考文档

本技能随模板下发，可独立使用：

• Hybrid 模板速查 — 配置、app.js、GmuJSAPI、navigateTo、离线包速查
• 详细用法参考 — 配置、钩子、路由、环境变量、CLI 等
• 常见问题与排错 — AppContext、守卫、preview 404 等排错
• 官方文档索引 — 快速定位官方文档主题

在线资源：

• WinJS 官方文档
• Request 插件 | wconsole 插件 | REM 配置
• 项目 README.md — 混合应用特性、鸿蒙/Light SDK 说明