pyinstaller

在创建了独立应用（自包含该应用的依赖包）之后，还可以使用 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 工具的方法是一样的，它们支持的选项也是一样的。

下面先创建一个 app 目录，在该目录下创建一个 app.py 文件，文件中包含如下代码：

1. from say_hello import *
3. def main():
4. print('程序开始执行')
5. print(say_hello('孙悟空'))
6. # 增加调用main()函数
7. if __name__ == '__main__':
8. main()

接下来使用命令行工具进入到此 app 目录下，执行如下命令：

pyinstaller -F app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在此 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app.exe 文件，这就是使用 PyInstaller 工具生成的 EXE 程序。

在命令行窗口中进入 dist 目录下，在该目录执行 app.exe ，将会看到该程序生成如下输出结果：

程序开始执行
孙悟空，您好！

由于该程序没有图形用户界面，因此如果读者试图通过双击来运行该程序，则只能看到程序窗口一闪就消失了，这样将无法看到该程序的输出结果。

在上面命令中使用了-F 选项，该选项指定生成单独的 EXE 文件，因此，在 dist 目录下生成了一个单独的大约为 6MB 的 app.exe 文件（在 Mac OS X 平台上生成的文件就叫 app，没有后缀）；与 -F 选项对应的是 -D 选项（默认选项），该选项指定生成一个目录（包含多个文件）来作为程序。

下面先将 PyInstaller 工具在 app 目录下生成的 build、dist 目录删除，并将 app.spec 文件也删除，然后使用如下命令来生成 EXE 文件。

pyinstaller -D app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app 子目录，在该子目录下包含了大量 .dll 文件和 .pyz 文件，它们都是 app.exe 程序的支撑文件。在命令行窗口中运行该 app.exe 程序，同样可以看到与前一个 app.exe 程序相同的输出结果。

PyInstaller 不仅支持 -F、-D 选项，而且也支持如表 1 所示的常用选项。

通用参数
参数名 描述 说明
-h 显示帮助 无
-v 显示版本号 无
–distpath 生成文件放在哪里 默认：当前目录的dist文件夹内
–workpath 生成过程中的中间文件放在哪里 默认：当前目录的build文件夹内
-y 如果dist文件夹内已经存在生成文件，则不询问用户，直接覆盖 默认：询问是否覆盖
–upx-dir UPX_DIR 指定upx工具的目录 默认：execution path
-a 不包含unicode支持 默认：尽可能支持unicode
–clean 在本次编译开始时，清空上一次编译生成的各种文件 默认：不清除
–log-level LEVEL 控制编译时pyi打印的信息 一共有6个等级，由低到高分别为TRACE DEBUG INFO(默认) WARN ERROR CRITICAL。也就是默认清空下，不打印TRACE和DEBUG信息
与生成结果有关的参数
参数名 描述 说明
-D 生成one-folder的程序（默认） 生成结果是一个目录，各种第三方依赖、资源和exe同时存储在该目录
-F 生成one-file的程序 生成结果是一个exe文件，所有的第三方依赖、资源和代码均被打包进该exe内
–specpath 指定.spec文件的存储路径 默认：当前目录
-n 生成的.exe文件和.spec的文件名 默认：用户脚本的名称，即main.py和main.spec
指定打包哪些资源、代码
参数名 描述 说明
–add-data 打包额外资源 用法：pyinstaller main.py --add-data=src;dest。windows以;分割，linux以:分割
–add-binary 打包额外的代码 用法：同–add-data。与–add-data不同的是，用binary添加的文件，pyi会分析它引用的文件并把它们一同添加进来
-p 指定额外的import路径，类似于使用PYTHONPATH 参见PYTHONPATH
–hidden-import 打包额外py库 pyi在分析过程中，有些import没有正确分析出来，运行时会报import error，这时可以使用该参数
–additional-hooks-dir 指定用户的hook目录 hook用法参见其他，系统hook在PyInstaller\hooks目录下
–runtime-hook 指定用户runtime-hook 如果设置了此参数，则runtime-hook会在运行main.py之前被运行
–exclude-module 需要排除的module pyi会分析出很多相互关联的库，但是某些库对用户来说是没用的，可以用这个参数排除这些库，有助于减少生成文件的大小
–key pyi会存储字节码，指定加密字节码的key 16位的字符串
生成参数
参数名 描述 说明
-d 执行生成的main.exe时，会输出pyi的一些log，有助于查错 默认：不输出pyi的log
-s 优化符号表 原文明确表示不建议在windows上使用
–noupx 强制不使用upx 默认：尽可能使用。
其他
参数名 描述 说明
–runtime-tmpdir 指定运行时的临时目录 默认：使用系统临时目录
Windows和Mac特有的参数
参数名 描述 说明
-c 显示命令行窗口 与-w相反，默认含有此参数
-w 不显示命令行窗口 编写GUI程序时使用此参数有用。
-i 为main.exe指定图标 pyinstaller -i beauty.ico main.py
Windows特有的参数
参数名 描述 说明
–version-file 添加版本信息文件 pyinstaller --version-file ver.txt
-m, --manifest 添加manifest文件 pyinstaller -m main.manifest
-r RESOURCE 请参考原文
–uac-admin 请参考原文
–uac-uiaccess 请参考原文

下面再创建一个带图形用户界面，可以访问 MySQL 数据库的应用程序。

在 app 当前所在目录再创建一个 dbapp 目录，并在该目录下创建 Python 程序，其中 exec_select.py 程序负责查询数据，main.py 程序负责创建图形用户界面来显示查询结果。

exec_select.py 文件包含的代码如下：

1. # 导入访问MySQL的模块
2. import mysql.connector
4. def query_db():
5. # ①、连接数据库
6. conn = conn = mysql.connector.connect(user='root', password='32147',
7. host='localhost', port='3306',
8. database='python', use_unicode=True)
9. # ②、获取游标
10. c = conn.cursor()
11. # ③、调用执行select语句查询数据
12. c.execute('select * from user_tb where user_id > %s', (2,))
13. # 通过游标的description属性获取列信息
14. description = c.description
15. # 使用fetchall获取游标中的所有结果集
16. rows = c.fetchall()
17. # ④、关闭游标
18. c.close()
19. # ⑤、关闭连接
20. conn.close()
21. return description, rows

mian.py 文件包含的代码如下：

1. from exec_select import *
2. from tkinter import *
4. def main():
5. description, rows = query_db()
6. # 创建窗口
7. win = Tk()
8. win.title('数据库查询')
9. # 通过description获取列信息
10. for i, col in enumerate(description):
11. lb = Button(win, text=col[0], padx=50, pady=6)
12. lb.grid(row=0, column=i)
13. # 直接使用for循环查询得到的结果集
14. for i, row in enumerate(rows):
15. for j in range(len(row)):
16. en = Label(win, text=row[j])
17. en.grid(row=i+1, column=j)
18. win.mainloop()
19. if __name__ == '__main__':
20. main()

通过命令行工具进入 dbapp 目录下，在该目录下执行如下命令：

Pyinstaller -F -w main.py

上面命令中的 -F 选项指定生成单个的可执行程序，-w 选项指定生成图形用户界面程序（不需要命令行界面）。运行上面命令，该工具同样在 dbapp 目录下生成了一个 dist 子目录，并在该子目录下生成了一个 main.exe 文件。

直接双击运行 main.exe 程序（该程序有图形用户界面，因此可以双击运行），读者可自行查看运行结果。