在创建了独立应用(自包含该应用的依赖包)之后,还可以使用 PyInstaller 将 Python 程序生成可直接运行的程序,这个程序就可以被分发到对应的 Windows 或 Mac OS X 平台上运行。
安装 PyInstalle
Python 默认并不包含 PyInstaller 模块,因此需要自行安装 PyInstaller 模块。
安装 PyInstaller 模块与安装其他 Python 模块一样,使用 pip 命令安装即可。在命令行输入如下命令:
pip install pyinstaller
强烈建议使用 pip 在线安装的方式来安装 PyInstaller 模块,不要使用离线包的方式来安装,因为 PyInstaller 模块还依赖其他模块,pip 在安装 PyInstaller 模块时会先安装它的依赖模块。
运行上面命令,应该看到如下输出结果:
Successfully installed pyinstaller-x.x.x
其中的 x.x.x 代表 PyInstaller 的版本。
在 PyInstaller 模块安装成功之后,在 Python 的安装目录下的 Scripts(D:\Python\Python36\Scripts)
目录下会增加一个 pyinstaller.exe 程序,接下来就可以使用该工具将 Python 程序生成 EXE 程序了。
PyInstaller 生成可执行程序
PyInstaller 工具的命令语法如下:pyinstaller 选项 Python 源文件不管这个 Python 应用是单文件的应用,还是多文件的应用,只要在使用 pyinstaller 命令时编译作为程序入口的 Python 程序即可。
PyInstaller工具是跨平台的,它既可以在 Windows平台上使用,也可以在 Mac OS X 平台上运行。
在不同的平台上使用 PyInstaller 工具的方法是一样的,它们支持的选项也是一样的。
PyInstaller 支持的常用选项
表 1 PyInstaller 支持的常用选项
-h,--help | 查看该模块的帮助信息 |
-F,-onefile | 产生单个的可执行文件 |
-D,--onedir | 产生一个目录(包含多个文件)作为可执行程序 |
-a,--ascii | 不包含 Unicode 字符集支持 |
-d,--debug | 产生 debug 版本的可执行文件 |
-w,--windowed,--noconsolc | 指定程序运行时不显示命令行窗口(仅对 Windows 有效) |
-c,--nowindowed,--console | 指定使用命令行窗口运行程序(仅对 Windows 有效) |
-o DIR,--out=DIR | 指定 spec 文件的生成目录。如果没有指定,则默认使用当前目录来生成 spec 文件 |
-p DIR,--path=DIR | 设置 Python 导入模块的路径(和设置 PYTHONPATH 环境变量的作用相似)。也可使用路径分隔符(Windows 使用分号,Linux 使用冒号)来分隔多个路径 |
-n NAME,--name=NAME | 指定项目(产生的 spec)名字。如果省略该选项,那么第一个脚本的主文件名将作为 spec 的名字 |
在表 1 中列出的只是 PyInstaller 模块所支持的常用选项,如果需要了解 PyInstaller 选项的详细信息,则可通过 pyinstaller -h 来查看。
示例 1 :创建一个命令行程序
创建一个 app 目录,
在该目录下创建一个 test_2.py 文件,文件中包含如下代码:
def say_word(word: str = None):
print(word)
pass
if __name__ == '__main__':
say_word('this is test_2 model')
在该目录下创建一个 test_1.py 文件,文件中包含如下代码:
from test_2 import say_word
if __name__ == '__main__':
word = 'hello world'
say_word(word)
接下来使用命令行工具进入到此 app 目录下,执行如下命令:pyinstaller -F test_1.py
执行上面命令,将看到详细的生成过程。当生成完成后,将会在此 app 目录下看到多了一个 dist 目录,并在该目录下看到有一个 app.exe 文件,这就是使用 PyInstaller 工具生成的 EXE 程序。
在命令行窗口中进入 dist 目录下,在该目录执行 app.exe ,将会看到该程序生成如下输出结果:hello world
由于该程序没有图形用户界面,因此如果读者试图通过双击来运行该程序,则只能看到程序窗口一闪就消失了,这样将无法看到该程序的输出结果。
在上面命令中使用了 -F 选项,该选项指定生成单独的 EXE 文件,因此,在 dist 目录下生成了一个单独的大约为 6MB 的 app.exe 文件(在 Mac OS X 平台上生成的文件就叫 app,没有后缀);与 -F 选项对应的是 -D 选项(默认选项),该选项指定生成一个目录(包含多个文件)来作为程序。
下面先将 PyInstaller 工具在 app 目录下生成的 build、dist 目录删除,并将 test_1.spec 文件也删除,
然后使用如下命令来生成 EXE 文件:pyinstaller -D test_1.py
执行上面命令,将看到详细的生成过程。当生成完成后,将会在 app 目录下看到多了一个 dist 目录,并在该目录下看到有一个 app 子目录,在该子目录下包含了大量 .dll 文件和 .pyz 文件,它们都是 app.exe 程序的支撑文件。在命令行窗口中运行该 app.exe 程序,同样可以看到与前一个 app.exe 程序相同的输出结果。
示例 2 : 创建一个 GUI 程序(使用 PyQT5)
示例代码( test_gui.py ):
import sys
# from PyQt5 import QtCore
from PyQt5.QtWidgets import (
QApplication, QMainWindow, QDesktopWidget, QHBoxLayout, QVBoxLayout,
QPushButton, QListView, QLabel, QLineEdit, QWidget
)
from PyQt5.QtCore import Qt
class TBGUISpider(QMainWindow):
def __init__(self):
super(TBGUISpider, self).__init__()
# self.setWindowFlags(QtCore.Qt.WindowMinimizeButtonHint)
self.resize(1200, 800)
# self.setFixedSize(self.width(), self.height())
self._center_display()
self._ini_ui()
self.show()
def _center_display(self):
"""
控制窗口显示在屏幕中心的方法
:return:
"""
# 获得窗口
qr = self.frameGeometry()
# 获得屏幕中心点
cp = QDesktopWidget().availableGeometry().center()
# 显示到屏幕中心
qr.moveCenter(cp)
self.move(qr.topLeft())
def _ini_ui(self):
###########################################
main_widget = QWidget()
self.setCentralWidget(main_widget)
h_box_1 = QHBoxLayout()
# h_box_1.addStretch(2)
btn_login = QPushButton('登录淘宝', self)
btn_login.resize(80, 50)
# btn_login.move(10, 10)
btn_start = QPushButton('开始采集', self)
btn_start.setEnabled(False)
btn_start.resize(80, 50)
# btn_start.move(100, 10)
btn_terminate = QPushButton('结束采集', self)
btn_terminate.setEnabled(False)
btn_terminate.resize(80, 50)
# btn_terminate.move(200, 10)
h_box_1.addWidget(btn_login, 0, Qt.AlignLeft | Qt.AlignTop)
h_box_1.addWidget(btn_start, 0, Qt.AlignLeft | Qt.AlignTop)
h_box_1.addWidget(btn_terminate, 0, Qt.AlignLeft | Qt.AlignTop)
###########################################
h_box_2 = QHBoxLayout()
list_view = QListView(self)
list_view.resize(1200, 500)
h_box_2.addWidget(list_view)
###########################################
h_box_3 = QHBoxLayout()
# lable_search_key = QLabel('关键字', self)
# line_edit_key = QLineEdit()
###########################################
v_box = QVBoxLayout()
# v_box.addStretch(1)
v_box.addLayout(h_box_1)
v_box.addLayout(h_box_2)
v_box.addLayout(h_box_3)
v_box.setStretchFactor(h_box_1, 1)
v_box.setStretchFactor(h_box_2, 8)
v_box.setStretchFactor(h_box_3, 1)
self.centralWidget().setLayout(v_box)
pass
if __name__ == '__main__':
app = QApplication(sys.argv)
form = TBGUISpider()
form.show()
app.exec_()
直接运行 python 程序结果:
使用 pyinstaller -F test_gui.py
直接运行结果截图:
会发现有个 命令行 窗口,可以使用 -w 参数 屏蔽 命令行窗口:pyinstaller -w -F test_gui.py
生成的文件比较大,这个简单的 GUI 就有 30多M