【前言】:我们在开发完一个小项目后,想要把项目发布出来给别人用。通常都会把代码打包成exe后再给别人,而不是让别人去安装运行环境再跑裸代码。本文就是介绍如何使用pyinstaller这个工具将python带包成可直接运行的exe。
▍概述
在介绍pyinstaller之前,先简单介绍下其它几个可以用于打包python代码的工具:
-
cx_Freeze:可以将Python脚本转换为的可执行文件,支持多个平台。
-
-
PyOxidizer:功能类似于PyInstaller,但它可以生成自包含的二进制文件,可以跨平台使用。
-
Py2exe:仅适用于Windows平台,可以将Python脚本转换为.exe可执行文件。
Pyinstaller打包代码的步骤有:
▍方式一:命令行直接打包
使用命令行打包通常适用于简单的项目,不需要复杂的配置或自定义设置,也无需频繁重复打包的情况;假设我们的python代码如下,文件名为demo.py。
import os
path=os.getcwd()
print(f'当前文件路径:{path}')
os.system('pause')
打包步骤:
1. 在cmd终端中进入demo.py文件的所在目录。
2. 终端执行:pyinstaller -F demo.py
指令解释:
pyinstaller
[-F/-D]
[-w/-c]
-i icon.ico
demo.py
结果:
▍方式二:使用spec打包
spec文件打包适用于更大规模、更复杂的项目,以及需要自定义配置和频繁重复打包的时候使用;需要使用 .spec 文件进行打包的情况有:
-
有数据文件需要一起打包
-
把动态链接库一起打包
-
添加运行时选项
-
想要生成多个可执行程序,公共的模块分割出来给其他调用
假设我们的项目文件结构如下图所示。
PackingExe
|_ core
|_ __init__.py
|_ dict.txt
|_ demo.py
demo.py文件
def resource_path(relative_path):
""" 运行exe时获取资源文件的绝对路径"""
base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
return os.path.join(base_path, relative_path)
def main():
print(f'当前文件路径:{os.getcwd()}')
abs_path = resource_path('core/dict.txt')
with open(abs_path, 'r', encoding='utf-8') as file:
content = file.readline()
print(content)
os.system('pause')
if __name__ == "__main__":
main()
此处解释一下资源路径函数(resource_path);当exe在运行时,会生成一个临时文件夹,除代码之外的数据资源需要通过sys._MEIPASS访问临时文件夹获取。
打包步骤:
1. 在终端中进入PackingExe目录。
2. 生成spec文件:pyi-makespec -F demo.py # 生成apec文件,支持-F,--key等参数,不支持--upx-dir
3. 修改spec文件
4. 执行打包命令:pyinstaller demo.spec # 使用spec文件打包,不支持外部参数
如何正确编辑spec文件?
spec文件主要包含四个类:
-
Analysis类:用于分析 Python 模块之间的依赖关系,并对需要的东西进行打包。
-
PYZ类:是一个由多个Python文件组成的二进制文件。PYZ文件内部包含整个程序的代码和标准库,以及在脚本代码中使用的所有第三方库。
-
EXE类:指定要生成的可执行文件的相关信息,例如名称、平台、图标等。
-
用于打包PackingExe项目的spec文件如下:
block_cipher = None
a = Analysis(
['demo.py'],
pathex=[],
binaries=[],
datas=[('core\dict.txt', 'core')],
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,
a.binaries,
a.zipfiles,
a.datas,
[],
name='demo',
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,
)
结果:
▍可能打包失败的原因
▍学习资源推荐
除了上述分享,如果你也喜欢编程,想通过学习Python获取更高薪资,这里给大家分享一份Python学习资料。
这里给大家展示一下我进的最近接单的截图
😝朋友们如果有需要的话,可以点击下方链接领取或者V扫描下方二维码联系领取,也可以内推兼职群哦~
学好 Python 不论是就业还是做副业赚钱都不错,但要学会 Python 还是要有一个学习规划。最后大家分享一份全套的 Python 学习资料,给那些想学习 Python 的小伙伴们一点帮助!