如何阻止Gradle在编译时生成app-metadata.properties文件

首先明确：app/build/intermediates/app_metadata/release/app-metadata.properties是Android Gradle Plugin（AGP）构建流程中必须生成的中间文件，它用于记录应用构建的元数据（比如版本信息、签名状态等），所以直接设置只读或者用exclude配置禁止生成都会破坏构建流程，导致编译失败，这是正常现象。

以下是针对不同需求的可行解决方案：

• 不想让文件提交到版本控制：
  不用禁止生成，直接在项目根目录的.gitignore文件中添加忽略规则：

  app/build/intermediates/app_metadata/
  

  这样版本控制系统会忽略整个app_metadata目录，不会把这个properties文件纳入提交范围。

• 需要调整文件内容而非禁止生成：
  这个文件的内容由AGP根据你的构建配置自动生成，你可以通过修改app模块的build.gradle（或build.gradle.kts）配置来调整它的内容。比如：

  • 修改defaultConfig里的versionCode、versionName；
  • 调整签名配置signingConfigs；
    这些变更都会同步到生成的app-metadata.properties文件中。

• 因文件权限/缓存问题导致构建失败：
  执行清理构建缓存的命令，然后重新构建：

  # Windows系统
  gradlew clean
  
  # macOS/Linux系统
  ./gradlew clean
  

  清理后重新构建会重新生成所有中间文件，能解决大部分因缓存损坏或权限残留导致的写入异常。

内容的提问来源于stack exchange，提问作者user13776577