用PyInstaller把Python代码打包成单个独立的exe可执行文件

之前就想要把自己的blogstowordpress打开成exe了。一直没去弄。

又看到有人提到python打开成exe的问题。

所以打算现在就去试试。

注：此处之所有选用blogstowordpress，是因为此python脚本够复杂，依赖的模块够多。

如果这个都搞定了，那么其他单个的python文件，和小python项目的打包，就更不成问题了。

1.先去找找，目前主流有哪几种方法。

找到几个名字

cx_freeze

pyinstaller

py2exe

2.关于py2exe和pyinstaller的两者官网：

http://www.py2exe.org/index.cgi/faq

和

http://www.pyinstaller.org/

比较了一下，发现貌似后者更好用。

因为貌似py2exe还需要另外的其他库文件啊啥的，太琐碎。

而pyinstaller：

• 可以只是生成单独的可执行程序
• 且支持的版本也多：2.3到2.7都支持。以及x64也支持
• 也可以自定义图标

所以先去试试pyinstaller。

3.从主页

http://www.pyinstaller.org/

中下载对应的zip包：

https://github.com/downloads/pyinstaller/pyinstaller/pyinstaller-2.0.zip

得到3m+的pyinstaller-2.0.zip，解压，打开cmd，进入对应目录，去安装，结果说不支持：

d:\tmp\dev_tools\python\to_exe\pyinstaller\pyinstaller-2.0>setup.py install
setup.py is not yet supposed to work. please use pyinstaller without installation.

所以算了，还是参考官网文档，一点点折腾吧。

4.参考在线文档：

http://www.pyinstaller.org/export/v2.0/project/doc/manual.html?format=raw

结果说需要pywin32，所以得先去装这个。

5.后来才发现，原来之前已经安装过了：

【已解决】python中出错：importerror: no module named win32com.client

但是要注意的是，import不是pywin32，而是win32com：

6.继续参考：

installing pyinstaller

发现，解压后，就算是安装好了。

7.在一个文件夹中，准备好自己的python程序：

d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress

以备后用。

8.去到pyinstaller.py所在目录，去运行：

可以看到：

当前pyinstaller下面，的确生成了对应的blogstowordpress文件夹：

其下，也有对应的：

都已经生成了对应的exe了：

dist下面，有对应的，exe，pyd，dll等等：

汗，效率也忒高了，我还以为，需要折腾半天才可以呢，囧。。。。

9.先去试试生成的exe，是否满足我们的需求，是否可以独立运行。

不过运行之前，还是去先研究一下对应的参数吧。

看到了：

what to generate:

-f, --onefile

create a single file deployment

-d, --onedir

create a single directory deployment (default)

-o dir, --out=dir

create the spec file in directory. if not specified, and the current directory is installer's root directory, an output subdirectory will be created. otherwise the current directory is used.

-n name, --name=name

optional name to assign to the project (from which the spec file name is generated). if omitted, the basename of the (first) script is used.

很明显，默认用的是-d，所以生成的是带目录的，现在重新去执行一次，使用-f生成单一的文件。

10.删掉旧的。重新运行：

去看看结果。

pyinstaller-2.0\blogstowordpress\build\pyi.win32\blogstowordpress

下面包含很多toc，pkg，pyz等文件：

dist下面，就生成了，所需要的单个exe文件：

但是，注意到了，生成文件中，包含一个警告的文件：

d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\pyinstaller-2.0\blogstowordpress\build\pyi.win32\blogstowordpress\warnblogstowordpress.txt

不知道是否影响程序。

11.去运行单个的exe，看看效果。

结果直接出错：

很明显，还是无法自动导入很多的库啊。

去想办法，添加搜索路径，让其找到对应的库。

12.好像是-p参数：

-p dir, --paths=dir

set base path for import (like using pythonpath). multiple directories are allowed, separating them with the path separator (‘;' under windows, ‘:' under linux), or using this option multiple times.

去试试：

添加上路径后，生成的exe，的确也大了一点，变成4505kb了：

另外，warnblogstowordpress.txt中，的确没了crifanlib，但是还是有一些其他，可能要依赖的库：

比如，其中的pil等库。 

不过，关于pil，我去看了看自己的

d:\tmp\dev_install_root\python27_x64\lib\site-packages

中的确没有，应该是重装python，导致了之前安装好的pil没了。

所以，还是需要自己重新安装一下pil的。

12.关于安装pil的过程，详见：

【记录】下载和安装python的第三方图像处理的库：pil(python imaging library)

13.然后再去

d:\tmp\dev_install_root\python27_x64\lib\site-packages

确认一下，果然有了pil了。

然后此处，删掉旧的，重新执行一次：

虽然结果警告中，也还是有pil：

但是很明显，只是pil模块内部的一些小问题罢了，不理会。

生成的exe，的确又变大了，4748kb：

13.去运行现在的最新的blogstowordpress.exe，看看效果如何。

果然是可以，如期望的一样，去执行了：

加上对应参数，再试试：

的确就是可以正常执行了。

剩下的，就是要拿到别的windows平台上，多测试测试，是否都正常。

14.接着打算再去试试，添加icon图标的事情。

参考官网的参数解释：

-r file[,type[,name[,language]]], –resource=file[,type[,name[,language]]]
add/update resource of the given type, name and language from file to the final executable. file can be a data file or an exe/dll. for data files, atleast type and name need to be specified, language defaults to 0 or may be specified as wildcard * to update all resources of the given type and name. for exe/dll files, all resources from file will be added/updated to the final executable if type, name and language are omitted or specified as wildcard *.multiple resources are allowed, using this option multiple times.

去运行：

可以看到，其自动会把icon添加到当前已有的exe中，然后可以看到对应的，带图标的exe的效果：

总结

pyinstaller，的确非常好用啊。感谢作者们。

简单总结其使用方法：

生成单一的exe文件：

pyinstaller.py -f ..\blogstowordpress\blogstowordpress.py

添加必要的搜索路径：

pyinstaller.py -f -p d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\crifan;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\crifan\blogmodules;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\thirdparty;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\thirdparty\chardet; ..\blogstowordpress\blogstowordpress.py

添加必要的搜索路径，且带图标：

pyinstaller.py -f -p d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\crifan;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\crifan\blogmodules;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\thirdparty;d:\tmp\tmp_dev_root\python\tutorial_summary\make_exe\blogstowordpress\libs\thirdparty\chardet; -i ..\blogstowordpress\blogstowordpress.ico ..\blogstowordpress\blogstowordpress.py

需要注意的是：

1.检查生成的

pyinstaller-2.0\xxx\build\pyi.win32\xxx\warnxxx.txt

(xxx是你的项目名）

中，是否缺少了必要的模块。

如果有缺少的，那么去如上所述，添加必要的搜素路径，使得pyinstaller在运行时，可以找到对应的模块并集成进来。

2.此处我这里没有upx，暂时没去折腾。

估计是用upx去压缩，压缩后所生成的exe文件的大小，会小得多。

原文链接：https://www.crifan.com/use_pyinstaller_to_package_python_to_single_executable_exe/