# 换书台 · 小程序代码骨架 配套的设计预览在仓库根目录 `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`),这里没写