buildozer.spec 文件的详细解析

蜡笔小新星

于 2024-10-11 22:43:10 发布

阅读量244

点赞数 6

分类专栏： Kivy 文章标签：学习经验分享 python buildozer

本文链接：https://blog.csdn.net/m0_54490473/article/details/142864928

版权

Kivy 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

文章目录

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