Kivy+Buildozer 打包 APK 踩坑：python-for-android 克隆失败

目录一、问题现象二、前置清理操作三、核心解决方案亲测有效方案 1国内镜像克隆 强制指定本地路径推荐方案 2命令行直接指定本地路径快速应急方案 3手动下载源码包无 Git 环境备用四、Ubuntu 虚拟环境常用操作五、问题根因分析六、总结与避坑要点七、写在最后论文投稿2026年决策、管理与学习系统国际学术会议大会官网https://ais.cn/u/yY3EZf大会时间2026年4月10-12日大会地点马来西亚-吉隆坡一、问题现象在 Ubuntu 虚拟机中执行buildozer android debug deploy run打包 Kivy 项目时出现Git 克隆超时 / 无法连接错误fatal: 无法访问 https://hub.fastgit.xyz/kivy/python-for-android.git/ Failed to connect to hub.fastgit.xyz port 443 after 21066 ms: Couldnt connect to server即便手动用 Gitee 镜像克隆成功Buildozer 仍会判定为非官方仓库并删除重建再次触发网络失败陷入死循环。二、前置清理操作先清理旧缓存与平台文件避免残留文件干扰# 清理python-for-android目录 sudo rm -rf /home/xh/my-kivy-app/.buildozer/android/platform/python-for-android # 清理buildozer全局缓存 sudo rm -rf ~/.buildozer/cache三、核心解决方案亲测有效方案 1国内镜像克隆 强制指定本地路径推荐进入平台目录并克隆 Gitee 镜像mkdir -p /home/xh/my-kivy-app/.buildozer/android/platform/ cd /home/xh/my-kivy-app/.buildozer/android/platform/ git clone https://gitee.com/mirrors/python-for-android.git cd python-for-android git checkout master修改buildozer.spec强制使用本地仓库打开配置文件在末尾添加# 强制使用本地python-for-android跳过官方仓库校验 p4a.local_recipes /home/xh/my-kivy-app/.buildozer/android/platform/python-for-android p4a.source_dir /home/xh/my-kivy-app/.buildozer/android/platform/python-for-android重新执行打包命令cd /home/xh/my-kivy-app buildozer android debug deploy run方案 2命令行直接指定本地路径快速应急无需改配置直接带参数运行buildozer android debug deploy run --p4a-dir/home/xh/my-kivy-app/.buildozer/android/platform/python-for-android方案 3手动下载源码包无 Git 环境备用cd /home/xh/my-kivy-app/.buildozer/android/platform/ wget https://github.com/kivy/python-for-android/archive/refs/heads/master.zip -O p4a.zip unzip p4a.zip mv python-for-android-master python-for-android rm p4a.zip四、Ubuntu 虚拟环境常用操作打包过程中常用环境命令避免误操作# 退出Python虚拟环境 deactivate # 重新进入虚拟环境 source kivy_venv/bin/activate五、问题根因分析网络限制国内网络无法稳定访问 GitHub 与 fastgit 镜像导致克隆超时。Buildozer 校验机制会检查仓库源地址与分支非官方 GitHub 源会被自动删除重建。缓存残留旧的平台文件与缓存会引发路径冲突必须先清理。六、总结与避坑要点打包前务必清理缓存减少未知报错。网络不佳时优先使用Gitee 镜像不要依赖默认源。关键是强制指定本地 p4a 路径跳过 Buildozer 的仓库校验逻辑。虚拟环境切换用deactivate不要直接关闭终端。七、写在最后这次在 Ubuntu 下用 Buildozer 给 Kivy 应用打包 Android APK全程踩了不少环境权限、网络克隆、仓库校验的坑。从最开始的externally-managed-environment虚拟环境问题到后来python-for-android克隆失败、Buildozer 强制删仓库重下一步步排查下来其实核心就两点国内网络环境下一定要用 Gitee 镜像替代 GitHub不想被 Buildozer 反复校验折腾就强制指定本地 p4a 路径跳过官方源检查。整个过程虽然繁琐但也算完整走通了一套 Kivy 从开发到 Android 打包的流程。如果你也在做 Kivy 跨平台开发或者同样卡在打包这一步欢迎在评论区交流报错信息、配置细节我会尽量回复也欢迎点赞、收藏本文后续会继续更新 Kivy 开发与打包相关的实战踩坑笔记