You need to enable JavaScript to run this app. Buildozer打包Kivy应用为Android安装包时依赖配置报错及未使用指定Kivy版本问题
优惠活动
大模型
产品
解决方案
定价
更多

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会解析失败,跳过版本要求直接使用默认缓存版本

可直接落地的修复步骤

  1. 修正requirements配置:移除所有内置标准库模块的声明,把Kivy的版本调整为标准pip格式,正确的配置示例为:
    requirements = python3, kivy==2.0.0
    
  2. 彻底清除旧打包缓存:直接删掉项目目录下的.buildozer隐藏文件夹,从根源上避免旧缓存的预编译包被复用
  3. 升级打包工具到最新正式版,替换掉apt源提供的老旧Buildozer:
    pip install --upgrade buildozer python-for-android
    
  4. 启动打包时加上禁用缓存的参数,强制重新拉取所有符合版本要求的依赖:
    buildozer android debug --no-cache
    

实际操作中完全不需要在虚拟机本机通过pip或apt安装任何版本的Kivy,这类操作对最终APK的打包结果没有任何影响,反而容易混淆问题排查思路。

内容的提问来源于stack exchange,提问作者Louis George

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 08:54:06