SuperAPI AI 工具集

phaser-build

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:在开发 Phaser 4 游戏时处理构建、运行与部署相关任务,包括启动开发服务器、生成生产构建、修复构建错误和配置打包工具。

主要能力:

  • 开发服务器:npm run dev,默认在 http://localhost:5173 打开并支持热重载。
  • 生产构建:npm run build 编译 TypeScript 并用 Vite 打包到 dist/;npm run preview 本地预览生产构建。
  • 项目诊断:bash scripts/validate-project.sh 自动检查常见问题(Phaser 版本、tsconfig 字段、场景文件、废弃的 v3 API)。
  • 类型检查:npx tsc --noEmit,需在发布前修复所有类型错误。
  • 常见错误处理:模块找不到、资源 404、v3 到 v4 的 API 变更(如 Phaser.Geom.Point 改为 Vector2、Math.PI2 改为 Math.TAU)、黑屏、WebGL 上下文丢失等。
  • Vite 配置:base: './' 对 itch.io、GitHub Pages 等子目录部署很关键;可单独打包 Phaser 便于缓存。
  • 部署目标:itch.io(打包 dist/ 内容上传)、GitHub Pages(提供 Actions 工作流示例)、Netlify/Vercel(构建命令 npm run build,输出目录 dist)、Capacitor(iOS/Android)。

使用方式:按需运行上述命令;资源需放在 public/ 目录并以路径字符串引用,不要用 ES import。

限制:资料未提供具体收费、价格或效果保证;部分配置与部署步骤需结合项目实际情况调整。