Kivy/Buildozer项目中的base.dm文件缺失与权限问题解析

问题现象

在使用Kivy和Buildozer打包Android应用时，开发者可能会遇到两个典型错误：

1. 应用启动时无法找到base.dm文件
2. Kivy图标文件复制时出现权限被拒绝的错误(Errno 13)

问题根源分析

base.dm文件缺失问题

base.dm文件是Android应用包的一部分，通常包含应用的资源数据。从日志中可以看到系统尝试在以下路径查找但失败：

/data/app/~~ql2Jq9YfNRCGbNIldqZjGQ==/org.test.beaware-8Kne713KgRgZxFIBdoRMTw==/base.dm

主要原因是buildozer.spec配置文件中未包含.dm扩展名：

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

Kivy图标权限问题

当应用尝试将Kivy内置图标复制到应用数据目录时，会遇到权限错误：

shutil.Error: [('/data/user/0/org.test.beaware/files/app/_python_bundle/site-packages/kivy/data/logo/kivy-icon-128.png', '/data/user/0/org.test.beaware/files/app/.kivy/icon/kivy-icon-128.png', "[Errno 13] Permission denied: '/data/user/0/org.test.beaware/files/app/.kivy/icon/kivy-icon-128.png'")

这表明应用没有足够的权限在其数据目录中创建文件和子目录。

解决方案

解决base.dm文件问题

1. 修改buildozer.spec文件，在source.include_exts中添加.dm扩展名：

source.include_exts = py,png,jpg,kv,atlas,txt,dm

2. 执行完整清理后重新构建：

buildozer android clean
buildozer -v android debug

解决Kivy图标权限问题

1. 确保AndroidManifest.xml中包含必要的存储权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

2. 在应用启动时动态请求存储权限（针对Android 6.0及以上版本）

3. 或者修改Kivy配置，避免尝试复制这些图标文件

深入技术细节

Android应用资源打包机制

Android应用在构建过程中会将各种资源打包到APK文件中。Buildozer使用Python-for-Android工具链来处理这一过程。当某些文件扩展名未被包含时，相关资源就不会被打包进APK，导致运行时找不到文件的错误。

Android存储权限模型

从Android 6.0开始，引入了运行时权限系统。即使应用在Manifest中声明了权限，也需要在运行时请求用户授权。对于应用私有数据目录，应用本应具有完全访问权限，但在某些定制ROM或特定情况下仍可能出现权限问题。

最佳实践建议

1. 完整列出资源扩展名：在buildozer.spec中明确列出所有需要的文件扩展名，包括但不限于程序代码、图像、数据文件等。

2. 权限处理：

   • 在Manifest中声明所有需要的权限
   • 实现运行时权限请求逻辑
   • 考虑使用Android的Scoped Storage API（针对Android 10及以上版本）

3. 构建过程：

   • 定期执行clean操作以避免缓存问题
   • 使用verbose模式(-v)构建以获取详细日志
   • 针对不同Android版本进行测试

4. 错误处理：

   • 在代码中添加对资源加载失败的处理
   • 提供有意义的错误提示
   • 考虑备用资源方案

通过以上措施，可以有效地解决这类资源文件和权限问题，确保Kivy应用在Android设备上正常运行。