feat: 新增 Taro 模板双端运行与独立 Web 预览
This commit is contained in:
1 parent
f4061a24bd
commit
7e8fc01fba
48 files changed
+11576
-12
No files matched your search
@@ -0,0 +1,23 @@
|
||||
# 0019 Taro 模板双端运行时
|
||||
|
||||
## Context
|
||||
|
||||
原生 WXML/WXSS 难以在浏览器预览,自建转换器需要重复实现组件、事件和 API。客户提供的 React 原型应通过统一页面源码输出 Web 与微信小程序。
|
||||
|
||||
## Decision
|
||||
|
||||
新增 apps/taro,使用固定版本 Taro 4.3、React 18 与 Vite 4 编译器,支持 H5 和 weapp。React 18 是 Taro 当前官方插件 peer contract,独立于 Admin React 19。复用 Public Workspace 类型和模板 package manifest、图片与视觉槽位,不建立第二套后台或数据库,不维护手写 WXML 解释器。
|
||||
|
||||
页面实现按模板放入 package/taro,通用请求、登录、表单和记录在 apps/taro 中。模板选项在构建时校验,manifest 驱动 tab 名称和路由。H5 仅访问已发布数据;微信登录使用 Taro.login,H5 无微信身份时明确不能提交,不创建假用户或模拟成功。API 地址和品牌来自构建环境,允许 H5 以查询参数选择品牌,令牌按品牌隔离。
|
||||
|
||||
## Alternatives
|
||||
|
||||
kbone 适合 Web 运行于小程序,但引入 DOM 适配成本;uni-app 需要 Vue 重写现有 React 原型;自建模拟器持续承担不必要的兼容责任。
|
||||
|
||||
## Consequences
|
||||
|
||||
一次迁移页面和构建链路,后续同一份 React/CSS 输出两端。原生微信能力和排版仍需微信环境验收,H5 不被称作原生模拟器。TDesign 原生组件不直接用于 H5,基础表单改用 Taro 双端组件。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
在 feat/taro-template-preview 和独立 worktree 完成两模板全部页面及双端构建,旧原生模板和编译器继续可用。用户确认前不切换当前分支、不替换当前 API、不改数据库、不覆盖旧 dist 产物。迁移分支以独立 preview 端口提供验收。确认后再决定默认构建切换,旧实现作为回滚基线。
|
||||
@@ -0,0 +1,31 @@
|
||||
# Taro 迁移分支验收
|
||||
|
||||
分支:`feat/taro-template-preview`。基线:`f4061a2`。主工作区保持 `feat/template-runtime-platform`,用户确认前不合并或切换。
|
||||
|
||||
## 已交付
|
||||
|
||||
- Taro 4.3 + React 18 共用 React/CSS 构建 Web 和微信小程序;Admin 的 React 19 独立保留。
|
||||
- 餐饮:首页、餐品分类搜索、详情、出摊、主理人、咨询、成功、记录。视觉综合原 React 原型和当前小程序,数据使用同一份已发布 Public Workspace。
|
||||
- 林境:首页、作品列表/详情、主理人、咨询、成功、记录。
|
||||
- 模板自动发现 package 的 manifest 与 taro 实现,不新增全局 seed,不修改数据库。
|
||||
- 真实表单选择、条件字段、选项 label/value、checkbox、必填校验、失败保留输入、微信登录、品牌隔离、401 清理及历史字段快照显示。
|
||||
- 独立 H5 预览端口:餐饮 http://localhost:3002,林境 http://localhost:3003。
|
||||
|
||||
## 验证
|
||||
|
||||
- 两模板 H5/weapp 共 4 个 production build 通过,weapp 包含工程配置、页面与共用样式。
|
||||
- Playwright 5/5:真实 API、图片容器宽度、日程/配送/流程槽位、主理人资质/案例/承诺、餐品搜索与详情到咨询、失败保留输入、错误重试、林境路由。
|
||||
- 纯函数与产物契约 4/4;API integration 39/39 使用独立 schema;旧原生模板完整检查通过。
|
||||
- 全量 typecheck 10/10、lint 8/8、格式检查、Admin production build 通过。
|
||||
|
||||
运行命令和输出路径见 [Taro README](../apps/taro/README.md)。预览是 Taro 的真实 H5 构建,不使用 WXML 转 HTML 脚本。
|
||||
|
||||
## 验证边界
|
||||
|
||||
Web 未接入微信身份登录,没有已有会话时仅支持填写与校验,明确提示在微信小程序提交,不伪造成功。默认小程序 AppID 为 touristappid,正式登录需配置实际 AppID 和合法域名。未取得本机微信 IDE 原生截图,不能把 H5 验收称为真机或像素一致验收。
|
||||
|
||||
现有远程图片继续使用后台实际 URL;远端不可用时不会替换成虚构素材。Taro 官方依赖的 deprecation/punycode 提示由框架维护者后续升级跟进;Admin 既有 676 kB chunk 提示由前端维护者跟进拆包。当前构建与测试通过。
|
||||
|
||||
## 切换
|
||||
|
||||
先由用户浏览新分支预览并确认,之后才切换主工作区或合并。旧 `template:dev` 和原生产配置继续作为回滚基线。
|
||||
Reference in new issue
Block a user