跨端构建与发布流程

跨端项目的复杂度不只在前端代码,更在「同一份代码如何稳定地产出多个平台包」。

构建目标

常见目标:

平台 产物 发布方式
H5 静态资源 静态托管 / CDN
微信小程序 小程序包 微信公众平台上传
App 安装包 应用商店 / 分发平台

环境区分

用环境变量区分开发、测试与生产:

.env.development
.env.staging
.env.production

构建时注入接口地址、统计开关与渠道标识,避免在代码里写死域名。

小程序构建要点

  1. 分包配置:主包只保留首屏必需页面
  2. 域名白名单:请求、上传、下载域名提前配置
  3. 隐私协议:收集用户信息前完成声明
  4. 版本号:每次上传递增,便于回滚与灰度
  5. 体积检查:关注主包与分包大小限制

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 发布前准备好回滚方案

检查清单

  1. 环境变量是否正确注入
  2. 接口域名是否已加入白名单
  3. 包体积是否在平台限制内
  4. 首屏加载与弱网表现是否可接受
  5. 版本号与发布说明是否完整
  6. 回滚路径是否可用