Buildozer打包Kivy应用为APK时出现构建错误如何修复

本次构建失败发生在Python源码预编译字节码阶段，日志已明确给出核心原因：参与打包的Python文件存在语法错误，不属于Buildozer工具本身的bug。日志里的--sdk argument is deprecated是不影响构建的弃用警告，不是报错原因。

• 本地复现编译找错：进入你的项目根目录（/home/pedro/kivy_examples/graphs/），直接执行和构建时完全一致的编译命令：
  python3 -m compileall -b -f .
  命令执行后会直接输出存在语法错误的文件路径、具体行号和错误原因，常见的包括缩进错误、语句漏写末尾冒号、使用了和打包用Python版本不兼容的语法（比如在低版本Python里用了高版本才支持的match语法等），把所有提示的语法问题逐一修复即可。
• 清理无关文件：从日志能看到构建时把git-2.20.0这类和Kivy项目完全无关的文件夹也拷进了打包目录，Buildozer默认会扫描打包目录下所有.py文件参与编译，无关文件里的语法错误也会触发构建失败。不要把下载的第三方源码包、压缩包、其他项目文件放在和buildozer.spec同级的项目根目录，只保留你自己写的应用代码（比如main.py、自定义业务模块）、buildozer.spec配置文件即可。
• 修复权限和缓存路径混乱问题：你当前是用sudo执行buildozer命令，导致构建缓存一部分在/home/pedro路径下，一部分在/root路径下，很容易出现路径错乱、权限异常问题。后续直接用普通用户pedro的身份执行buildozer命令即可，不要加sudo。
• 清理缓存重构建：完成上面的修复后，执行buildozer android clean清空所有历史构建缓存，再重新执行打包命令。
• 开启详细日志兜底：如果上述步骤没定位到问题，打开项目根目录下的buildozer.spec文件，找到log_level配置项，把值改成2后重新构建，完整日志会打印出编译失败的具体文件和错误细节，不会像当前精简日志一样只给出笼统提示。

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