阅读须知我的所有文章免费。若在阅读时遇到VIP限制无法显示可私信联系我在 PyCharm 中完成从桌面端到移动端的打包是 Python 开发者实现跨平台交付的核心技能。本文梳理了 EXE、APK、IPA 三种格式的标准化打包流程修正了原稿中的环境误区与操作漏洞补充了关键避坑细节确保全程在 PyCharm 内可稳定复现。⚠️核心前置提醒移动端打包不能直接用原生 Python 代码必须使用 Kivy/Beeware 等跨平台框架重写 GUI原生的tkinter、PyQt无法适配安卓/iOSiOS 打包仅限 macOSWindows 无任何合规方案可生成 IPA不要尝试第三方“Windows 打 iOS”工具均为无效或恶意软件Python 版本严格限制Kivy Buildozer 组合仅支持Python 3.8–3.113.12 存在兼容性问题建议在 PyCharm 中创建专用虚拟环境所有命令均在 PyCharm 终端执行无需切换外部命令行确保环境与解释器一致 一、电脑端 EXE/App 打包Windows / macOS 通用核心工具PyInstallerPyCharm 终端一键操作零额外配置1. 安装 PyInstaller在 PyCharm 终端执行pip install pyinstaller2. 标准打包命令以main.py为例main需替换为自己的pyinstaller -F -w --name MyApp main.py表格参数作用注意事项-F打包为单文件体积较大启动稍慢适合分发-w隐藏控制台窗口仅适用于 GUI 程序脚本程序禁用--name自定义输出文件名避免中文命名防止路径报错--iconapp.ico设置应用图标Windows 用.icomacOS 用.icns3. 输出文件定位Windowsdist/MyApp.exe双击运行无需 Python 环境macOSdist/MyApp.app双击运行或终端./dist/MyApp.app/Contents/MacOS/MyAppbuild/文件夹为临时缓存可直接删除不影响可执行文件避坑提示若打包后运行闪退去掉-w参数重新打包通过控制台查看报错信息90% 的闪退源于缺失依赖或未正确包含资源文件可通过--add-data参数补充。 二、移动端打包通用准备必读框架选择推荐Kivy Buildozer生态成熟、文档完善适配安卓/iOS中文乱码解决方案Kivy 默认不带中文字体禁止硬编码 Windows 字体路径移动端无该路径需将字体文件放入项目资源目录使用相对路径加载虚拟环境隔离在 PyCharm 中为移动端打包创建独立虚拟环境避免与桌面端依赖冲突。 三、安卓 APK 打包Windows / macOS 通用1. 编写移动端适配代码含中文修复from kivy.app import App from kivy.uix.label import Label from kivy.core.text import LabelBase import os # 使用项目内字体兼容全平台 font_path os.path.join(os.path.dirname(__file__), assets, msyh.ttc) LabelBase.register(nameCustomFont, fn_regularfont_path) class MyApp(App): def build(self): return Label( textPython 跨平台应用, font_nameCustomFont, font_size30 ) if __name__ __main__: MyApp().run()2. 安装依赖严格按顺序pip install kivy2.3.0 pip install buildozer pip install cython0.29.37 # Buildozer 强依赖指定版本 Cython3. 初始化并修改配置buildozer init打开生成的buildozer.spec必改项title 你的应用名称package.name com.yourname.app包名唯一不可含中文/特殊字符android.accept_sdk_license True自动同意 SDK 协议避免打包中断source.include_exts ttf,ttc,png,jpg包含字体与资源文件4. 一键打包 APKbuildozer android debug首次打包自动下载 Android SDK/NDK约 2–3GB耗时 10–30 分钟。成功后 APK 位于bin/目录文件名格式为{package.name}-{version}-armeabi-v7a-debug.apk安装到手机开启 USB 调试通过数据线或文件传输安装无需 Root。⚠️Windows 专属注意Windows 下 Buildozer 依赖 WSL2 或 Docker若未配置会直接报错。建议优先使用 macOS/Linux 打包或在 PyCharm 中配置 WSL2 远程解释器。 四、iOS IPA 打包仅 macOS Xcode1. 环境准备Mac App Store 安装最新版 Xcode打开一次并完成命令行工具安装PyCharm 终端执行pip install kivy-ios pip install cookiecutter2. 构建 Kivy iOS 工具链toolchain build kivy此步骤编译 Kivy 及依赖库为 iOS 静态库耗时 30–60 分钟勿中断。3. 生成 Xcode 工程toolchain create MyApp /path/to/your/main.py生成MyApp.xcodeproj自动包含 Kivy 运行时与资源文件。4. 真机测试与打包用数据线连接 iPhoneXcode 中选择设备为目标签名设置个人 Apple ID 可免费真机调试7天有效期正式上架需付费开发者账号点击 ▶️ 运行按钮自动编译、安装到设备导出 IPAXcode → Product → Archive → Distribute App → Development 导出测试包。iOS 关键限制免费 Apple ID 签名的应用仅本机可用无法分发给他人Kivy-iOS 不支持所有 Python 第三方库仅能使用纯 Python 或已适配 C 扩展的库。✅最佳实践建议桌面端优先用 PyInstaller移动端优先用 Kivy Buildozer所有资源文件字体、图片、配置统一放在assets/目录使用os.path动态拼接路径杜绝绝对路径打包前先在 PyCharm 中本地运行验证确保无误再执行打包命令
