Pyinstaller打包成exe可执行文件

一、Pyinstaller简介

PyInstaller将Python应用程序及其所有依赖项捆绑到一个包中。用户无需安装Python解释器或任何模块即可运行打包的应用程序。 PyInstaller支持Python 2.7和Python 3.4+，并正确捆绑主要的Python包，如numpy，PyQt，Django，wxPython等。

PyInstaller针对Windows，Mac OS X和GNU / Linux进行了测试。但是，它不是交叉编译器：制作Windows应用程序，在Windows中运行PyInstaller ; 制作一个GNU / Linux应用程序，你可以在GNU / Linux等中运行它 .PyInstaller已成功用于AIX，Solaris和FreeBSD，但没有针对它们进行测试。

二、Pyinstaller安装

Pyinstaller官网： link

环境： windows10，python3.7.3(尽量不要使用python3.6版本，打包时会遇到很多问题，允许情况下请升级python)
安装： pip install pyintaller

当本地已安装旧版本；版本更新：pip install --upgrade pyinstaller

windows：
Windows上运行PyInstaller还需要PyWin32或者pypiwin32，其中pypiwin32在你安装PyInstaller的时候会自动安装。

三、参数介绍

参数	说明
-F, –onefile	打包一个单个文件，如果你的代码都写在一个.py文件的话，可以用这个，如果是多个.py文件就别用
-D, –onedir	打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，我个人比较推荐这样，代码易于维护
-K, –tk	在部署时包含 TCL/TK
-a, –ascii	不包含编码.在支持Unicode的python版本上默认包含所有的编码.
-d, –debug	产生debug版本的可执行文件
-w,–windowed,–noconsole	使用Windows子系统执行.当程序启动的时候不会打开命令行(只对Windows有效)
-c,–nowindowed,–console	使用控制台子系统执行(默认)(只对Windows有效) pyinstaller -c xxxx.py pyinstaller xxxx.py --console
-s,–strip	可执行文件和共享库将run through strip.注意Cygwin的strip往往使普通的win32 Dll无法使用.
-X, –upx	如果有UPX安装(执行Configure.py时检测),会压缩执行文件(Windows系统中的DLL也会)(参见note)
-o DIR, –out=DIR	指定spec文件的生成目录,如果没有指定,而且当前目录是PyInstaller的根目录,会自动创建一个用于输出(spec和生成的可执行文件)的目录.如果没有指定,而当前目录不是PyInstaller的根目录,则会输出到当前的目录下.
-p DIR, –path=DIR	设置导入路径(和使用PYTHONPATH效果相似).可以用路径分割符(Windows使用分号,Linux使用冒号)分割,指定多个目录.也可以使用多个-p参数来设置多个导入路径，让pyinstaller自己去找程序需要的资源
–icon=<FILE.ICO>	将file.ico添加为可执行文件的资源(只对Windows系统有效)，改变程序的图标 pyinstaller -i ico路径 xxxxx.py
–icon=<FILE.EXE,N>	将file.exe的第n个图标添加为可执行文件的资源(只对Windows系统有效)
-v FILE, –version=FILE	将verfile作为可执行文件的版本资源(只对Windows系统有效)
-n NAME, –name=NAME	可选的项目(产生的spec的)名字.如果省略,第一个脚本的主文件名将作为spec的名字
–key	pyi会存储字节码，指定加密字节码的key
–exclude-module	需要排除的module； pyi会分析出很多相互关联的库，但是某些库对用户来说是没用的，可以用这个参数排除这些库，有助于减少生成文件的大小

四、打包中遇到问题

windows打包代码中使用进程时，需做如下处理

import multiprocessing

if __name__ == '__main__':
    # 当在Windows上打包时，multiprocessing.freeze_support()这行非常必要
    # 在Linux和Mac上打包用不着
    multiprocessing.freeze_support() #只要在你的程序的入口中加上这行代码加上就可以了

打包成功后，运行exe可执行文件有时会提示找不到某些文件

这是因为，打包过程中，不会把静态文件打包进去，比如图片，日志文件啊等等
所有打包完毕后我们需要将静态文件放到程序中路径对应的位置

五、打包案例命令

打包 exe 可执行文件

pyinstaller --onefile --name 打包名字 --icon 图标 --key 秘钥 --exclude-module PyQt5 打包程序主入口路径

打包结果

打包后会在项目目录下生成，build, dist目录，打包名字.spec文件
下次在打包时，直接执行 pyinstaller 打包名字.spec就好

• ./build 存放生成过程的中间文件和日志等信息；
• ./dist 存放最后生成的部署文件。
  我们想要的exe文件就在dist目录下。