Pyinstaller(Python打包为exe文件)


需求分析:

python脚本如果在没有安装python的机器上不能运行,所以将脚本打包成exe文件,降低脚本对环境的依赖性,同时运行更加迅速。

当然打包的脚本似乎不是在所有的win平台下都能使用,win7有一部分不能使用,我在win10能够很好的运行。

准备:  

pyinstaller(http://www.pyinstaller.org/) 首先还是去官网看支持的python版本,不然会很尴尬的

#安装方法1:

#安装pyinstaller和pywin32

#使用一下命令将自动安装两个包,在cmd用pip命令

#pip install -i https://pypi.douban.com/simple/ pyinstaller(豆瓣源)

安装方法二:

pip install pyinstaller   (会自动下载future,pywin32,pyinstaller)

如何使用Pyinstaller

方法一:

1.cmd到/python/scripts 找到pyinstaller.exe

2.输入命令




1


​ pyinstaller.exe -F path:demo.py ​



方法二:

1.进入pyinstaller的解压包,输入命令

2."python pyinstaller.py -F path:demo.py"

从cmd最后一行输出可查找到生成的文件



12468 INFO: Appending archive to EXE D:\Documents\Downloads\PyInstaller-3.2\down
load\dist\download.exe




后记:

1.程序设置自定义图标:pyinstaller -F -i ico_path  py_path 

首先需要下载一张正常的ico,不能用直接修改后缀的。

下载图片:    https://www.easyicon.net

图片改为ico:  http://www.ico.la/

输入命令 pyinstaller -F -i "demo.ico" "main.py"

2.报错提示:

pyinstaller -F -i "demo.ico" "main.py" 命令格式一定是先图标路径,再程序路径。

路径最好为英文,没有中文字符;脚本名称里没有特殊字符如 .

使用utf8编码

图标文件必须是正常格式,不能直接更改后缀。

tuble index out of range ---》pyinstaller版本尚未支持python的版本

3.窗口程序

使用 pyinstaller -F -w  -i ico_path  py_path ,这样脚本不会弹出命令窗,前提是用了GUI库. 

4.导入模块问题

pyinstaller -F -w  -i  --hidden-import queue ico_path  py_path 加上选项


一、安装Pyinstaller

1、安装pywin32


  • 下载安装文件:查找到跟自己适用的python版本及window系统版本匹配的 ​​ pywin32 ​​ ,下载后安装 
  • 使用pip命令安装:pip install pywin32

2、安装Pyinstaller

  • 下载安装文件安装: ​​ 官网 ​
  • 使用pip命令安装:pip install PyInstaller

二、使用Pyinstaller

1、使用下载安装的方式安装的Pyinstaller打包方式

将需要打包的文件放在解压得到的Pyinstaller文件夹中,打开cmd窗口,把路径切换到当前路径打开命令提示行,输入以下内容(最后的是文件名):

  • python pyinstaller.py -F myfile.py

2、使用pip方式安装的Pyinstaller打包方式

打开cmd窗口,把路径切换到文件所在路径(文件随便放在哪里都行)打开命令提示行,输入以下内容(最后的是文件名):

  • pyinstaller -F myfile.py

3、输入参数的含义


  • -F 表示生成单个可执行文件
  • -w 表示去掉控制台窗口,这在GUI界面时非常有用。不过如果是命令行程序的话那就把这个选项删除吧!
  • -p 表示你自己自定义需要加载的类路径,一般情况下用不到
  • -i 表示可执行文件的图标

三、注意事项

  • 文件中使用了第三方库的打包方式

在打包之前务必找到第三方库的包,把包复制到到跟myfile.py同目录下,然后再使用以上2种方式打包,否则会打包失败或者即使打包成功,程序也会闪退。

下面演示一下使用了第三方库的打包方式:

  • 找到第三方库的包,如使用了requests,可以使用查找的方式,找到这个包在哪里,然后把它复制到myfile.py同目录下

Pyinstaller(Python打包为exe文件)_.net

  • 把包文件复制到myfile.py目录下

Pyinstaller(Python打包为exe文件)_python_02


  • 给程序换图标的方法
  • 输入命令中添加一个-i tubiao.ico(图标的相对路径)。如图:

Pyinstaller(Python打包为exe文件)_ico_03

四、exe文件生成

  • 如果程序打包过程没有报错,则会生成3个文件夹(有时候是2个),其中名为dist的文件夹中会有一个myfile.exe文件,运行一下,如果没有问题就打包成功,可以把这个exe文件单独拿出去用,其他的生成的文件夹可以删掉了。

     Pyinstaller(Python打包为exe文件)_ico_04






一、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 的名字

二、pyinstaller爬坑总结

第一次玩pyinstaller,遇到了不少坑,在这里总结一下,以免日后再次掉坑里。

1、先从这次写的工具再说吧,写这个工具的初衷是由于自己手工造数据文件花了很长时间,然后就想着写个工具来解决这个问题(也是想锻炼下自己的代码能力,哈哈哈),利用下班晚上以及周末写了一周大概写出来了。

这个工具是个扫码支付文件生成工具,主要是解决手工造文件数据,有两个功能,一是基础扫码文件生成功能、二是大批量扫码文件生成功能,同时加上了用户auth控制。

在这里提醒大家,在代码里面尽量不要用import,能from.....import....就尽量用这个,因为如果是import的话,在打包的时候,会将整个包都打包到exe里面,没有意义的增大了工具的大小!

大概框架如下:

Pyinstaller(Python打包为exe文件)_ico_05

2、Gui开发完毕后,开始研究pyinstaller,也翻阅了论坛关于pyinstaller的相关用法,这里总结下我的工具的打包步骤

2.1、先下载pyinstaller,我比较懒,就直接用pip install pyinstaller,等待自动安装

2.2、在代码的路径下进行cmd,就直接跳转到该路径的cmd界面,切记路径中不要有中文

Pyinstaller(Python打包为exe文件)_python_06

2.3、先用后台模式生成工具exe,命令为pyinstaller xxxx.py文件,主要目的是为了看报错信息,解决了报错后,再生成完整版的工具

tip:由于我的代码是存在依赖的,即多文件的,而非所有代码都在一个文件中的,所以我在这里没有使用-F,刚开始玩的时候不知道,老是用了-F生成了单文件的,没有生成依赖,老是不成功,各位朋友切记!

下图为命令生成的日志,红框部分则为exe工具生成的路径,如果在日志中只有info信息的话,说明打包过程没有问题

Pyinstaller(Python打包为exe文件)_.net_07

Pyinstaller(Python打包为exe文件)_.net_08

2.4、找到生成的exe文件,运行exe(生成的exe文件都会在dist目录下)

Pyinstaller(Python打包为exe文件)_.net_09

运行时,我遇到了以下的报错信息,是在dist找到相关的图片资源,所以需要把所有关于工具所需的资源(包含图片以及依赖的.py文件都放进dist下的项目目录中)

Pyinstaller(Python打包为exe文件)_ico_10

Pyinstaller(Python打包为exe文件)_python_11

2.5、再次运行exe,此时运行成功,说明工具打包成功

Pyinstaller(Python打包为exe文件)_python_12

2.6、重新生成exe工具,去掉后台模式以及更换掉图标

给大家推荐一个图标获取地址,里面ico蛮多的: ​​ easyicon ​

下载了自己心仪的ico后,用-i+ico路径来替换默认ico,这次重新生成exe工具,命令为pyinstaller -i ico路径 -w xxxx.py

Pyinstaller(Python打包为exe文件)_python_13

再将需要的图片资源和代码文件放到dist下的项目文件夹中

Pyinstaller(Python打包为exe文件)_.net_14


2.7、运行exe,能够打开则表示pyinstaller打包exe成功

Pyinstaller(Python打包为exe文件)_ico_15