【Kivy App】Kivy应用打包成安卓APK文件

使用 Kivy 开发的应用可以通过 Buildozer 工具打包为 Android APK 文件。以下是详细的步骤，从环境配置到生成 APK 文件。

---

1. 环境准备

1.1 安装依赖

在 Linux 或 macOS 上运行以下命令安装 Buildozer 和所需依赖：

# 安装 Buildozer
pip install buildozer

# 安装 Cython（Kivy 需要）
pip install cython

# 安装其他依赖
sudo apt update
sudo apt install -y python3-pip python3-setuptools python3-virtualenv git zip unzip openjdk-8-jdk

在 Windows 上，建议使用 WSL（Windows Subsystem for Linux） 来运行 Buildozer。

---

1.2 配置 Android SDK 和 NDK

Buildozer 会自动下载 Android SDK 和 NDK，但你可以手动配置：

1. 下载 Android SDK 和 NDK：

   • Android SDK
   • Android NDK

2. 设置环境变量：

   export ANDROIDSDK=/path/to/android-sdk
   export ANDROIDNDK=/path/to/android-ndk
   export PATH=$PATH:$ANDROIDSDK/tools:$ANDROIDSDK/platform-tools
   

---

2. 初始化 Buildozer

在项目目录中运行以下命令，生成 buildozer.spec 配置文件：

buildozer init

这会生成一个 buildozer.spec 文件，用于配置应用的打包参数。

---

3. 修改 buildozer.spec 文件

打开 buildozer.spec 文件，修改以下配置：

3.1 应用信息

[app]
title = My Kivy App  # 应用名称
package.name = myapp  # 包名
package.domain = org.example  # 域名
source.include_exts = py,png,jpg,kv,atlas  # 包含的文件类型

3.2 依赖项

requirements = python3,kivy  # 依赖的 Python 库

3.3 权限（如果需要）

android.permissions = INTERNET  # 需要的权限

3.4 图标和启动画面

# 图标
icon.filename = %(source.dir)s/data/icon.png

# 启动画面
presplash.filename = %(source.dir)s/data/presplash.png

---

4. 打包 APK

在项目目录中运行以下命令，开始打包 APK：

buildozer -v android debug

打包过程可能需要一些时间，Buildozer 会自动下载 Android SDK 和 NDK。

---

5. 获取 APK 文件

打包完成后，APK 文件会生成在 bin 目录中，文件名为 MyApp-0.1-debug.apk。

---

6. 安装 APK 到安卓手机

1. 将生成的 APK 文件传输到安卓手机。
2. 在手机上启用“未知来源”安装权限。
3. 使用文件管理器找到 APK 文件并安装。

---

7. 调试和日志

如果应用在手机上运行异常，可以通过 adb logcat 查看日志：

adb logcat | grep python

---

8. 常见问题

8.1 打包失败

• 确保安装了所有依赖项。
• 检查 buildozer.spec 文件中的配置是否正确。
• 如果网络问题导致 SDK 或 NDK 下载失败，可以手动下载并配置路径。

8.2 应用崩溃

• 确保所有依赖库都包含在 requirements 中。
• 检查日志以定位问题。

8.3 性能问题

• 优化代码和资源文件。
• 使用 Kivy 的性能调试工具。

---

9. 示例项目

以下是一个简单的 Kivy 应用示例，可以打包为 APK：

main.py:

from kivy.app import App
from kivy.uix.button import Button

class MyApp(App):
    def build(self):
        return Button(text='Hello, Kivy!')

if __name__ == '__main__':
    MyApp().run()

buildozer.spec:

[app]
title = My Kivy App
package.name = myapp
package.domain = org.example
source.include_exts = py,png,jpg,kv,atlas
requirements = python3,kivy

运行以下命令打包：

buildozer -v android debug

---

通过以上步骤，你可以成功将 Kivy 应用打包为 Android APK 文件，并在安卓手机上运行！