【折腾】使用Pyinstaller发布你的Python！

wei_Y

在那漆黑的夜里，你敲完最后一行代码，按下最后一次ctrl+ s，调试了最后一遍....
完成！一个栩栩如生的程序就这样跑了起来。
同行之间你或许会做成一个setup.py的方式供他人使用，不过你想在不需要python环境的里面使用，这种方法就不行了。
# 平台Windows。
https://github.com/pyinstaller/pyinstaller

安装方法看首页，提供3种安装方法，pip会自动安装依赖的包，其余两种不会自动安装依赖的包，安装时少哪个包安装一下就可以。
安装完成后会把 python目录/Scripts这个目录自动添加到环境目录，这样可以在命令行下直接pyinstaller，如果没有添加手动添加一下也可以。

0. 我的第一个打包程序。

我们新建一个文件，helloPyinstaller.py

print('hello pyinstaller!')
input()

我们在当前文件夹下打开命令行，按住shift然后鼠标右键 ，
很方便，也可以新建一个cmd.cmd内容是cmd.exe都可以快速将目录切换到这个文件夹。

文件名太长的话tab键是个不错的选择。
我们会看到他打包的信息。

224 INFO: PyInstaller: 3.3.dev0-56bf488
225 INFO: Python: 3.4.1rc1
225 INFO: Platform: Windows-7-6.1.7601-SP1
226 INFO: wrote F:\Programming Files\packup\helloPyinstall.spec
228 INFO: UPX is not available.
230 INFO: Extending PYTHONPATH with paths
['F:\\Programming Files\\packup', 'F:\\Programming Files\\packup']
230 INFO: checking Analysis
231 INFO: Building Analysis because out00-Analysis.toc is non existent
231 INFO: Initializing module dependency graph...
244 INFO: Initializing module graph hooks...
246 INFO: Analyzing base_library.zip ...
4168 INFO: Processing pre-find module path hook   distutils
7871 INFO: running Analysis out00-Analysis.toc
7961 INFO: Caching module hooks...
7968 INFO: Analyzing F:\Programming Files\packup\helloPyinstall.py
7972 INFO: Loading module hooks...
7973 INFO: Loading module hook "hook-distutils.py"...
7995 INFO: Loading module hook "hook-xml.py"...
8438 INFO: Loading module hook "hook-encodings.py"...
8580 INFO: Loading module hook "hook-pydoc.py"...
8598 INFO: Looking for ctypes DLLs
8598 INFO: Analyzing run-time hooks ...
8608 INFO: Looking for dynamic libraries
9167 INFO: Looking for eggs
9167 INFO: Using Python library C:\Python34\python34.dll
9167 INFO: Found binding redirects:
[]
9172 INFO: Warnings written to F:\Programming Files\packup\build\helloPyinstall\
warnhelloPyinstall.txt
9215 INFO: checking PYZ
9215 INFO: Building PYZ because out00-PYZ.toc is non existent
9216 INFO: Building PYZ (ZlibArchive) F:\Programming Files\packup\build\helloPyi
nstall\out00-PYZ.pyz
10774 INFO: Building PYZ (ZlibArchive) F:\Programming Files\packup\build\helloPy
install\out00-PYZ.pyz completed successfully.
10791 INFO: checking PKG
10791 INFO: Building PKG because out00-PKG.toc is non existent
10791 INFO: Building PKG (CArchive) out00-PKG.pkg
10814 INFO: Building PKG (CArchive) out00-PKG.pkg completed successfully.
10817 INFO: Bootloader C:\Python34\lib\site-packages\pyinstaller-3.3.dev0_56bf48
8-py3.4.egg\PyInstaller\bootloader\Windows-64bit\run.exe
10818 INFO: checking EXE
10818 INFO: Building EXE because out00-EXE.toc is non existent
10819 INFO: Building EXE from out00-EXE.toc
10819 INFO: Appending archive to EXE F:\Programming Files\packup\build\helloPyin
stall\helloPyinstall.exe
10822 INFO: Building EXE from out00-EXE.toc completed successfully.
10827 INFO: checking COLLECT
10827 INFO: Building COLLECT because out00-COLLECT.toc is non existent
10828 INFO: Building COLLECT out00-COLLECT.toc
12026 INFO: Building COLLECT out00-COLLECT.toc completed successfully.

大部分不用管等他运行完就行了，需要注意的是：

228 INFO: UPX is not available.

UPX是一个将压缩程序，他会极大的压缩文件空间。用了它之后很可能看到体积减少了一半以上的情况，不过没有体积要求尽量不要用。

9172 INFO: Warnings written to F:\Programming Files\packup\build\helloPyinstall\
warnhelloPyinstall.txt

warning信息，大部分是没有用的，如果你去看里面的信息，并且尝试去找一下源文件里怎么写的时候，很可能发现他引入包的时候，
写入类似这样的信息。

import platform
if platform.system() == 'Windows':
    import xxx
else:
    import xxx

或者是

try:
    import xxx
except:
    import xxx

pyinstaller 在找的时候会尝试全部引入打包，因为不是当前平台的或者可代替的所以没安装找不到会引起一些警告。


打包完成呢，你会看到3个文件夹(或两个)，一个spec文件被创建了，build文件夹包含了pyinstaller分析你的程序时的临时文件，
dist文件夹是打包的结果。

继续深入，一个简单的hello pyinstaller，就给打包了10M文件。唯一的一个exe文件就是运行程序啦。


1. 打包成单一文件。
pyinstaller 提供打包成单一文件，-F参数可以让我们打包成一个单一文件。


只需要4.83M，当你的程序逻辑不复杂，引入包基本不会造成错误时推荐这种方法。

2. 去除黑框从我做起。
当你写了一个打飞机游戏，

                               
登录/注册后可看大图

黑框什么的简直又丑又无用。 你只需要-w参数，这样在打包时用到的引擎就是pythonw.exe，而不是python.exe。

3. Debug。
打包的路上少不了调试，你可能会遇到各种版本操作系统五花八门的错误信息，这种时候不用-w也不能捕获到错误信息(一闪而过)，
pyinstaller只是无情的弹出Failed！！！
不过我们可用命令行来捕获，在exe文件目录下打开命令行，运行我们的exe程序，错误信息是标准输出，所以会被命令行捕获到，
这样我们就可以看到出错信息，跟着出错信息一步步找，他少文件就把文件拖到exe目录里。


3. 。
0. 显式的引用模块。否则会找不到喔。
1. 少用UPX，PYQT5如果你尝试用UPX打包，你会发现压缩后的依赖库虽然小了很多，但是会报错。
2. -i 参数可以添加一个图标。
3. -w 可以去除黑框，如果要调试的话请不要带这个参数。
4. 你的资源文件还是需要手动添加到目录里。
5. 如果你发现打包后某些模块丢失，去那个目录里找，少什么就复制过来。
6. 少用中文判断。if xxx='鱼C'时很可能怎么都判断不上。
7. platform判断x64和x86时总会判断成你打包的那个平台的位数。你可以用别的方法，比如判断系统盘里的Program Files (x86)文件夹。
8. 32位python在32位下打包可以兼容大部分平台。
9. 如果没有必要，不必使用最新的python，降版本有时会省去很多烦恼。

alltolove

真复杂啊

小甲鱼

实用！

wei_Y

小甲鱼 发表于 2017-3-7 00:50
实用！

kit1858644

很不錯,  可以教一下spec內容

zkamsk

我用Pyinstaller 打包了pygame 用的指令是 pyinstaller -w -F Game.py 可是打包成的exe只能在自己的电脑上运行，这是为什么？

wei_Y

zkamsk 发表于 2017-7-16 10:17
我用Pyinstaller 打包了pygame 用的指令是 pyinstaller -w -F Game.py 可是打包成的exe只能在自己的电脑上 ...

这个你最好不加任何命令看看报错信息。

zkamsk

wei_Y 发表于 2017-7-17 13:22
这个你最好不加任何命令看看报错信息。

解决了，我得把exe从dist拉到外面的目录，还得把pygame拷贝过来，就可以传给别人使用了

星空下的舞者

这玩意非常有用！

Favor

楼主，我打包好的文件在本机运行没问题，但是拿到其他电脑上报错：无法定位程序输入点ucrtbase.terminate与动态链接库api-ms-win-crt-runtime-1-1-0.dll上。你遇到过这个情况吗？
补充：是-F单文件下出现这个报错，不加-F就没问题，这个是怎么回事儿呢？

wei_Y

Favor 发表于 2017-8-13 09:38
楼主，我打包好的文件在本机运行没问题，但是拿到其他电脑上报错：无法定位程序输入点ucrtbase.terminate与 ...

这个我也不太清楚。
https://www.zhihu.com/question/36384168
https://stackoverflow.com/questi ... -windows-7-machines

春夜喜小雨

我打包出现语法错误，可是程序可以正常运行，什么鬼啊
4084 INFO: Analyzing F:\code\python\simulate_camera01\RUN.py

Syntax error in F:\code\python\simulate_camera01\RUN.py
  File "c:\program files (x86)\python3.5\lib\tokenize.py", line 397, in find_cookie
     raise SyntaxError(msg)
   File "<string>", line None
SyntaxError: invalid or missing encoding declaration