含视频的Kivy/KivyMD Python文件转APK遇错误求简易解决步骤

1. 准备Buildozer环境 #

• 安装Buildozer：pip install buildozer
• 进入项目根目录，初始化配置文件：buildozer init

2. 关键配置修改（编辑buildozer.spec） #

• 包含视频资源：找到source.include_exts，追加你的视频格式，比如：

  source.include_exts = py,png,jpg,kv,mp4
  

  如果视频放在子文件夹（如assets/videos/），还要添加目录：

  source.include_dirs = assets
  

• 添加依赖：找到requirements，确保包含视频播放所需的库：

  requirements = python3,kivy,kivymd,ffpyplayer
  

• 添加权限：找到android.permissions，补充存储权限（本地视频需要）：

  android.permissions = READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE, INTERNET
  

3. 修正代码中的视频路径 #

• 用项目内的相对路径调用视频，比如：

  from kivy.uix.video import Video
  video = Video(source='assets/videos/my_video.mp4')
  

  绝对路径会导致APK找不到资源。

4. 清理旧构建缓存 #

• 运行命令清除之前的错误残留：

  buildozer android clean
  

5. 构建APK #

• 执行构建命令，生成的APK会在项目的bin/目录下：

  buildozer android debug
  

  如果要直接部署到连接的安卓设备，用：

  buildozer android debug deploy run
  

注意事项 #

• 优先用MP4（H.264编码）格式的视频，安卓兼容性最好
• 如果构建时出现编译失败，检查buildozer.spec里的依赖拼写是否正确，尤其是ffpyplayer不能漏
• 确保项目根目录的文件结构清晰，资源路径不要嵌套太深

内容的提问来源于stack exchange，提问作者Hashray Kumbhani