1.5 KiB
1.5 KiB
小程序 UI 基础层
小程序使用 tdesign-miniprogram 提供成熟的交互控件,再由 apps/miniapp/components/ui/ 提供品牌层封装。行业模板只负责内容和字段配置,不直接依赖 TDesign 组件名。
首次预览
在微信开发者工具中打开 apps/miniapp 后执行「工具 → 构建 npm」。构建完成后,工具会生成被 .gitignore 忽略的 miniprogram_npm/ 目录,页面即可解析 tdesign-miniprogram/* 组件路径。
依赖升级后需要重新执行一次「构建 npm」。CI 或发布流程也必须先完成该步骤,再上传小程序代码。
组件边界
BrandButton、BrandField、BrandEmpty、BrandLoading:稳定的品牌交互契约,页面只依赖这些封装。tdesign-miniprogram:输入、按钮、弹层、加载等基础行为和无障碍细节。- 页面和行业模板:只消费统一字段与状态,不出现
templateKey === "food"一类分支。
品牌颜色、圆角和间距统一维护在 apps/miniapp/styles/tokens.wxss。
本地 API 地址
开发环境 API 地址默认配置在 apps/miniapp/app.js。换网络后可以直接在开发者工具 Console 执行:
wx.setStorageSync("apiBaseUrl", "http://新的局域网IP:3001");
然后重新编译小程序。恢复默认地址可执行:
wx.removeStorageSync("apiBaseUrl");
真机调试时,手机和电脑必须处于同一局域网,API 进程需监听可被局域网访问的地址,且防火墙允许 3001 端口。