📏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
    	- # 启动文件

上面不用看, 直接看下面的

image-20210302234321739

执行文件放在项目目录下面

打开 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 运行就可以了

步骤演示

🍊

image-20210302235944614

image-20210303000049286

出现successfully

🍊

image-20210303000146887

image-20210303000323321

保存退出

🍊

image-20210303000403608

image-20210303000531528

遇到这个按 y 回车, 出现 successfully 说明制作成功

🍊

image-20210303000701149

到 dist 路径下找到 run.exe 双击运行

🍊

image-20210303000801315

功能正常

.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---

posted @ 2021-03-03 00:19  给你骨质唱疏松  阅读(2242)  评论(0编辑  收藏  举报