Buildozer Kivy报错FileNotFoundError：缺失project.properties文件

我之前也碰到过类似的情况，明明之前构建正常，突然就卡在自动生成配置文件这一步了，给你分享几个亲测有效的排查和修复步骤：

1. 彻底清理构建缓存与残留文件 #

有时候旧的缓存碎片会干扰新构建流程，只删.spec文件不够，得做深度清理：

• 执行Buildozer自带的清理命令，再手动删除残留目录：

  buildozer android clean
  rm -rf .buildozer/
  rm -rf bin/
  

• 重新初始化配置文件，记得补全你的包名、权限等关键配置：

  buildozer init
  buildozer android debug deploy run
  

2. 检查.spec文件的核心配置是否合规 #

project.properties的生成完全依赖.spec文件的正确配置，重点核对这几项：

• package.name：必须符合Java包命名规范（比如com.yournick.yourproject，不能有大写字母、空格或特殊字符）
• android.api：指定一个稳定的API级别，推荐用29或30（太新的API可能存在适配问题，太旧的则可能被Buildozer弃用）
• android.sdk：如果是自定义SDK路径，确保路径正确且有读写权限；如果让Buildozer自动下载，要保证网络环境稳定

3. 手动触发配置文件生成流程 #

如果自动生成失败，可以尝试绕过Buildozer的自动流程，手动生成project.properties：

• 先运行buildozer android debug到报错的步骤，然后进入构建目录：

  cd .buildozer/android/platform/build/dists/[你的包名]/
  

• 检查目录下是否有build.xml，如果存在，执行Android SDK的命令生成配置文件：

  android update project -p .
  

  注意：执行这个命令前要确保系统已经配置好Android SDK环境变量（ANDROID_HOME指向SDK目录，且PATH包含SDK的tools子目录）

4. 更新Buildozer与依赖组件 #

旧版本的Buildozer可能存在配置文件生成的bug，尝试升级到最新稳定版：

pip install --upgrade buildozer
pip install --upgrade cython

同时确认系统安装了Buildozer必需的依赖（比如python3-pip、git、zip、openjdk-8-jdk等，根据你的操作系统调整）

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