文章目录
buildozer.spec 文件是 Kivy 应用的打包配置文件，用于在使用 Buildozer 创建 Android 或其他平台的可执行包时设定应用的各项参数。下面是对
buildozer.spec 文件的详细解析，帮助你理解每一项配置。
1. 基础信息
[app]
# (str) Title of your application
title = My Application
# (str) Package name
package.name = myapplication
# (str) Package domain (needed for android/ios packaging)
package.domain = org.example
# (str) Source code where the main.py lives
source.include_exts = py,png,jpg,kv,atlas
# (str) Application version
version = 0.1
# (str) The version of your application
version.code = 1
# (str) The directory in which to find the python modules and packages
source.dir = .
# (bool) Indicate if the application should be built for the latest versions of SDK and NDK
# (default is false)
android.use_android_log = true
- title: 应用程序的名称。
- package.name: 应用程序的包名，通常采用小写字母和下划线的格式。
- package.domain: 应用程序的域名，反向命名法。示例：
org.example。 - source.include_exts: 打包时包含的文件扩展名，其中可以包含 Python 脚本、图像、KV 文件等。
- version: 应用程序的版本号。
- version.code: 应用程序的版本代码（整数），用于在 Play 商店进行版本管理。
2. 需求
# (list) Application requirements
requirements = python3,kivy,opencv-python
- requirements: 这里列出所有需要的库和模块，使用逗号分隔。例如，
kivy,opencv-python, 这将确保在打包 APK 时安装所需的 Python 库。
3. 权限
# (list) Permissions
android.permissions = CAMERA, WRITE_EXTERNAL_STORAGE
- android.permissions: 需要请求的权限列表，例如
CAMERA,WRITE_EXTERNAL_STORAGE等，确保在使用相关功能时获得相应权限。
4. 输出
# (str) The folder to which to copy the final application package
output_dir = bin
- output_dir: 指定存放生成的 APK 文件的目录。
5. 图标和主题
# (str) Application icon
icon.filename = icon.png
# (str) The background color of the status bar (the default is #000000)
android.statusbar_color = #000000
- icon.filename: 应用程序图标的文件名（png格式）。
- android.statusbar_color: 状态栏的背景颜色，采用 HEX 码表示。
6. 其他设置
# (str) Package name of your app
package.name = myapp
# (str) Application versioning
version = 0.1
version.code = 1
# (str) The path (absolute or relative) to a directory that contains the application code
source.include_exts = py,png,jpg,kv,atlas
7. 额外平台设置
对于 Android 及其他平台，可以定义一些特定的设置。例如：
# (str) Android API to use
android.api = 31
# (str) Android NDK version
android.ndk = 21b
# (str) Android SDK version
android.sdk = 31
- android.api: 指定使用的 Android API 级别，确保兼容性。
- android.ndk: 指定 Android NDK 版本。
- android.sdk: 指定 Android SDK 版本。
8. 其他重要选项
8.1 调试模式
# (bool) Enable or disable debug mode
debug = 1
- debug: 1表示启用调试模式，构建时会提供更多的日志信息。
8.2 运行时设置
# (str) Additional build options
p4a.branch = master
- p4a.branch: 指定要构建的 Python for Android 分支。
9. 完整范例
以下是一个完整的 buildozer.spec 文件示例：
[app]
title = My Application
package.name = myapplication
package.domain = org.example
source.include_exts = py,png,jpg,kv,atlas
version = 0.1
version.code = 1
source.dir = .
requirements = python3,kivy,opencv-python
android.permissions = CAMERA, WRITE_EXTERNAL_STORAGE
output_dir = bin
icon.filename = icon.png
android.statusbar_color = #000000
android.api = 31
android.ndk = 21b
android.sdk = 31
debug = 1
p4a.branch = master
10. 使用 buildozer
在命令行中运行以下命令来构建你的应用程序：
buildozer -v android debug
使用 buildozer android deploy run 命令可以将 APK 部署到连接的 Android 设备中并运行它。
总结
buildozer.spec 文件是构建 Kivy 应用的重要配置文件，合理设置每一个参数可以帮助你顺利构建和发布应用。通过理解每个部分的作用，可以根据项目需求进行调整和优化。