📏Python项目打包方法
pyinstaller 如何打包一个项目
在前面一篇介绍 pyinstaller 工具的时候我们仅仅只是介绍了将单个文件制作成 exe 程序 : 📏用Python工具Pyinstaller制作exe应用程序 , 接下来我们将介绍如何将一个项目制作成 exe 程序, pyinstaller 还没有安装建议查看上面的连接
-D 参数
以我的项目作为示例展开介绍
| 参数 | 参数全称 | 参数说明 |
|---|---|---|
| -D | –onedir | 打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，该方式代码较易于维护 |
项目结构
#项目的根目录
- conf:
- # 用于存放配置文件的文件夹
- settings.py
- core:
- # 核心业务代码
- src.py
- db:
- # 用于存放文件数据
- db_handler.py
- song.json
- interface:
- # 接口, 接口内写获取数据前的逻辑代码，通过后才能获取数据
- bank.py
- shopping.py
- user.py
- lib:
- # 存放公共功能文件
- common.py
- log:
- # 用于存放日志文件，日志用于记录用户的操作记录
- log.log
- atm.txt:
- # 项目说明书, 用户告诉使用者项目的操作
- start.py
- # 启动文件
上面不用看, 直接看下面的
执行文件放在项目目录下面
打开 CMD 开始制作
-
进入到项目目录下, 就是执行文件所在的目录
-
pyinstaller -D run.py -
执行成功后后生成临时文件夹 build 和 dist (这两个先不用管), 还有一个 run.spec 文件
-
打开 run.spec 文件添加下面两行(不添加很容易出错, 踩过很多次) :
import sys # 先导入sys模块 sys.setrecursionlimit(100000) # 设置最大递归深度 (原因是程序里可能出现递归调用) -
保存退出 , 接着执行
pyinstaller run.spec, 等待完成, 中间有让你确认的一个步骤, 按 y 就可以 -
出现 successfully 之后进入到 dist 文件下找到 run.exe 运行就可以了
步骤演示
🍊
出现successfully
🍊
保存退出
🍊
遇到这个按 y 回车, 出现 successfully 说明制作成功
🍊
到 dist 路径下找到 run.exe 双击运行
🍊
功能正常
.spec 配置文件详解
# -*- mode: python -*-
block_cipher = None
# 以py文件为输入,分析py文件的依赖模块,并生成相应的信息
a = Analysis(['xxx.py'], # 要打包.py文件名列表，和xxx.py同级可以不同添加
pathex=['D:\\abc\\def\\project_v1.0'], # 项目路径
binaries=[], # 程序调用外部pyd、dll文件（二进制文件路径）以数组形式传入;例:('D:\\pro\\text.dll', 'pro'),将'pdftotext.dll'pro，与原项目结构一致即可
datas=[], # 存放的资源文件（图片、文本等静态文件）以数组形成传入;例：('D:\\static\\c.ioc','static'),将'cc.ioc'打包之后放在static目录，与原项目结构一致即可
hiddenimports=[], # pyinstaller解析模块时可能会遗漏某些模块（not visible to the analysis phase），造成打包后执行程序时出现类似No Module named xxx;这时就需要在hiddenimports中加入遗漏的模块
hookspath=[],
runtime_hooks=[],
excludes=[], # 去除不必要的模块import，写在excludes中添加此模块
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher)
# .pyz的压缩包，包含程序运行需要的所有依赖
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
# 根据Analysis和PYZ生成单个exe程序所需要的属性及其配置
exe = EXE(pyz,
a.scripts,
exclude_binaries=True,
name='xxx', # 生成exe文件的名字
debug=False, # debug模式
strip=False,
upx=True,
console=False, # 是否在打开exe文件时打开cmd命令框
icon='C:\Users\xx.ico' ) # 设置exe程序图标，ico格式文件（16*16）
# 收集前三个部分的内容进行整合，生成程序所需要的依赖包，及资源文件和配置
coll = COLLECT(exe,
a.binaries,
a.zipfiles,
a.datas,
strip=False,
upx=True,
name='fastplot')
- 文件过大尽量使用
from...inport...的导入方式 - windows 尽量使用绝对路径，用双斜杠\ \
- linux路径/home/my_project/...
- 路径避免使用中文
pyinstaller 参数
| 参数 | 参数全称 | 参数说明 |
|---|---|---|
| -F | –onefile | 打包成单个可执行文件，如果你的代码都写在一个.py文件，则可以使用，如果是多个.py文件，建议不要使用。 |
| -D | –onedir | 打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，该方式代码较易于维护。 |
| -K | –tk | 在部署时包含 TCL/TK。 |
| -a | –ascii | 不包含编码.在支持Unicode的python版本上默认包含所有的编码。 |
| -d | –debug | 产生debug版本的可执行文件 |
| -w | –windowed,–noconsole | 使用Windows子系统执行.当程序启动的时候不会打开命令行(仅对Windows有效) |
| -c | –nowindowed,–console | 使用控制台子系统执行(默认)(只对Windows有效) |
| pyinstaller -c xxxx.py | ||
| pyinstaller xxxx.py --console | ||
| -s | –strip | 可执行文件和共享库将run through strip。 |
| 注意Cygwin的strip可能使普通的win32 Dll无法使用 | ||
| -X | –upx | 如果有UPX安装(执行Configure.py时检测)，则会压缩执行文件(Windows系统中的DLL也会) |
| -o DIR | –out=DIR | 指定spec文件的生成目录,如果没有指定,而且当前目录是PyInstaller的根目录,会自动创建一个用于输出(spec和生成的可执行文件)的目录.如果没有指定,而当前目录不是PyInstaller的根目录,则会输出到当前的目录下。 |
| -p DIR | –path=DIR | 设置导入路径(和使用PYTHONPATH效果相似) 可以用路径分割符(Windows使用分号，Linux使用冒号)分割,指定多个目录.也可以使用多个-p参数来设置多个导入路径，让pyinstaller自己去找程序需要的资源 |
| -i <FILE.ICO> | –icon=<FILE.ICO> | 将file.ico添加为可执行文件的资源(只对Windows系统有效)，改变程序的图标 pyinstaller -i ico路径 xxxxx.py |
| –i <FILE.EXE, N> | –icon=<FILE.EXE, N> | 将file.exe的第n个图标添加为可执行文件的资源(只对Windows系统有效) |
| -v FILE | –version=FILE | 将verfile作为可执行文件的版本资源(只对Windows系统有效) |
| -n NAME | –name=NAME | 可选的项目(产生的spec的)名字.如果省略，第一个脚本的主文件名将作为spec的名字 |
---end---
