1. 安装Linux系统（推荐Ubuntu）

Buildozer在Linux环境下运行最稳定。可以使用：

• 原生Ubuntu系统
• Windows的WSL2（Windows Subsystem for Linux）
• 虚拟机（VirtualBox + Ubuntu镜像）

2. 安装必要的依赖包

# 更新系统包
sudo apt update
sudo apt upgrade -y

# 安装Buildozer依赖
sudo apt install -y \
    python3-pip \
    git \
    zip \
    unzip \
    openjdk-17-jdk \
    autoconf \
    libtool \
    pkg-config \
    zlib1g-dev \
    libncurses5-dev \
    libncursesw5-dev \
    libtinfo5 \
    cmake \
    libffi-dev \
    libssl-dev

1. 安装Buildozer

# 使用pip安装buildozer
pip3 install --user buildozer

# 将用户bin目录添加到PATH
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
source ~/.bashrc

2. 初始化项目

进入你的Python项目目录，执行初始化命令：

cd /path/to/your_project
buildozer init

这会在目录下生成buildozer.spec配置文件

3. 配置buildozer.spec文件

编辑buildozer.spec文件，关键配置项：

[app]

# 应用标题
title = My Python App

# 包名（唯一标识）
package.name = mypythonapp

# 应用域名（反向包名格式）
package.domain = org.mydomain

# 主程序入口
source.dir = .
source.include_exts = py,png,jpg,kv,atlas

# 主文件（程序入口）
source.main = main.py

# Android SDK版本
android.api = 33
android.minapi = 21
android.ndk = 25b

# 所需权限
android.permissions = INTERNET

# 应用所需依赖
requirements = python3,kivy

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

4. 开始打包APK

# 首次打包需要下载SDK/NDK等（约1-2GB）
buildozer -v android debug

# 后续打包可跳过依赖下载
buildozer android debug

打包完成后，APK文件位于bin目录下

main.py

import kivy
from kivy.app import App
from kivy.uix.button import Button
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label

class MyApp(App):
    def build(self):
        layout = BoxLayout(orientation='vertical', spacing=10, padding=40)
        
        label = Label(text="Hello from Python!", 
                     font_size='24sp',
                     color=[0.2, 0.6, 1, 1])
        
        btn = Button(text="Click Me!", 
                    size_hint=(None, None),
                    size=(200, 60),
                    pos_hint={'center_x': 0.5})
        btn.bind(on_press=self.on_button_click)
        
        layout.add_widget(label)
        layout.add_widget(btn)
        return layout
    
    def on_button_click(self, instance):
        print("Button clicked!")
        instance.text = "Clicked!"

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

1. 编译时下载失败

解决方案： 由于网络原因，部分资源可能下载失败。可以尝试：

• 使用VPN或代理
• 手动下载所需文件并放到buildozer缓存目录
• 多次尝试运行打包命令

2. APK文件过大

优化方法：

• 使用--strip选项减少二进制文件大小
• 排除不需要的库和文件
• 使用requirements精确指定依赖

3. 应用启动崩溃

排查步骤：

• 检查adb logcat日志
• 确保所有资源文件包含在配置中
• 在Android设备上测试前先在桌面环境测试