python打包那些事儿
python是个万金油,什么活都能干,开发一些小应用的时候,要想其他人也方便使用,就需要对程序进行打包生成可执行文件,不再依赖python环境或者其他文件。
前几天写了一个视频去水印的小程序,主要依赖ffmpeg,那打包的时候就得把ffmpeg文件带上,并添加到环境变量中才行。
python通常采用pyinstaller模块进行打包,将python程序和依赖环境一起打包成可执行程序。
pyinstaller安装:pip install pyinstaller
pyinstaller常用命令:
-h,--help | 查看该模块的帮助信息 |
-F,-onefile | 产生单个的可执行文件 |
-D,--onedir | 产生一个目录(包含多个文件)作为可执行程序 |
-a,--ascii | 不包含 Unicode 字符集支持 |
-d,--debug | 产生 debug 版本的可执行文件 |
-w,--windowed,--noconsolc | 指定程序运行时不显示命令行窗口(仅对 Windows 有效) |
-c,--nowindowed,--console | 指定使用命令行窗口运行程序(仅对 Windows 有效) |
-o DIR,--out=DIR | 指定 spec 文件的生成目录。如果没有指定,则默认使用当前目录来生成 spec 文件 |
-p DIR,--path=DIR | 设置 Python 导入模块的路径(和设置 PYTHONPATH 环境变量的作用相似)。也可使用路径分隔符(Windows 使用分号,Linux 使用冒号)来分隔多个路径 |
-n NAME,--name=NAME | 指定项目(产生的 spec)名字。如果省略该选项,那么第一个脚本的主文件名将作为 spec 的名字 |
python程序使用pyinstaller打包成可执行文件,通常分为三类:
- 打包某个文件夹下的某一个py文件;
- 打包某个文件夹下的几个py文件;
- 打包文件依赖外部配置文件、执行文件、dll文件等。
打包前须知:
- 除python自带的模块、包之外(自带是指,pip install xxx 安装上的),其他的例如dll文件类,pyinstaller不负责打包进去,所以需要指定文件所在路径。帮助打包,否则import error。
- 所有的外部参数,都可以在第一次打包后的scripts文件夹下的spec文件内修改。
开始单文件打包
执行命令:pyinstaller -F test.py
-F参数是打包成一个独立的exe文件,打包完成后,dist目录下生成的可执行文件便可以使用。
多文件打包
pyinstaller -F test.py, 执行完成后后,需要修改生成的test.spec文件
在Analysis中添加依赖的python文件
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
a = Analysis(
['ffmpeg_clear_watermark.py',
'D:\\spider\\pygame\\clear_marks\\test1.py',
'D:\\spider\\pygame\\clear_marks\\test2.py',
],
pathex=[
],
binaries=[],
datas=[
],
hiddenimports=[],
...
重新打包:python test.spec
依赖外部文件、配置文件打包
在执行pyinstaller -F ffmpeg_clear_watermark.py完后,修改
ffmpeg_clear_watermark.spec文件,
analysis里添加依赖的python文件;
datas里添加依赖的外部文件,必须为绝对路径;
如果打包依赖的文件导入提示没有找到,需要把文件添加到pathex中。
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
a = Analysis(
['ffmpeg_clear_watermark.py',
'D:\\spider\\pygame\\clear_marks\\test1.py',
'D:\\spider\\pygame\\clear_marks\\test2.py',
],
pathex=[
'D:\\tools\\python3.10\\Lib\\site-packages',
'D:\\spider\\pygame\\clear_marks\\bin'
],
binaries=[],
datas=[
('D:\\spider\\pygame\\clear_marks\\bin\\ffmpeg.exe', '.'),
('D:\\spider\\pygame\\clear_marks\\bin\\ffplay.exe', '.'),
('D:\\spider\\pygame\\clear_marks\\bin\\ffprobe.exe', '.')
],
hiddenimports=[],
...
然后重新打包:python
ffmpeg_clear_watermark.spec
打包结果
执行exe文件
打包注意事项
- python3使用pyinstaller打包报错“win32ctypes.pywin32.pywintypes.error: (110, 'EndUpdateResource', '系统无法打开...
解决方法:
- 当宿主启动后对应的模块(或纯资源模块)被自动加载,这时相当于文件已经打开,资源就会被锁定
- 编译A模块时依赖于B模块的接口( 此时链接了B的lib),当A启动后B将被自动载入,资源被锁定( 这里转到情况1)。
- 当使用LoadLibary加载库后,在没有FreeLibrary之前,资源是锁定的。
- 有可能被一些防护软件阻挡.
- 安装"pywin32"和"wheel",重新安装pyinstaller。
2. python3.10打的包不能在windows7操作系统执行,如果想在windows7上执行,需要更换python3.8;
python程序打包后可以在多个平台执行,不再依赖开发环境配置文件等,也是一件很方便的事情。