目录一、为什么选择Python做手机APP二、主流Python手机开发框架对比2.1 Kivy Buildozer最成熟的跨平台方案2.2 BeeWare原生UI的Python方案2.3 Chaquopy将Python嵌入Android原生项目2.4 PyqtdeployQt生态的延伸三、环境搭建从零开始准备开发工具3.1 安装Python及相关工具3.2 创建虚拟环境并安装Kivy3.3 安装打包工具Buildozer四、实战开发一个完整的计算器APP4.1 创建项目结构4.2 编写界面布局calculator.kv4.3 编写主逻辑main.py4.4 在桌面测试五、打包为Android APK5.1 配置buildozer.spec5.2 执行打包命令5.3 常见问题及解决六、深入优化让应用更专业6.1 自定义图标和启动画面6.2 使用SQLite本地存储6.3 添加振动反馈6.4 发布到应用商店七、其他方案快速入门7.1 BeeWare实战要点7.2 Chaquopy集成示例7.3 Pyqtdeploy注意事项八、性能优化与调试技巧8.1 减少APK体积8.2 调试Android应用8.3 性能瓶颈常见原因九、发布与分发9.1 应用商店上线9.2 iOS打包说明十、总结与展望博主智算菩萨专注于人工智能、Python编程、音视频处理及UI窗体程序设计等方向。致力于以通俗易懂的方式拆解前沿技术从零基础入门到高阶实战陪伴开发者共同成长。目前已开设五大技术专栏累计发布多篇原创技术文章深受读者好评。 专栏导航人工智能前沿知识已更201篇深度剖析Transformer架构、生成式AI、强化学习、具身智能、神经符号系统、大模型及智能体Agent技术系统性解析AI核心技术体系与前沿趋势。Python基础小白编程已更232篇从零开始以保姆式教程讲解变量、数据类型、流程控制、函数等核心语法配有大量实战代码与避坑指南真正做到学以致用。机器学习与深度学习125篇系统化拆解线性模型、决策树、随机森林、梯度提升树、神经网络等算法原理与工程实践覆盖从公式推导到代码实现的全链路内容。音频、图像与视频处理理论与实战81篇涵盖FFmpeg多媒体处理、audio_shop开源工具、ComfyUI-WanVideoWrapper视频生成等实用技术从基础操作到高级应用一应俱全。UI窗体程序设计实战78篇深入讲解UI设计、动态窗体生成、游戏UI框架设计等实战技巧提供从配置到编码的完整解决方案。智算菩萨以代码为经以算法为纬在人工智能的星辰大海中做你前行路上最可靠的导航者。本人最常用AI工具为AIGCBAR。本文只是基本方法论不代表具体的编程。后期我会出实战项目的APP编程。一、为什么选择Python做手机APP在移动开发领域Java/KotlinAndroid和Swift/Objective-CiOS是原生首选但Python凭借其简洁语法、丰富的库生态和跨平台能力正在成为快速原型开发、数据科学工具、轻量级业务应用的有力竞争者。你不需要同时学习两套原生语言就能用熟悉的Python写出能在手机上运行的程序。Python转手机APP的常见场景包括企业内部工具、教育类应用、物联网控制面板、简单游戏、数据可视化仪表盘等。对于追求极致性能或复杂交互的大型应用原生开发仍是更好的选择但Python方案足以覆盖80%的轻量需求。二、主流Python手机开发框架对比目前成熟的方案主要有四个方向每个都有独特的哲学和适用场景。2.1 Kivy Buildozer最成熟的跨平台方案Kivy是一个开源的Python库专门用于开发多点触控应用。它使用自己的UI引擎基于OpenGL ES 2不依赖原生控件因此可以做到真正的跨平台同一套代码编译为Android APK、iOS IPA、Windows exe、macOS dmg、Linux AppImage。核心特点使用KV语言描述界面布局类似CSSXML的结合体内置丰富的控件按钮、滑块、标签、文本输入、滚动视图等支持手势识别、动画、多线程、网络请求通过Buildozer或python-for-android打包为APK适合人群追求一次编写多平台运行不要求UI与原生风格完全一致。2.2 BeeWare原生UI的Python方案BeeWare的理念是“用Python写原生应用”。它通过Toga库提供原生控件Android上使用Java控件iOS上使用Objective-C控件让应用看起来和用起来都像原生应用。打包工具是Briefcase。核心特点每个平台的UI都是原生组件性能和体验更好支持Android、iOS、Windows、macOS、Linux、Web开发流程更接近原生需要安装对应平台的SDK社区相对较小文档不如Kivy完善适合人群对UI原生感有要求愿意为每个平台做少量适配。2.3 Chaquopy将Python嵌入Android原生项目如果你已经有一个Android原生项目Java/Kotlin只想在部分功能中使用Python比如调用机器学习模型、执行脚本Chaquopy是最佳选择。它是一个Gradle插件允许你在Android项目中混合使用Java/Kotlin和Python代码。核心特点不是独立开发框架而是原生项目的补充Python代码运行在独立的解释器中可以与Java互相调用支持NumPy、SciPy、TensorFlow Lite等科学计算库打包时自动将Python解释器和依赖打包进APK适合人群已有原生Android项目需要集成Python功能。2.4 PyqtdeployQt生态的延伸如果你熟悉PyQt或PySide可以使用pyqtdeploy将Qt应用打包到移动平台。Qt本身是跨平台C框架PyQt是其Python绑定。pyqtdeploy负责将Python代码和Qt库一起编译为原生二进制。核心特点UI基于Qt功能强大支持复杂界面打包过程复杂需要交叉编译工具链对Android支持较好iOS支持有限适合已有PyQt桌面应用想移植到移动端的情况适合人群PyQt熟练用户愿意处理编译问题。三、环境搭建从零开始准备开发工具我们以最流行的KivyBuildozer方案为例演示完整流程。假设你的开发机是Ubuntu 20.04/22.04推荐或macOSWindows也可以但需要额外配置WSL。3.1 安装Python及相关工具# 更新包管理器sudoaptupdatesudoaptupgrade-y# 安装Python3和pipsudoaptinstallpython3 python3-pip python3-venv-y# 安装Kivy依赖用于桌面测试sudoaptinstalllibsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev\pkg-config libgl1-mesa-dev libgles2-mesa-dev\libgstreamer1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good\libmtdev-dev libx11-dev libxext-dev libxrandr-dev libxi-dev\libfreetype6-dev libjpeg-dev libpng-dev libtiff-dev\libwebp-dev libxml2-dev libxslt1-dev libssl-dev-y3.2 创建虚拟环境并安装Kivymkdirmyappcdmyapp python3-mvenv venvsourcevenv/bin/activate pipinstallkivy[base]kivy_examples测试安装是否成功# test_kivy.pyfromkivy.appimportAppfromkivy.uix.labelimportLabelclassTestApp(App):defbuild(self):returnLabel(textHello Kivy!)if__name____main__:TestApp().run()运行python test_kivy.py应该会弹出一个窗口显示“Hello Kivy!”。3.3 安装打包工具BuildozerBuildozer是Kivy官方推荐的Android打包工具它会自动下载Android SDK、NDK、Python-for-Android等依赖并构建APK。pipinstallbuildozer初始化Buildozer项目buildozer init这会在当前目录生成buildozer.spec文件包含所有打包配置。四、实战开发一个完整的计算器APP为了演示从代码到APK的全过程我们开发一个具有基本四则运算功能的计算器。该应用将包含数字按钮0-9运算符按钮、-、×、÷等于、清除、退格按钮结果显示区4.1 创建项目结构calculator_app/ ├── main.py # 主程序 ├── calculator.kv # Kivy语言界面布局 └── buildozer.spec # 打包配置由buildozer init生成4.2 编写界面布局calculator.kvKivy使用KV语言声明式地描述UI与代码分离便于维护。# calculator.kv BoxLayout: orientation: vertical padding: 10 spacing: 10 # 结果显示区域 TextInput: id: display text: 0 font_size: 48 readonly: True halign: right size_hint_y: 0.2 background_color: (0.95, 0.95, 0.95, 1) # 按钮网格 GridLayout: cols: 4 spacing: 5 size_hint_y: 0.8 # 第一行 Button: text: C on_press: app.clear() Button: text: ← on_press: app.backspace() Button: text: % on_press: app.append(%) Button: text: ÷ on_press: app.append(/) # 第二行 Button: text: 7 on_press: app.append(7) Button: text: 8 on_press: app.append(8) Button: text: 9 on_press: app.append(9) Button: text: × on_press: app.append(*) # 第三行 Button: text: 4 on_press: app.append(4) Button: text: 5 on_press: app.append(5) Button: text: 6 on_press: app.append(6) Button: text: - on_press: app.append(-) # 第四行 Button: text: 1 on_press: app.append(1) Button: text: 2 on_press: app.append(2) Button: text: 3 on_press: app.append(3) Button: text: on_press: app.append() # 第五行0占两列小数点等于 Button: text: 0 on_press: app.append(0) Button: text: . on_press: app.append(.) Button: text: on_press: app.calculate() background_color: (0.2, 0.6, 1, 1)4.3 编写主逻辑main.pyimportrefromkivy.appimportAppfromkivy.uix.boxlayoutimportBoxLayoutfromkivy.propertiesimportStringPropertyclassCalculatorApp(App):expressionStringProperty(0)defbuild(self):self.title计算器returnBoxLayout()defappend(self,value):# 如果当前显示为0且输入的是数字替换0ifself.expression0andvalue.isdigit():self.expressionvalueelse:# 防止连续输入运算符ifvaluein-*/%andself.expression[-1]in-*/%:returnself.expressionvaluedefclear(self):self.expression0defbackspace(self):iflen(self.expression)1:self.expressionself.expression[:-1]else:self.expression0defcalculate(self):try:# 替换显示符号为Python运算符exprself.expression.replace(×,*).replace(÷,/)# 使用eval计算注意生产环境应使用安全方法resulteval(expr)# 处理浮点数显示ifisinstance(result,float)andresult.is_integer():resultint(result)self.expressionstr(result)except:self.expression错误if__name____main__:CalculatorApp().run()4.4 在桌面测试python main.py应该看到计算器窗口可以正常点击计算。五、打包为Android APK5.1 配置buildozer.spec打开buildozer.spec修改关键配置项[app] # 应用名称 title 计算器 # 包名唯一标识建议用域名倒置 package.name calculator package.domain org.example # 源代码目录 source.dir . # 入口文件 source.main main.py # 版本号 version 1.0.0 # 最低Android API级别建议21以上 android.minapi 21 android.api 31 android.ndk 23b # 权限如果需要网络、存储等 android.permissions INTERNET # 图标可选 # icon.filename icon.png # 是否启用Cython加速 android.cython 0 # 需要的Python模块 requirements python3,kivy # 其他高级选项 # android.gradle_dependencies 5.2 执行打包命令buildozer android debug第一次运行会自动下载Android SDK、NDK、Python-for-Android等约2-5GB请确保网络稳定磁盘空间充足。整个过程可能持续30分钟到1小时取决于机器性能。打包完成后APK文件位于bin/目录下如calculator-1.0.0-debug.apk。5.3 常见问题及解决问题1下载依赖失败手动下载所需文件并放到~/.buildozer/android/platform/下或使用代理。问题2NDK版本不匹配在buildozer.spec中明确指定android.ndk 23b与API 31匹配。问题3缺少某些系统库安装sudo apt install libncurses5 libncurses5-dev等。问题4打包过程中内存不足增加交换空间sudo fallocate -l 4G /swapfile sudo mkswap /swapfile sudo swapon /swapfile。六、深入优化让应用更专业6.1 自定义图标和启动画面准备一个512x512的PNG图标命名为icon.png放在项目根目录在buildozer.spec中取消注释icon.filename icon.png。启动画面Splash Screen可以通过在main.py中添加from kivy.uix.screenmanager import ScreenManager等实现或者使用Kivy的Window.set_icon()方法。6.2 使用SQLite本地存储Kivy应用可以正常使用Python标准库sqlite3适合存储用户设置、历史记录等。例如importsqlite3fromkivy.clockimportClockclassCalculatorApp(App):definit_db(self):connsqlite3.connect(history.db)conn.execute(CREATE TABLE IF NOT EXISTS history (expression TEXT, result TEXT))conn.close()defsave_history(self,expr,result):connsqlite3.connect(history.db)conn.execute(INSERT INTO history VALUES (?, ?),(expr,result))conn.commit()conn.close()注意在Android上数据库文件会保存在应用私有目录无需额外权限。6.3 添加振动反馈通过Kivy的plyer库可以调用设备功能振动、通知、传感器等pipinstallplyer在代码中fromplyerimportvibrator vibrator.vibrate(0.1)# 振动100毫秒需要在buildozer.spec中添加权限android.permissions VIBRATE6.4 发布到应用商店发布Release版APK需要签名。Buildozer默认使用debug签名发布时需要生成自己的密钥keytool-genkey-v-keystoremy-release-key.keystore-aliasmy_alias-keyalgRSA-keysize2048-validity10000然后在buildozer.spec中配置android.release True android.keystore /path/to/my-release-key.keystore android.keystore.alias my_alias android.keystore.password your_password android.keystore.alias.password your_alias_password最后执行buildozer android release生成签名的APK。七、其他方案快速入门7.1 BeeWare实战要点安装Briefcasepipinstallbriefcase创建项目briefcase new选择“Python GUI project”框架选“Toga”。生成的代码结构如下myapp/ ├── src/ │ └── myapp/ │ ├── __init__.py │ ├── app.py │ └── resources/ ├── pyproject.toml └── ...编写一个简单计数器# src/myapp/app.pyimporttogafromtoga.style.packimportCOLUMN,ROW,PackclassMyApp(toga.App):defstartup(self):self.counter0main_boxtoga.Box(stylePack(directionCOLUMN,padding10))labeltoga.Label(0,stylePack(padding(0,5)))buttontoga.Button(1,on_pressself.increment,stylePack(padding5))main_box.add(label)main_box.add(button)self.main_windowtoga.MainWindow(titleself.name)self.main_window.contentmain_box self.main_window.show()defincrement(self,widget):self.counter1self.main_window.content.children[0].textstr(self.counter)defmain():returnMyApp(计数器,org.example.counter)打包Androidcdmyapp briefcase create android briefcase build android briefcase package android7.2 Chaquopy集成示例在已有Android项目中集成Python步骤在项目级build.gradle添加buildscript { repositories { maven { url https://chaquo.com/maven } } dependencies { classpath com.chaquo.python:gradle:15.0.1 } }在应用模块build.gradle应用插件并配置apply plugin: com.android.application apply plugin: com.chaquo.python android { ... defaultConfig { ... python { buildPython /usr/bin/python3 pip { install numpy } } ndk { abiFilters armeabi-v7a, arm64-v8a, x86, x86_64 } } }在Java代码中调用Pythonimportcom.chaquo.python.Python;importcom.chaquo.python.android.AndroidPlatform;if(!Python.isStarted()){Python.start(newAndroidPlatform(this));}PythonpyPython.getInstance();py.getModule(my_script).callAttr(my_function,arg1,arg2);7.3 Pyqtdeploy注意事项这是一个相对小众且复杂的方案适合有Qt经验的开发者。基本流程用PyQt5编写应用安装pyqtdeploy创建.pdy项目文件指定源代码、Qt模块、依赖编译为C代码使用Qt的Android工具链交叉编译为APK由于需要手动配置sysroot、交叉编译器建议直接参考官方文档。八、性能优化与调试技巧8.1 减少APK体积只打包需要的Python模块在buildozer.spec的requirements中精确列出避免kivy[full]等大包。使用Cython编译设置android.cython 1但可能增加编译时间。压缩资源文件图片使用WebP格式音频用OGG。使用ProGuard混淆仅Java代码Python代码无法混淆。8.2 调试Android应用使用adb logcat查看日志adb logcat|greppython在Kivy中开启调试模式from kivy.config import Config; Config.set(kivy, log_level, debug)使用stderr输出import sys; print(debug, filesys.stderr)8.3 性能瓶颈常见原因UI卡顿避免在主线程做耗时操作使用Clock.schedule_once或threading。内存泄漏Kivy的Clock回调要及时取消ScreenManager中的屏幕记得清理。启动慢减少导入的模块数量使用延迟加载。九、发布与分发9.1 应用商店上线Google Play需要注册开发者账号$25一次性费用上传签名的Release APK或AAB推荐AAB格式。注意Android 14API 34要求targetSdkVersion为34以上。国内应用商店华为、小米、OPPO、vivo等各有要求通常需要软著、安全检测报告等。企业内部分发直接提供APK文件下载或使用MDM工具。9.2 iOS打包说明Kivy也支持iOS打包但需要macOS和Xcode。使用kivy-ios工具链pipinstallkivy-ios toolchain build python3 kivy toolchain create MyApp ~/myapp toolchain update MyAppopenMyApp-ios/MyApp.xcodeproj然后在Xcode中配置签名、证书打包为IPA。十、总结与展望Python手机开发已经不再是玩具Kivy、BeeWare等框架让普通Python开发者也能进入移动应用领域。虽然性能不如原生但对于数据展示、表单录入、简单游戏等场景完全够用。随着WebAssembly和Flutter等技术的兴起未来Python可能通过Pyodide等方式在移动端获得更多可能性。建议初学者从Kivy开始先做出一个能用的APK再根据需求选择更专业的方案。记住工具只是手段解决问题的思路才是核心。现在你可以打开终端开始你的第一个Python手机APP了。