天天看点

Pyinstaller打包成exe可执行文件一、Pyinstaller简介二、Pyinstaller安装三、参数介绍四、打包中遇到问题五、打包案例命令

Pyinstaller模块

  • 一、Pyinstaller简介
  • 二、Pyinstaller安装
  • 三、参数介绍
  • 四、打包中遇到问题
    • windows打包代码中使用进程时,需做如下处理
    • 打包成功后,运行exe可执行文件有时会提示找不到某些文件
  • 五、打包案例命令
    • 打包 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目录下。