页面、路由与分包
修改入口
src/pages.json 定义主包、分包与页面样式;src/utils/routes.js 定义业务路由键、页面路径、tab 类型及守卫;src/utils/navigation.js 提供导航封装。三者职责不同,新增页面不能只修改其中一个。
新增页面步骤
- 在对应业务分包创建页面,复用已有页面壳、页头、加载与错误组件。
- 在
pages.json的正确分包登记路径,遵循已有深色背景和导航方式。 - 在路由注册表登记需要统一导航的 routeKey、路径和守卫;只读与写入入口分别判断权限。
- 使用
openRoute或openPage等已有封装,不在组件中重复实现登录跳转。 - 对 query 读取真实 ID,参数缺失时展示明确错误,避免展示其他记录。
- 构建小程序并检查包体及分包共享依赖,再验证返回和页签保持。
分享与兼容
分享链接只携带允许公开的定位信息,不携带令牌或私有播放 URL。改动已有 query 时核对旧接收入口、朋友圈和名片落地,必要时在已有解析器中保持明确兼容。
测试至少覆盖直接进入、登录返回、参数缺失、异主访问、返回上一页与重新进入。H5 正常不代表小程序分包和组件别名已经正确。