VextJS
  • 简体中文

      • 构建与发布

      vext build 会在一个命令中编译服务端产物和前端产物。

      输出

      启用 frontend 后，生产输出包含：

      dist/
  server/
  client/
    index.html
    manifest.json
    render-manifest.json
    deploy-manifest.json
    size-report.json
    assets/

      vext start 会服务已构建的 client assets，并使用 render-manifest.json 做 SSR。

      构建命令

      vext build

      构建后上传静态资源：

      vext build --upload-assets

      或单独执行上传：

      vext deploy assets --dry-run
vext deploy assets

      Deploy Manifest

      deploy-manifest.json 记录可上传静态资源：

      • JS 和 CSS assets
      • import 的图片、字体、媒体文件
      • 复制过来的 public/** 文件
      • content type
      • sha256
      • 可用资源的 SRI
      • upload key 和 public URL

      HTML 默认不上传，因为 SSR 仍属于服务端 runtime。

      增量上传

      上传 state file 会记录已知 sha256。未变化的资源会跳过，因此图片和字体不会每次发布都重新上传。

      stateFile 应放在 frontend outDir 外，因为 build 输出通常会清理。

      配置

      frontend: {
  deploy: {
    assetBaseUrl: "https://cdn.example.com/my-app/",
    integrity: true,
    upload: {
      enabled: true,
      adapter: "filesystem",
      targetDir: ".vext/frontend-cdn",
      publicBaseUrl: "https://cdn.example.com/my-app/",
      prefix: "my-app",
      stateFile: ".vext/deploy/frontend-assets-state.json",
      exclude: ["**/*.map"],
    },
  },
}