Buildozer打包Kivy应用为Android安装包时依赖配置报错及未使用指定Kivy版本问题
打包问题的核心原因与对应解决方法
第一类报错:把time、math加进requirements触发pip找不到包
- time、math是Python原生内置标准库,Buildozer打包生成的Android端嵌入式Python环境会默认携带这两个模块,根本不需要也不允许通过第三方pip源安装
- 只要把这两个模块从
requirements字段里删掉,这个No matching distribution报错就会直接消失,后续应用运行时这两个模块可以正常导入使用,不会出现兼容问题
第二类核心问题:配置里指定了Kivy 2.0.0,最终打出的安装包启动时却提示用的是旧版Kivy
先澄清一个最容易踩的认知误区
Buildozer的Android打包流程和你虚拟机本机的Python环境是完全隔离的:
- 不管你在虚拟机里用pip装了哪个版本的Kivy,还是用apt装了系统级的python3-kivy,这些包都不会被打包流程读取、复制到最终的APK安装包里
- 最终APK里的整个Python运行环境、所有第三方依赖,都是Buildozer调用python-for-android(p4a,Buildozer的核心打包引擎),在独立的打包沙箱里重新下载、编译、组装出来的
- 应用启动时报的“Kivy版本太旧”,指的是APK沙箱内部打包进去的Kivy版本不符合要求,和你虚拟机本机安装的Kivy版本没有任何关联,很多人在这里反复折腾本机的Kivy版本,完全是走了弯路
旧版Kivy被塞进安装包的常见触发原因
- 打包工具版本过老:Ubuntu apt软件源里提供的Buildozer往往滞后好几年,这类老版本工具会默认从本地缓存拉取绑定好的Kivy 1.11.1预编译包,哪怕配置文件里写了版本要求,老版本的解析逻辑也会直接忽略版本约束,强行用缓存的旧包
- 旧打包缓存残留:项目目录下的
.buildozer隐藏文件夹会存储之前所有打包时的依赖缓存、预编译产物,后续打包时不会重新校验配置的版本要求,直接复用缓存里的旧Kivy包 - 版本声明格式不规范:如果在requirements里写
Kivy=2.0.0而非标准pip兼容格式的kivy==2.0.0,旧版本p4a会解析失败,跳过版本要求直接使用默认缓存版本
可直接落地的修复步骤
- 修正requirements配置:移除所有内置标准库模块的声明,把Kivy的版本调整为标准pip格式,正确的配置示例为:
requirements = python3, kivy==2.0.0 - 彻底清除旧打包缓存:直接删掉项目目录下的
.buildozer隐藏文件夹,从根源上避免旧缓存的预编译包被复用 - 升级打包工具到最新正式版,替换掉apt源提供的老旧Buildozer:
pip install --upgrade buildozer python-for-android - 启动打包时加上禁用缓存的参数,强制重新拉取所有符合版本要求的依赖:
buildozer android debug --no-cache
实际操作中完全不需要在虚拟机本机通过pip或apt安装任何版本的Kivy,这类操作对最终APK的打包结果没有任何影响,反而容易混淆问题排查思路。
内容的提问来源于stack exchange,提问作者Louis George
相关产品推荐
相关产品推荐

