全程在 PyCharm 内操作,覆盖电脑端可执行文件、安卓APK、iOS IPA 打包
目录
[一、电脑端 EXE 打包(windows / macOS 通用)](#一、电脑端 EXE 打包(windows / macOS 通用))
[三、安卓 APK 打包(Windows / macOS 通用)](#三、安卓 APK 打包(Windows / macOS 通用))
[四、iOS IPA 打包(仅 Mac 可用)](#四、iOS IPA 打包(仅 Mac 可用))
一、电脑端 EXE 打包(windows / macOS 通用)
核心工具:PyInstaller,PyCharm 终端一键操作,无需额外配置,支持 Windows 和 macOS。
**1.**安装 PyInstaller
打开 PyCharm 终端,输入以下命令:
pip install pyinstaller
**2.**核心打包命令
假设程序文件名为 main.py,输入命令:
pyinstaller -F -w main.py
参数说明(新手必看):
- -F:打包成单个可执行文件
- -w:打包后运行不显示黑色命令行窗口
**3.**找到生成的可执行文件
打包完成后,在 PyCharm 的项目目录中,会自动生成 2 个文件夹:
dist/:核心文件夹,里面就是可直接运行的文件
Windows:dist/main.exe(双击直接运行,无需装 Python)
macOS:dist/main(双击运行,或终端执行 ./main)
build/:临时打包文件,可直接删除,不影响运行
二、手机打包准备(必看)
重要提醒:Python 代码不能直接打包成手机 APP ,必须借助第三方框架,建议采用最稳定、通用的 Kivy + Buildozer 组合,适配安卓和 iOS。
核心限制:
安卓:Windows、macOS 都能打包,全程自动化
iOS:必须用 Mac 电脑 + Xcode,Windows 无法打包(苹果系统限制)
三、安卓****APK 打包( Windows / macOS 通用)
**1.**编写手机适配的 GUI 程序(必做)
手机 APP 必须有界面,这里用 Kivy 写一个最简示例:
注:Kivy 默认不携带中文字体,直接渲染中文就会出现方块乱码,这里的办法是直接使用windows中的自带字体。其他方法在以下文章中,有兴趣可以看看。
from kivy.app import App
from kivy.uix.label import Label
from kivy.core.text import LabelBase
# 直接使用 Windows 自带字体
LabelBase.register(name='Microsoft YaHei', fn_regular='C:/Windows/Fonts/msyh.ttc')
class MyApp(App):
def build(self):
return Label(
text="我是手机Python小游戏",
font_name='Microsoft YaHei',
font_size=30
)
if __name__ == '__main__':
MyApp().run()
**2.**安装打包工具 Buildozer
PyCharm 终端输入命令,回车安装:
pip install buildozer
3. 安装 kivy 模块
注:kivy模块目前只适配 python3.7-3.10 ,版本过高会导致安装失败
PyCharm 终端输入命令,回车安装:
pip install kivy
**4.**生成打包配置文件
终端输入以下命令,自动生成 buildozer.spec 配置文件(核心配置,无需手动创建):
buildozer init
**5.**一键打包 APK (关键步骤)
终端输入以下命令,开始打包:
buildozer android debug
注意事项:
- 第一次打包会自动下载 Android SDK、NDK(约 1-3GB)
- 打包成功后,在项目目录的 bin/ 文件夹中,会生成 xxx-0.1-armeabi-v7a-debug.apk 文件
**6.**安装到安卓手机
(1)手机开启「开发者选项」→ 打开「USB 调试」
(2)将 bin/ 文件夹中的 APK 文件,通过微信、QQ 或 USB 传到手机。
(3)手机文件管理器找到 APK 文件,点击安装
**四、**iOS IPA 打包(仅 Mac 可用)
必须用 Mac 电脑 + Xcode,Windows 无法实现(苹果的生态封闭限制),且需要苹果开发者账号
最简步骤(Mac 端操作):
**1.**安装 Xcode
打开 Mac 上的 App Store,搜索「Xcode」,下载安装。
**2.**安装 Kivy 和 iOS 打包工具
打开 PyCharm 终端,输入以下命令:
pip install kivy-ios
**3.**生成 Xcode 工程
终端输入以下命令,生成适配的 Xcode 工程文件:
toolchain build kivy
**4.**打包并安装到 iPhone
(1)打开生成的 Xcode 工程文件(后缀为 .xcodeproj)。
(2)用数据线将 iPhone 连接到 Mac。
(3)点击 Xcode 顶部的「运行」按钮,自动编译、打包并安装到手机。
补充:测试阶段,无需苹果开发者账号,只要 iPhone 登录你的 Apple ID,即可安装测试