5.8 KiB
5.8 KiB
taroapp_escort 迁移清单(对照 phase1-native-baseline)
原生基线:
ui/wxapp_escort@aeafe21(标签phase1-native-baseline)。 每页三项:WXML→TSX、JS→TS、WXSS→SCSS(rpx数值直搬,规则见doc/taro-plan.md§6 / D6)。
1. 页面
| # | 原生路径 | Taro 文件 | 状态 | 差异 / 备注 |
|---|---|---|---|---|
| 1 | pages/home/index | src/pages/home/index.tsx |
✅ 完成 | 原 navigationStyle: custom 改为默认导航(计划 §9.2),.topbar 上距 120→24rpx |
| 2 | pages/escort/itemlist | src/pages/escort/itemlist.tsx |
✅ 完成 | — |
| 3 | pages/escort/itemdetail | src/pages/escort/itemdetail.tsx |
✅ 完成 | 下单表单/弹窗全量迁移;未用的 departments 常量已删 |
| 4 | pages/health/profilelist | src/pages/health/profilelist.tsx |
✅ 完成 | 下拉刷新 / 双击删除确认保留 |
| 5 | pages/health/profileedit | src/pages/health/profileedit.tsx |
✅ 完成 | 未保存拦截:微信原生;其他端降级为页内提示 |
| 6 | pages/mine/mine | src/pages/mine/mine.tsx |
✅ 完成 | 默认导航,.header-card 上距 176→32rpx;登录按平台分支(见 §3) |
| 7 | pages/mine/profileedit | src/pages/mine/profileedit.tsx |
✅ 完成 | 同上未保存拦截降级 |
| 8 | pages/mine/about | src/pages/mine/about.tsx |
✅ 完成 | — |
| 9 | pages/mine/contact | src/pages/mine/contact.tsx |
✅ 完成 | showMenuByLongpress 保留 |
| 10 | pages/mine/business | src/pages/mine/business.tsx |
✅ 完成 | ?section= 锚点定位用 pageScrollTo({selector}) |
| 11 | pages/escort/recordlist | src/pages/escort/recordlist.tsx |
✅ 完成 | 左右滑动切档 + 下拉刷新 + 触底加载保留 |
| 12 | pages/escort/recorddetail | src/pages/escort/recorddetail.tsx |
✅ 完成 | 三个弹窗(医院/备注/取消)全量迁移 |
| 13 | pages/escort/agreement | src/pages/escort/agreement.tsx |
✅ 完成 | 协议数据仍由 GET /health/agreement 下发 |
| 14 | pages/escort/guide | src/pages/escort/guide.tsx |
✅ 完成 | 静态文案与原生逐字一致 |
| 15 | pages/ai/aichat | src/pages/ai/aichat.tsx |
✅ 完成 | TDesign chat-markdown 换自研 Markdown;socket 契约 §6.4 未变 |
未迁移:原生 pages/attendant/ 为空遗留目录(计划 §7)。
2. 底座
| 原生 | Taro | 说明 |
|---|---|---|
app.js |
src/app.tsx + src/utils/app.ts |
onLaunch/onShow → useLaunch/useDidShow;globalData 变为模块单例(utils/globalData.ts),字段名不变 |
app.json |
src/app.config.ts |
页面清单一致;tabBar 微信 custom: true(页内自绘),抖音/支付宝走原生 tabBar |
app.wxss |
src/app.scss |
色板令牌整块搬入,page, body 双端可读 |
custom-tab-bar/* |
src/components/TabBar |
样式逐字搬入,选中态由页面传 selected |
utils/request.js |
src/utils/request.ts |
基址 / appId: 'wxapp-escort' / 401 重试契约不变 |
utils/api.js |
src/utils/api.ts |
路径逐条一致 |
utils/chatmsg.js |
src/utils/chatmsg.ts |
心跳 30s / 重连 3 次 / 解析失败回调不变 |
| `utils/date | order | privacy |
| — | src/utils/platform.ts |
新增:平台判断、登录开关、登录未开放提示、TabBar 开关 |
TDesign t-icon |
src/components/Icon |
用 assets/fonts/t.woff base64 内嵌 + 按名映射字形(29 个) |
TDesign t-loading |
src/components/Loading |
纯 CSS 转圈 |
TDesign t-chat-markdown |
src/components/Markdown |
自研轻量解析:标题/段落/列表/代码块/引用/表格/分隔线/加粗/行内码 |
images/* |
src/images/* |
project config copy 拷到产物根,页面沿用 /images/x.png |
3. 平台差异与未决项
| 能力 | 微信 weapp |
抖音 tt |
支付宝 alipay(构建目标预留) |
|---|---|---|---|
| 构建 | ✅ 验证通过 | ✅ 验证通过 | ⚪ 仅编译,未真机验证 |
| 登录 / 手机号 | ✅ 原生流程 | ⛔ 占位(B1/B2 未就绪) | ⛔ 占位 |
| 自定义 tabBar | ✅ 页内自绘(custom: true) |
原生 tabBar(D4 降级,待真机复核) | 原生 tabBar |
| 未保存拦截 | ✅ enableAlertBeforeUnload |
能力探测,缺失则页内提示 | 同抖音 |
| 更新管理器 | ✅ | 能力探测,缺失则跳过 | 同抖音 |
| 分享 | useShareAppMessage |
由平台决定是否支持 | 同抖音 |
阻塞项(未解决前对应功能不可用):doc/taro-plan.md §9.1 B1–B5。
支付仍为线下客服流程,无线上支付入口(与原生一致)。
4. 后续平台(不在本次交付)
- 支付宝 IoT 小程序:与普通
alipay不是同一容器,API / 白名单需按 IoT 文档单独适配,未验证前不宣称支持。 - Android / iOS 原生 App:本仓 Taro 产物是小程序包,不能直接产出原生 App;需另起 Taro RN 工程或原生团队开发。
5. 双端构建命令
npm run build:weapp # → dist/weapp
npm run build:tt # → dist/tt
npm run build:h5 # → dist/h5(仅本地预览用)
6. 验证记录
| 项 | 结果 | 说明 |
|---|---|---|
npx tsc --noEmit |
✅ 0 error | tsconfig 开启 skipLibCheck(Taro 自带 d.ts 在严格模式下自身报错,与本项目代码无关) |
taro build --type weapp |
✅ 编译通过 | 产物 dist/weapp;images/ 10 张齐全;app-origin.wxss 含内嵌字体 |
taro build --type tt |
✅ 编译通过 | 产物 dist/tt;tabBar.custom=false(原生 tabBar) |
taro build --type h5 |
✅ 编译通过 | 用于本地预览,不作为交付产物 |
| 微信真机 / 抖音真机 | 未验证 | 需先配 B3 域名白名单与 B4 上传 Token |