源代码管理
Wonderland Engine 项目被设计为能够与任何源代码管理工具良好集成,并且最常用的是 git。
由于项目文件是基于 JSON 的,因此可以手动合并。请确保删除对象和列表中最后元素的多余逗号!
UUIDs
为了避免新对象资源 ID 的冲突,您可以让编辑器生成 UUIDs,而不是简短且易读的顺序 ID:
视图 > 项目设置 > 编辑器 > ids(设置为 uuid)。
.gitignore
以下是建议使用的 .gitignore 文件。
请注意,根据您的 CI/CD 设置,您可能希望添加 cache,以减少在性能较低的构建机器上压缩图像所需的时间。
将 cache 文件提交到版本控制系统的额外好处是加快克隆项目之后的首次项目加载速度。
# NPM 依赖
**/node_modules/
# 打包的项目文件
**/deploy/
# 本地编辑器数据
**/.editor/
# 缓存的编辑器 JS 包
**/cache/js/
# 本地 UI 状态
**/imgui.ini
# Blender 备份文件
*.blend1 Git LFS
Git 大文件存储扩展可以加速在您的仓库上的 Git 操作,特别是因为 WebXR 项目通常包含大型的 3D 资产、纹理和音频文件。
以下是通过 git lfs track <extensions> 推荐跟踪的一些文件:
# 音频文件
*.mp3 *.wav *.ogg *.webm
# 视频文件
*.mp4
# 二进制 3D 模型文件
*.glb *.fbx *.bin *.blend *.ply
# 图像文件
*.png *.jpeg *.webp *.bmp *.exr *.hdr *.basis
# 字体文件
*.ttf *.otf
# 压缩文件
*.zip *.tar.gz package-lock.json
package-lock.json 存储当前在您的系统上安装的依赖项的确切版本。使用 npm install 时,该文件将更新为符合 package.json 文件中给定约束的最新依赖项。
您可以使用 npm ci 来安装 package-lock.json 中指定的确切依赖项版本。为了获得可复制的构建,您需要提交此文件。