project-defignore.md 2.0 KB


title: Defold 项目忽略文件

brief: 本手册描述了如何在 Defold 中忽略文件和文件夹。

忽略文件

可以配置 Defold 编辑器和工具来忽略项目中的文件和文件夹。如果项目包含的文件扩展名与 Defold 使用的文件扩展名冲突,这会很有用。一个例子是 Go 语言文件使用 .go 文件扩展名,这与编辑器用于游戏对象文件的扩展名相同。

.defignore 文件

要排除的文件和文件夹在项目根目录中名为 .defignore 的文件中定义。该文件应列出要排除的文件和文件夹,每行一个。例如:

/path/to/file.png
/otherpath

这将排除文件 /path/to/file.png 和路径 /otherpath 中的任何内容。

.defunload 文件

对于某些包含多个独立模块的大型项目,您可能希望排除其中一部分以减少编辑器中的内存使用和加载时间。为此,您可以在项目目录下的 .defunload 文件中列出要从加载中排除的路径。

简单地说,.defunload 文件允许您向编辑器隐藏项目的部分内容,而不会使引用隐藏资源成为构建错误。

.defunload 中的模式使用与 .defignore 文件相同的规则。当被加载的资源引用时,已卸载的集合和游戏对象将表现得如同它们是空的。与 .defunload 模式匹配的其他资源将处于未加载状态,无法在编辑器中查看。但是,如果已加载的资源依赖于它们,则未加载的资源及其依赖项将自动加载。

例如,如果一个精灵依赖于图集中的图像,我们必须加载该图集,否则缺失的图像将被报告为错误。如果发生这种情况,通知将警告用户有关情况,并提供关于从何处引用了哪个未加载资源的信息。

编辑器将阻止用户从已加载的资源添加对 .defunloaded 资源的引用,因此这种情况仅在从磁盘读取资源时发生。

.defignore 文件相反,编辑 .defunload 文件后需要重新启动编辑器才能看到更改生效。