前言
本篇文章,详细介绍pyinstaller多种打包过程。去坑,填坑。
一、安装Pyinstaller
1)使用下面的命令即可安装(win10)
pip install pyinstaller
二、使用参数
1采用命令行的方式
1)参数介绍
选项参数 | 参数解释 |
-h | help(帮助信息) |
-v | version(版本号) |
-c | 显示命令行窗口 |
-w | 不显示命令行窗口 |
-F(大写) | 生成结果是一个exe程序,所有依赖项被打包进该exe程序中 |
-D(大写) | 生成结果是一个包含exe程序的目录,所有依赖项和exe程序位于同一目录下 |
-i | 为生成的exe程序指定一个icon格式的图标 |
-n | name(指定生成的.exe和.spec文件名) |
–distpath | 指定打包后的程序存放目录,默认存放在当前目录下的(新建的)dist目录 |
–workpath | 为输出的所有临时文件指定存放目录 |
2) 使用示例
在调试过程中不推荐加-w参数这样程序可能一闪而过,不能确定是执行完毕还是bug终止。
pyinstaller -F -w setup.py
2采用编写.spec脚本方式。
1)生成.spec方式
pyi-makespec -F -w setup.py
或者
pyinstaller -F -w setup.py
也会生成.spec,不过推荐将生成的build文件夹和dist文件夹删掉。
2).spec脚本参数介绍
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
a = Analysis(['setup.py'
],
pathex=[],
binaries=[],
datas=[('lab','lab')],
hiddenimports=[],
hookspath=[],
hooksconfig={},
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher,
noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
exe = EXE(pyz,
a.scripts,
[],
exclude_binaries=True,
name='setup',
debug=False,
bootloader_ignore_signals=False,
strip=False,
upx=True,
console=True,
disable_windowed_traceback=False,
target_arch=None,
codesign_identity=None,
entitlements_file=None )
coll = COLLECT(exe,
a.binaries,
a.zipfiles,
a.datas,
strip=False,
upx=True,
upx_exclude=[],
name='setup')
生成的脚本就是这样的,包含以下主要配置参数
参数 | 含义 |
a | Analysis类的实例,主要分析.py文件的依赖项,如第三方库以及import模块。a中内容主要包括以下四部分:scripts,放入.py文件。;pure,程序代码文件中的纯Python模块,包括程序的代码文件本身;binaries,需要的二进制文件。;datas,非二进制文件。 |
pyz | PYZ的实例,是一个.pyz文件,包含了所有pure中的所有Python模块。 |
exe | EXE类的实例,处理Analysis和PYZ的结果的,用来生成最后的exe可执行程序。 |
coll | COLLECT类的实例,用于创建输出目录。只有-D命令下才会实例化,-F不会生成目录。 |
block_cipher | 加密密钥(一般无加密需求,可不设置) |
而我们一般在配置时大多数情况下只涉及a,也就是Analysis类,下面逐一分析a里面的参数
Analysis的参数 | 简介以及可能存在的问题 |
scripts | 首先是一个列表(list),应该存放与打包文件相关的所有.py文件。如果不存放的话会出现import错误 no module 的问题。 |
pathex | 默认有一个spec的目录,记得把用到的模块的路径添加到这个list变量里。 默认的路径是你打包的.py文件的同级路径。 存在问题:当引入自己的文件时添加此路径并不起作用。仍会报错 |
datas | 将资源文件或文件夹,复制到打包后的目录中,而datas中必须以元组形式否则会出现下面错误。注意一点放到这里面的文件不会被编译,而是复制,所以重要的文件放到这里很容易泄露。 |
binaries | 添加二进制文件,也是一个列表,定义方式与datas参数一样。 |
hiddenimports | 隐式导入的模块,比如在__import__、imp.find_module()、exec、eval等语句中导入的模块,这些模块PyInstaller是找不到的,需要手动指定导入, |
hookspath | 指定额外hook文件(可以是py文件)的查找路径。 |
runtime_hooks | 指定自定义的运行时hook文件路径(可以是py文件) |
excludes | 指定可以被忽略的可选的模块或包。 |
三、可能遇到的问题以及解决办法。
1)打包过程找不到自己自建模块如
ModuleNotFoundError: No module named 'core'
可以将模块添加到datas里注意复制后的名字(‘core’,’core’)最好是原名(个人经验)。
还可以将自己的模块直接复制到site-packages 下面,再打包。
2)打包成功却不能正确执行,进程无法阻塞,.exe一直在循环。
这是因为在调用某些模块的时候,也是进程,而在多进程中,你程序中的进程不会被阻塞,而一直循环起进程。用下面方法去解决,注意下面代码要放在代码最开始在import 模块之前。
from multiprocessing import freeze_support
freeze_support()
四、总结
这篇文章会解决常见的pyinstaller 打包问题,文章中错误的地方欢迎小伙伴指出。
文章出处登录后可见!
已经登录?立即刷新