Pycharm打包教程：电脑（windows / macos）+ 手机（安卓 / IOS）全流程

全程在 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中的自带字体。其他方法在以下文章中，有兴趣可以看看。

文章：解决Kivy中文乱码问题，附完整可运行方案

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，即可安装测试