背景
- Python 3.7.7
- PyCharm 2019.1.1
- PyInstaller 4.10
约定
- 下文把工程文件夹暂且称为“入口点目录”(即存放
venv 的目录) - 假设程序入口点所在文件
main.py 也位于“入口点目录”中(如果不在,后续参数中对应修改为实际位置即可)
过程
1) 安装 PyInstaller
在 PyCharm 的 Terminal 执行:
pip install pyinstaller
2) 放入 UPX(此步可选)
用于减小 exe 文件大小。 在 https://github.com/upx/upx/releases 下载解压后,把 upx.exe 放到“入口点目录”。
注:由于 Python 本身的特点,哪怕只有一句 print('Hello world!') ,压缩打包后也在 7M 左右,难以再小了。
3) 放入图标文件(此步可选)
Ico 格式,放到“入口点目录”。 假设文件名为 app.ico 。
4) 打包
在 PyCharm 的 Terminal 执行:
pyinstaller -F -i app.ico main.py
注1:如果不是第一次打包,最好先手动删除“入口点目录”下的 build 和 dist 文件夹在进行此步操作,否则打包过程容易莫名其妙终止,还报 succeed。
注2:常用参数及说明:
pyinstaller [-F|-D] [options] <entry>
必要参数:
-F 打包成单文件
-D 按文件夹打包
<entry> 入口点文件
可选参数:
options:
-i <icon_file> 启用图标及图标文件
[-c|-w]
-c 以控制台运行
-w 以窗口运行
要参见更多参数,在 PyCharm 的 Terminal 执行:
pyinstaller
5) EXE 输出
位于“入口点目录”中的 dist 文件夹下。
注:不要到 build 文件夹去找,它只是个临时目录(受其他语言或开发环境影响容易习惯性地进到这里)。
6) 试运行
双击运行打包完的 exe,初次打包不一定能成功运行。
如果闪退,就在 cmd 里运行它,就不闪退了。通常是因为缺少某些模块导致的,缺少者也会在 cmd 中报出,对应在 PyCharm 中安装,再重新打包就行了(重复从 4 开始的步骤)。
7) 善后工作
把 exe 拷贝到一个单独目录,作为产品目录。现在,生成的 exe 和 main.py 是等价的。若 main.py 有依赖文件,则也需要拷贝过来,并保持目录结构;若 main.py 有运行时产生的文件,则它们也会相对 exe 所在位置而产生。
|