将 Python 程序打包成 APK：从零到上手的完整指南

1. 引言很多 Python 开发者都希望把自己写的脚本或小工具发布到 Android 手机上让更多人直接安装使用。但 Python 本身并不直接运行在 Android 系统上需要借助工具链将 Python 解释器、依赖库和你的代码一起打包成 APK 安装包。本文将带你了解几种主流的打包方案并给出可复现的实战步骤帮助你顺利把 Python 程序变成可安装的 Android 应用。2. 主流打包方案对比在动手之前先了解目前常用的几种方案以便根据项目类型做出选择。方案适用场景优点缺点Kivy Buildozer图形界面应用纯 Python 开发 UI打包工具成熟包体积较大UI 风格偏原生Chaquopy在 Android 原生项目中嵌入 Python与 Android Studio 集成好可调用 Java/Kotlin需要 Android 开发基础Termux 脚本命令行工具、脚本无需打包直接在手机上运行不是真正的 APK依赖 Termux 环境BeeWareBriefcase跨平台 GUI 应用官方支持 Android 打包工具链统一对新手有一定学习成本如果你的程序是带界面的应用推荐 Kivy Buildozer如果只是想在 Android 原生 App 里嵌入一段 Python 逻辑则选择 Chaquopy。3. 环境准备无论选择哪种方案都需要先准备好开发环境。这里以最常用的Kivy Buildozer为例。3.1 安装 Python 与虚拟环境建议使用 Python 3.8 及以上版本并创建独立的虚拟环境避免污染系统环境。python3-mvenv kivy_envsourcekivy_env/bin/activate3.2 安装 Kivypipinstallkivy3.3 安装 BuildozerBuildozer 是 Kivy 官方提供的 Android 打包工具负责自动下载 Android SDK、NDK 等依赖。pipinstallbuildozer注意Buildozer 目前主要支持 Linux 和 macOS。Windows 用户建议使用 WSLWindows Subsystem for Linux或虚拟机。4. 编写一个简单的 Kivy 应用我们先写一个最简单的 Kivy 应用作为打包测试对象。# main.pyfromkivy.appimportAppfromkivy.uix.labelimportLabelclassHelloApp(App):defbuild(self):returnLabel(textHello, Android!)if__name____main__:HelloApp().run()保存为main.py在本地运行确认无误python main.py5. 使用 Buildozer 打包 APK5.1 初始化 Buildozer 配置在项目目录下执行buildozer init这会生成一个buildozer.spec配置文件。打开它修改关键字段[app] title Hello Android package.name helloandroid package.domain org.example source.dir . source.include_exts py,png,jpg,kv,atlas version 1.0.0 [buildozer] log_level 2 warn_on_root 15.2 开始打包执行打包命令buildozer-vandroid debug首次打包会下载 Android SDK、NDK 等大量依赖耗时较长请耐心等待。打包成功后APK 文件会生成在bin/目录下。lsbin/# 输出类似helloandroid-1.0.0-arm64-v8a-debug.apk5.3 安装到手机将 APK 传输到 Android 手机开启「允许安装未知来源应用」后即可安装。adbinstallbin/helloandroid-1.0.0-arm64-v8a-debug.apk6. 常见问题与优化6.1 打包体积过大Kivy 应用默认包含完整的 Python 解释器和 Kivy 框架APK 体积通常在 20MB 以上。可以通过以下方式优化使用--release模式打包启用压缩精简依赖库只保留必要的模块使用android.archs指定目标架构减少多架构冗余。6.2 依赖库缺失如果程序使用了第三方库如requests、numpy需要在buildozer.spec中声明requirements python3,kivy,requests,numpy6.3 权限配置如果应用需要访问网络、存储等权限在buildozer.spec中配置android.permissions INTERNET, WRITE_EXTERNAL_STORAGE7. 进阶使用 Chaquopy 嵌入 Python如果你的项目是基于 Android Studio 的原生应用希望嵌入 Python 逻辑可以使用 Chaquopy。在build.gradle中添加plugins { id com.chaquo.python } android { defaultConfig { ndk { abiFilters arm64-v8a, x86_64 } } } chaquopy { defaultConfig { pip { install requests } } }然后在 Java/Kotlin 代码中调用 PythonPythonpyPython.getInstance();PyObjectmodulepy.getModule(my_module);module.callAttr(my_function);8. 总结将 Python 程序打包成 APK 主要有两条路径纯 Python 应用使用 Kivy Buildozer全程 Python 开发适合快速发布带界面的小工具原生 Android 嵌入使用 Chaquopy在 Android Studio 项目中嵌入 Python 逻辑适合已有原生项目的团队。无论选择哪种方案核心都是把 Python 解释器和依赖一起打包进 APK。建议先从简单的 Kivy 示例入手跑通整个流程后再扩展到你的实际项目。