跨端构建与发布流程
跨端项目的复杂度不只在前端代码,更在「同一份代码如何稳定地产出多个平台包」。
构建目标
常见目标:
| 平台 | 产物 | 发布方式 |
|---|---|---|
| H5 | 静态资源 | 静态托管 / CDN |
| 微信小程序 | 小程序包 | 微信公众平台上传 |
| App | 安装包 | 应用商店 / 分发平台 |
环境区分
用环境变量区分开发、测试与生产:
.env.development
.env.staging
.env.production
构建时注入接口地址、统计开关与渠道标识,避免在代码里写死域名。
小程序构建要点
- 分包配置:主包只保留首屏必需页面
- 域名白名单:请求、上传、下载域名提前配置
- 隐私协议:收集用户信息前完成声明
- 版本号:每次上传递增,便于回滚与灰度
- 体积检查:关注主包与分包大小限制
App 构建要点
- 图标、启动图、权限声明在打包配置中统一维护
- 原生插件需要提前确认各平台兼容性
- 签名证书与描述文件妥善保管
- 真机测试覆盖低端机与不同系统版本
H5 构建要点
- 路由使用 history 模式时需要服务端回退到
index.html - 静态资源使用内容哈希并开启长缓存
- HTML 不缓存,保证发布后立即生效
- 配置 gzip / brotli 压缩
- 首屏资源预加载,非首屏路由懒加载
发布流程建议
# 1. 安装依赖
pnpm install --frozen-lockfile
# 2. 类型检查与测试
pnpm typecheck
pnpm test
# 3. 构建
pnpm build
# 4. 上传 / 部署
pnpm deploy
把上述步骤固化到 CI 中,减少人工操作带来的不确定性。
回滚与灰度
- 每次发布保留可回溯的版本号
- 静态资源保留旧版本一段时间
- 小程序使用灰度发布,先小比例验证
- App 发布前准备好回滚方案
检查清单
- 环境变量是否正确注入
- 接口域名是否已加入白名单
- 包体积是否在平台限制内
- 首屏加载与弱网表现是否可接受
- 版本号与发布说明是否完整
- 回滚路径是否可用