1 简介
最近有需要利用C++调用Python程序的需求,搜寻后发现使用 Pyinstaller 将其打包为exe的方法最为方便,后续使用不再依赖环境即可直接运行。
搜寻了一些博客,大部分都是 Pyinstaller 6.0 版本以前的教程。因此在打包成功后,写下这篇教程,希望给遇见同样问题的小伙伴一些帮助,欢迎讨论~
2 打包前的准备工作
为了使得打包后的 exe 尽可能的小,所以建议通过 conda 创建虚拟环境,并仅安装自己程序所需要的第三方库,这里我用到的库主要是opencv、numpy和scipy。
2.1 创建虚拟环境
# 创建虚拟环境
> conda create -n yourEnvName python=3.9
# 激活虚拟环境
> conda activate yourEnvName
# 进入你的程序所在根目录
> cd D:\code\PyEXE
# 注意如果你的cmd原始路径在C盘,那么则需要输入“ D: ”先切换盘
> D:
2.2 安装第三方库
我这里比较习惯使用 pip 安装各种第三方库。注意 pyinstaller 也是第三方库,需要额外安装。
pip install pyinstaller
2.3 生成.spec文件
虽然现在Pyinstaller更新到6.0以上版本后方便了很多,但还是需要我们人为的添加一些设置,因此在打包之前需要运行以下命令生成对应的配置文件.spec。
pyi-makespec ./yourPythonCodeName.py
注意,这里的 pyi-makespec 是包含在pyinstaller里面的,不需要额外安装,运行成功后如下图,我们的程序目录下就出现了一个和你的程序同名的.spec文件,就可以正式进入打包环节咯~
3 编辑.spec文件
使用编辑器打开.spec文件,我这里是VSCode,需要编写以下内容:
- 你想打包的主程序以及其依赖的附属程序
- 指定模块的搜索路径(这里直接就是虚拟环境的site-packages文件夹)
- 指定一些Pyinstaller无法自动检测到的模块(稳妥起见,我就把程序中用到的第三方库都加进去了)⭐_⭐
- 其他的默认就行,具体如下:
# -*- mode: python ; coding: utf-8 -*-
a = Analysis(
['lineDetectingAndReDirecting.py', 'rdp_alg.py'], # 1.包括主程序和附属程序
pathex=['C:/Users/XXX/anaconda3/envs/pyinstall/Lib/site-packages'], # 2.conda安装路径下寻找你的虚拟环境
binaries=[],
datas=[],
hiddenimports=['cv2', 'numpy', 'configargparse', 'scipy.cluster.hierarchy', 'scipy.spatial.distance', 'os', 're'], # 3.所有需要的第三方库的模块
hookspath=[],
hooksconfig={},
runtime_hooks=[],
excludes=[],
noarchive=False,
)
pyz = PYZ(a.pure)
exe = EXE(
pyz,
a.scripts,
a.binaries,
a.datas,
[],
name='lineDetectingAndReDirecting', # Ps:自动生成的exe名称(可替换)
debug=False,
bootloader_ignore_signals=False,
strip=False,
upx=True,
upx_exclude=[],
runtime_tmpdir=None,
console=True,
disable_windowed_traceback=False,
argv_emulation=False,
target_arch=None,
codesign_identity=None,
entitlements_file=None,
)
4 打包并测试
接下来,只需要运行打包命令,等待一会儿,即可打包成功~
Pyinstaller ./yourPythonCodeName.spec
打包后的内容如下
其中,我们的exe文件放在dist文件夹中 ,如图:
如果程序是不需要输入参数的,那么直接双击就可以运行了。我这里是需要输入一些参数,那么也只需要像命令行运行.py文件那样,提供相同的参数,即可运行成功!
至此,Python程序打包成功~
以下是我在搜寻方法时,参考的一些博客:
Py之Pyinstaller:Python库之Pyinstaller简介、使用方法、安装详细攻略