1. ??環境準備?
sudo apt update
sudo apt install -y python3-pip git zip unzip openjdk-17-jdk
sudo apt-get install -y autoconf automake libtool
pip install kivy buildozer cython
2. ??項目配置?
在項目目錄中初始化Buildozer：
buildozer init
這會生成buildozer.spec文件。
修改buildozer.spec文件，配置應用信息：
[app]
title = 你的應用名稱 # 修改為你的應用名字
package.name = yourapp # 包名（無空格和特殊字符）
package.domain = org.example # 域名
source.include_exts = py,png,jpg,kv,atlas # 包含的文件類型
requirements = python3,kivy # 依賴項
圖標配置（將圖標文件放在項目目錄中）
icon.filename = %(source.dir)s/data/icon.png # 修改為你的圖標路徑
啟動畫面（可選）
presplash.filename = %(source.dir)s/data/presplash.png
權限（如需要訪問網絡或存儲）
android.permissions = INTERNET
3. 更換國內鏡像源??
修改 buildozer.spec 文件，使用國內鏡像加速下載：使用清華鏡像源加速 SDK/NDK 下載
android.sdk_download_url = https://mirrors.tuna.tsinghua.edu.cn/android/repository/
android.ndk_download_url = https://mirrors.tuna.tsinghua.edu.cn/android/repository/
或通過環境變量臨時指定：
export SDK_URL="https://mirrors.tuna.tsinghua.edu.cn/android/repository/"
export NDK_URL="https://mirrors.tuna.tsinghua.edu.cn/android/repository/"
4. ??打包APK?
# 清理緩存，出現問題了，可以用這個清理下
buildozer android clean# 調試版本
buildozer -v android debug# 正式版本
buildozer -v android release# Buildozer 不僅支持 Android，還支持 iOS（需配置 Xcode 環境）：??buildozer ios debug??
# 生成 iOS 調試版應用。
??buildozer ios release??
# 生成 iOS 發布版應用（需簽名證書）首次運行會下載Android SDK和NDK，可能需要較長時間。
5. ??獲取APK文件??
打包完成后，APK文件會生成在bin/目錄下，文件名類似yourapp-0.1-debug.apk。
6. ??安裝測試??
將APK傳輸到安卓設備，手動安裝（需啟用“未知來源”權限）。
或使用ADB命令安裝：
adb install bin/yourapp-0.1-debug.apk
常見問題
- ??圖標不顯示??：檢查icon.filename路徑和文件格式（推薦PNG）。
- ??打包失敗??：檢查依賴項和網絡連接，或手動配置SDK/NDK路徑。
- 權限問題??：在buildozer.spec中添加所需權限（如WRITE_EXTERNAL_STORAGE）。
