# 换书台 · 小程序代码骨架
配套的设计预览在仓库根目录 `miniapp.html`。这里是**真实的小程序源码**,不是示意图。
## 验证状态(先说清楚)
- 这些文件**没有在微信开发者工具里跑过** —— 本机没有该环境。
它们是照着微信官方文档的 API 写的,语法与调用方式按文档核对过;
**但「能编译、能真机跑」这件事我没有实测过**,请以你在开发者工具里的打开结果为准。
- 浏览器里的 `miniapp.html` 是**设计预览**,用来把小程序特有的约束讲清楚,不是运行时。
## 目录
```
miniapp/
├─ app.json 页面 + 分包 + tabBar + 自定义导航
├─ app.js onLaunch/onShow/onHide + 胶囊几何测量
├─ app.wxss 全局底材(发丝线、触控目标、单行省略)
├─ sitemap.json / project.config.json
├─ components/
│ └─ book-card/ 自定义组件(wxml/wxss/js/json)
├─ pages/
│ ├─ index/ 首页:Hook + 附近的想要者
│ ├─ shelf/ 书架:分组 + 在架
│ └─ me/ 我:授权登录 + 小程序码 + 云调用
├─ subpackages/
│ ├─ exchange/pages/list/ 交换分包 · 列表
│ ├─ exchange/pages/detail/ 交换分包 · 详情
│ └─ message/pages/list/ 消息分包
└─ cloudfunctions/
├─ nearbyPoints/ 附近书点(geoNear)+ 本周成交数
└─ startExchange/ 发起交换(幂等 + 在架校验 + 24h 过期)
```
`app.json` 里引用的 6 个页面文件齐全,主包源码约 19 KB(不含组件与图片;微信上限 2 MB)。
## 这骨架里刻意做对的几件事
**分包**:`app.json` 里主包只放首页 / 书架 / 我(首页相关),
交换与消息各自成包。主包体积要压在 2MB 以内,超了直接审核不通过。
`preloadRule` 让首页在 Wi-Fi 下预下载交换分包,用户点进去时已经好了。
**页面栈**:卡片的点击走 `navigateTo`(保留返回路径);
深层流程(交换确认到发货)要靠 `redirectTo` 或 `reLaunch` 换掉当前页,
不能一路 navigateTo 叠到第 11 层。
**生命周期**:请求放 `onLoad` 只跑一次;`onShow` 只做轻量计数刷新,
不重拉列表 —— 否则每次从别的 tab 切回来都会重排,滚动位置也丢。
`onHide` 和 `onUnload` 里清定时器。
**自定义导航栏**:`app.js` 的 `measureChrome()` 用
`wx.getMenuButtonBoundingClientRect()` 读胶囊真实坐标,
标题宽度由 `cap.left - 16 - 8` 算出来,**没有任何写死的像素值**。
写死 `right: 90px` 会在安卓上少留 20 多像素,标题顶到胶囊底下。
**自定义组件**:`book-card` 只做显示,数据从 `properties` 进,
点击从 `triggerEvent` 出,组件不自己改数据、不读全局变量。
组件样式默认隔离,所以页面别指望用全局类名改组件内部。
**订阅消息**:`wx.requestSubscribeMessage` 写在用户点「发起交换」的确认回调里,
由点击触发。进页面就弹订阅是拿不到授权的。
**云开发**:`nearbyPoints` 用 `_.geoNear` 做地理查询,
拿不到定位时**退化成按小区返回并带上 `degraded: true`**,不是直接报错。
## 待补
- `/assets/miniapp-code.png` 小程序码图片是占位引用,真码要在微信后台生成
- `app.json` 里的 `tmplIds`(订阅消息模板 id)与云开发环境 id 都是占位,要换成你自己的
- 没有单测,没有真机性能面板数据,没有体验评分
- 24 小时过期取消需要配一条定时触发器(`config.json` 里加 `triggers`),这里没写