Files
persionalBrand/docs/miniapp-ui.md

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 端口。