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