Buildozer打包Kivy/KivyMD应用为APK后安卓启动崩溃如何解决

当前配置存在3个100%触发启动闪退的硬错误：

• 依赖漏配：代码中导入了kivymd_extensions.akivymd、firebase_admin两个第三方库，但buildozer.spec的requirements仅配置了3个基础依赖，打包时未将上述库打入APK，APP启动执行import语句时直接触发ImportError闪退，这是最首要的崩溃原因。threading为Python标准库，不需要额外加入依赖项。
• 权限缺失：Firebase服务初始化、数据请求需要网络权限，但配置中未开启INTERNET权限，就算依赖补全，Firebase初始化阶段会直接触发权限异常崩溃；如果你的服务证书存放在外部存储目录，未配置存储读写权限也会在读取证书文件时触发文件访问异常。
• 资源漏打包：Firebase服务证书为json格式文件，默认配置下Buildozer不会将json后缀文件打入APK包内，启动时读取证书会直接触发FileNotFoundError。

1. 补全依赖配置
   找到buildozer.spec中requirements配置项，替换为以下内容（版本号请和你本地开发环境可正常运行的版本对齐，避免版本兼容问题）：

requirements = python3,kivy==2.3.0,kivymd==1.2.0,akivymd,firebase-admin,pyjwt,google-auth,cryptography,requests

注意：firebase_admin存在多个链式依赖，手动列全相关依赖可以避免Buildozer自动拉取依赖时出现版本不匹配、漏装的问题。

2. 补全必要权限
   找到android.permissions配置项，添加APP运行需要的权限：

android.permissions = INTERNET,ACCESS_NETWORK_STATE,READ_EXTERNAL_STORAGE,WRITE_EXTERNAL_STORAGE

3. 配置静态资源打包规则
   找到source.include_exts配置项，添加json后缀，确保Firebase证书文件能被打入APK：

source.include_exts = py,png,jpg,kv,atlas,json

如果证书文件存放在单独的目录下，还需要在source.include_dirs配置项中添加对应目录路径。

4. 修正线程逻辑
   所有涉及Kivy/KivyMD组件属性修改、Screen页面切换的UI操作，必须在主线程执行，禁止在threading启动的子线程中直接操作UI，否则会触发线程安全异常。子线程需要更新UI时，使用Clock.schedule_once()将UI操作切回主线程调度。

5. 清空缓存重新构建
   执行以下命令清空旧的构建缓存，再重新打包，避免缓存导致新配置不生效：

buildozer android clean
buildozer android debug deploy run

如果按上述步骤调整后仍存在崩溃问题，不要反复盲目重打，直接抓取准确崩溃日志定位：

• 安卓设备开启开发者选项与USB调试，通过数据线连接电脑
• 命令行执行adb logcat -s python，保持终端窗口打开
• 手动点击手机上的APP图标触发启动，终端会直接打印Python层的完整崩溃栈，对应报错行修改即可。

内容的提问来源于stack exchange，提问作者I'm a Studnet