Web 图形与 3D / 系统课时

部署 HTTPS 并验收粒子场景

部署 HTTPS 并验收粒子场景

把本地 WebGPU 粒子演示发布为可访问的 HTTPS 页面,并按固定步骤验收首屏显示、视口缩放、交互、帧率与 GPU 资源回收。最终应留下正式访问地址和可复测的通过记录,而不只是“本机能跑”。

学习目标

  • 将 Vite 粒子项目构建为静态文件并发布到 HTTPS。
  • 用浏览器开发者工具检查 WebGPU 初始化、窗口变化和交互反馈。
  • 制定帧率基线,确认场景卸载后停止提交绘制并释放 GPU 资源。

构建并发布 HTTPS

以下以已有的 Vite + WebGPU 粒子项目为例:项目根目录应有 package.json、package-lock.json、index.html,且 scripts.build 运行 vite build。在 Node.js LTS 环境中进入项目根目录执行:

bash
# 按锁文件安装,避免部署时依赖版本漂移
npm ci
npm run build
# 校验构建入口确实存在
node -e "const fs=require('node:fs'); if(!fs.existsSync('dist/index.html')) process.exit(1); console.log('dist ready')"

预期输出(只展示最后一条检查命令的结果;构建日志随版本变化):

text
dist ready

默认产物在 dist/;如项目设置了 Vite 的 build.outDir,应使用对应目录。先执行 npm run preview 并打开 http://localhost:4173/ 检查生产构建可正常显示;它只用于本地预览,不能作为公网生产服务器。

这里选择 Cloudflare Pages 的直接上传方式。先准备 Cloudflare 账号,首次运行 login 会打开浏览器授权;将示例项目名改为自己账号中可用的名称:

bash
# 首次需要在浏览器完成 Cloudflare 授权
npx wrangler login
npx wrangler pages project create your-webgpu-particles --production-branch main
npx wrangler pages deploy dist --project-name your-webgpu-particles --branch main

预期结果(命令行会给出实际 HTTPS 地址,这里用占位符表示):

text
<DEPLOYMENT_URL>

用部署返回的真实地址替换 <DEPLOYMENT_URL>。已有 Pages 项目时跳过 project create,直接部署。上传的是 dist 内容,不是项目源码目录;不要把 API 密钥打包进前端代码。

检查首次加载与设备能力

在正式 HTTPS 地址打开无痕窗口,按 F12 打开开发者工具。在 Network 中勾选 Disable cache,刷新 3 次,确认 HTML、JavaScript 和 WGSL/纹理等资源请求(如有)成功,不存在 404 或混合内容阻止;粒子应能在约定的首屏时限内出现。示例验收线为普通桌面设备、稳定网络下首次可见不超过 5 秒,项目可根据资源体积调整。

在 Console 运行独立的能力探测脚本:

js
(async () => {
  // HTTPS 安全上下文与 WebGPU 能力要分别判断
  const secure = window.isSecureContext;
  const api = Boolean(navigator.gpu);
  let adapter = null;
  let device = null;
  try {
    if (api) adapter = await navigator.gpu.requestAdapter();
    if (adapter) device = await adapter.requestDevice();
  } catch (error) {
    console.error(error);
  }
  console.table({ secure, api, adapter: Boolean(adapter), device: Boolean(device) });
  // 此设备仅供探测;不销毁场景自己创建的设备
  device?.destroy();
})();

预期输出(支持 WebGPU 且设备申请成功时,表格各项均为 true):

text
secure   true
api      true
adapter  true
device   true

这只证明当前环境可以申请设备,还需确认场景实际渲染、Console 无 GPUValidationError、着色器错误或未捕获异常。navigator.gpu 缺失、Adapter 为 null 时,应展示“不支持 WebGPU”的可见提示,而不是停留在黑屏;部分浏览器或驱动即使在 HTTPS 下也可能不支持。

验证视口缩放与交互

保持粒子运行,依次将视口调整为桌面 1280×720 和手机模拟 390×844,再把浏览器缩放设为 125%。检查 Canvas 是否完整覆盖目标区域、粒子比例是否拉伸、指针作用点是否和光标重合。

检查点 操作 通过标准
像素尺寸 观察 CSS 宽高与 canvas.width/height 物理像素约等于 CSS 像素乘 devicePixelRatio,并受设备纹理尺寸上限约束
调整视口 连续拖动窗口边缘 10 次 无黑边、裁剪错位、闪烁或 GPU 校验错误
输入反馈 按实际演示提供的指针吸引、拖拽或点击交互操作 20 次 粒子随输入变化,坐标不偏移;停止输入后不会持续触发额外操作

例如 Canvas 的 CSS 大小为 800×450、devicePixelRatio=2 时,像素缓冲通常应为 1600×900。实现层应在 ResizeObserver 或尺寸变化检测中更新 Canvas 像素尺寸,并销毁、重建随尺寸变化的自建离屏纹理;不应每次缩放都重新申请 GPUDevice。如果交互偏移,优先检查指针坐标是否减去 getBoundingClientRect() 的左上角偏移。

采样帧率并定位卡顿

在保持标签页前台、粒子数量和设备固定的前提下,打开 Console 运行 10 秒的 requestAnimationFrame 调度采样:

js
(async () => {
  // 保持页面前台,否则 rAF 可能被浏览器节流
  const durationMs = 10000;
  const start = performance.now();
  let count = 0;
  await new Promise((resolve) => {
    function tick(now) {
      count++;
      if (now - start < durationMs) requestAnimationFrame(tick);
      else resolve();
    }
    requestAnimationFrame(tick);
  });
  // 测得的是页面 rAF 调度速率,并非精确 GPU 执行帧率
  console.log(`rAF FPS: ${(count * 1000 / (performance.now() - start)).toFixed(1)}`);
})();

预期输出(数值因硬件、刷新率及页面负载而不同):

text
rAF FPS: <FPS>

先预热 10 秒,再测 3 次。可以将“60Hz 桌面屏、20,000 粒子、10 秒平均 rAF 不低于 55 FPS”作为本次演示的示例门槛,而不是跨设备通用标准。即使 rAF 达标,也要确认粒子确实持续更新;使用 DevTools 的 Performance 录制检查长任务、连续卡帧和实际渲染活动。若 Resize 后明显变慢,先检查是否重复创建纹理、Bind Group 或动画循环。

核对 GPU 资源释放

页面关闭时浏览器会回收资源,但单页应用切换路由、卸载粒子组件时不能依赖关闭页面。验收时应检查以下卸载顺序:

  1. 设置停止标志并 cancelAnimationFrame(rafId),避免新的计算与绘制命令提交。
  2. resizeObserver.disconnect(),移除 pointermove 等事件监听和计时器。
  3. 对场景拥有的粒子 GPUBuffer、Ping-Pong 缓冲和离屏 GPUTexture 调用各自的 destroy();不直接销毁 getCurrentTexture() 得到的 Canvas 当前纹理。
  4. 完整卸载 Canvas 渲染器时调用 context.unconfigure();仅当设备没有被其他场景共享时调用 device.destroy()。如果之后重新进入场景,需要重新申请设备。

WebGPU 粒子场景初始化、缩放与卸载的资源生命周期

在演示中反复进入和退出场景 10 次,确认退出后没有新的绘制提交,也没有重复事件回调或 GPU 校验错误;结合浏览器任务管理器观察 GPU 相关内存趋势,注意驱动缓存会造成波动,单看 JS 堆大小不能证明 GPU 资源已释放。对 device.lost 的意外丢失应停止继续提交命令并提示重载或重建,不能把它当作正常帧循环。

验收记录至少写明部署地址、浏览器与 GPU、粒子数、三个 FPS 采样值、两种视口测试和 10 次卸载结果。全部通过后再分享正式地址;如失败,保留 Console 错误与对应操作步骤,修复后重新构建、部署并复测。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

部署 HTTPS 并验收粒子场景

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通