This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

通过 .easignore 忽略文件

编辑页面

了解如何配置 EAS 在构建过程中忽略不必要的文件。


A .easignore 文件定义了 EAS 上传项目到 EAS Build 服务器时应忽略哪些文件。

默认情况下,EAS CLI 会参考 .gitignore 文件(如果存在)来确定要忽略哪些文件。如果你创建了 .easignore 文件,EAS CLI 会优先使用它而不是 .gitignore 文件。创建 .easignore 文件时,请包含 .gitignore 文件中的所有文件和目录,并添加你想要额外忽略的文件。

1

在项目根目录下创建一个 .easignore 文件。

2

将 .gitignore 文件的内容复制到 .easignore 文件中。然后,添加任何构建过程中不需要的文件。

.easignore
# 将你 .gitignore 文件中的所有内容复制到这里 # 忽略 EAS Build 构建你的应用不需要的文件和目录 /docs # 忽略原生目录(如果你正在使用 EAS Build) /android /ios # 忽略测试覆盖率报告 /coverage

如果你的项目不包含 android 和 ios 目录,EAS Build 将运行 Prebuild 以在编译前生成这些原生目录。

3

保存文件并触发新的构建。

Terminal
- eas build --platform ios --profile development

你已成功配置 .easignore 文件。

使用 .easignore 将文件添加到你的项目上传中

除了忽略 gitignore 文件中已有内容之外,你还可以使用 .easignore 文件将不在源代码管理中的文件包含到 EAS Build 上传中。如果你有自定义脚本,会在构建前刚刚生成构建过程所需的临时文件,这会很有用。要将不在源代码管理中的文件上传到 EAS Build,请在 .easignore 文件中为其添加 ! 前缀,并保留其余 .gitignore 内容。带 ! 前缀的文件应放在最后,这样它会优先于任何先前会忽略它的规则。

.easignore
# 将你 .gitignore 文件中的所有内容复制到这里 /android /ios # 包含一个不在源代码管理中的文件 !temp_file.json