官网
https://github.com/pyinstaller/pyinstaller
http://www.pyinstaller.org/
安装
稳定版本(反而有bug)
➜ pip3 install pyinstaller
➜ pyinstaller --version
3.2.1
dev版本(本文写作是用它)
➜ git clone https://github.com/pyinstaller/pyinstaller.git
➜ cd pyinstaller
➜ python3 setup.py install
➜ pyinstaller --version
3.3.dev0+964547c
hello.py 的内容
# -*- coding: utf-8 -*-
"""第一个程序"""
from PyQt5 import QtWidgets
import sys
app = QtWidgets.QApplication(sys.argv)
first_window = QtWidgets.QWidget()
first_window.resize(400, 300)
first_window.setWindowTitle("我的第一个程序")
first_window.show()
sys.exit(app.exec_())
mac打包
简单打包
https://pyinstaller.readthedocs.io/en/stable/usage.html#general-options
➜ sudo pyinstaller -w -y hello.py
完成后的目录
├── __pycache__
├── build
│ └── hello
├── dist
│ ├── hello
│ └── hello.app
│ └── Contents
│ ├── Frameworks
│ ├── Info.plist
│ ├── MacOS
├── hello.py
└── hello.spec
会多出3个目录pycache, build, dist和一个文件hello.spec
其中的 dist目录下, 有两份输出
dist/hello/ unix的可执行目录(mac下也能运行)
dist/hello.app macOS的程序包(其实也是一个目录)
spec文件
spec文件的作用是什么呢？PyInstaller通过执行spec文件中的内容来生成app，有点像makefile。正常使用中我们是不需要管spec文件的，但是下面几种情况需要修改spec文件：
- 需要打包资源文件
- 需要include一些PyInstaller不知道的run-time库
- 为可执行文件添加run-time 选项
- 多程序打包
也可以通过下面命令生成spec文件
pyi-makespec hello.py
通过下面命令使用spec文件
sudo pyinstaller hello.spec
当你使用了spec文件, 那么命令行里的参数只剩下下面的几个还有效, 其它的都被spec文件里的参数覆盖了:
| 参数 | 备注 |
|---|---|
| --upx-dir UPX_DIR | Path to UPX utility (default: search the execution path) |
| --distpath DIR | Where to put the bundled app (default: ./dist) |
| --workpath WORKPATH | Where to put all the temporary work files, .log, .pyz and etc. (default: ./build) |
| -y, --noconfirm | Replace output directory (default: SPECPATH/dist/SPECNAME) without asking for confirmation |
| -a, --ascii | Do not include unicode encoding support (default: included if available) |
spec文件的配置
# -*- mode: python -*-
block_cipher = None
a = Analysis(['main.py'],
pathex=['/Users/kirin/workspaces/gitlab/pqbox'],
binaries=[],
datas=[],
hiddenimports=[],
hookspath=[],
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher)
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
exe = EXE(pyz,
a.scripts,
exclude_binaries=True,
name='main',
debug=False,
strip=False,
upx=True,
console=True )
coll = COLLECT(exe,
a.binaries,
a.zipfiles,
a.datas,
strip=False,
upx=True,
name='main')
spec文件中主要包含4个class: Analysis, PYZ, EXE和COLLECT.
- Analysis以py文件为输入，它会分析py文件的依赖模块，并生成相应的信息
- PYZ是一个.pyz的压缩包，包含程序运行需要的所有依赖
- EXE根据上面两项生成
- COLLECT生成其他部分的输出文件夹，COLLECT也可以没有
要看更详细的文档在
https://pyinstaller.readthedocs.io/en/stable/usage.html#general-options
https://pyinstaller.readthedocs.io/en/stable/spec-files.html
windows打包
windows下要加--path参数来找到pyqt的dll
pyinstaller --path C:\Users\Administrator\AppData\Local\Programs\Python\Python35-32\Lib\site-packages\PyQt5\Qt\bin -y -w hello.py
