Pyinstaller模块
一、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目录下。