Files
persionalBrand/docs/miniapp-ui.md
T

34 lines
1.5 KiB
Markdown

# 小程序 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 执行:
```js
wx.setStorageSync("apiBaseUrl", "http://新的局域网IP:3001");
```
然后重新编译小程序。恢复默认地址可执行:
```js
wx.removeStorageSync("apiBaseUrl");
```
真机调试时,手机和电脑必须处于同一局域网,API 进程需监听可被局域网访问的地址,且防火墙允许 `3001` 端口。