【yolov8 项目打包】pyinstaller 打包pyQt5 界面为exe

news2025/1/12 20:06:27

创建一篇博客文章，介绍如何使用PyInstaller将PyQt5界面打包为exe文件，并且处理与YOLOv8模型相关的文件，可以按照以下结构进行：

标题：使用PyInstaller将PyQt5界面与YOLOv8模型打包为Windows可执行文件

引言

在机器学习和计算机视觉领域，YOLO（You Only Look Once）是一种流行的目标检测算法。YOLOv8作为该系列算法的最新版本，提供了更快的检测速度和更高的准确率。结合PyQt5，开发者可以创建用户友好的图形界面，以便于非技术用户也能轻松使用。本文将介绍如何将PyQt5界面与YOLOv8模型打包为Windows可执行文件。

环境准备

在开始打包之前，请确保您的开发环境中已安装以下软件和库：

Python 3.9（或其他版本）
PyQt5
PyTorch（如果YOLOv8模型基于PyTorch）
PyInstaller

安装PyQt5和PyInstaller

pip install PyQt5  PyQt5-tools  pyinstaller

安装PyTorch（如果需要）

根据您的系统和需求安装PyTorch。您可以访问PyTorch官方网站获取详细的安装指令。

打包步骤

以下是将PyQt5界面与YOLOv8模型打包为exe文件的步骤：

1. 准备项目文件

确保您的PyQt5应用程序的所有源代码文件、资源文件（如图标、背景图片）以及YOLOv8模型文件（如best.pt）都位于项目目录中。

2. 创建`.spec`文件（可选）

创建一个.spec文件可以提供更高级的打包选项。例如，排除不需要的模块，指定图标等。

rtsp_frame_gui.spec

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['rtsp_frame_gui.py'],
    pathex=[],
    binaries=[],
    datas=[('save_models/best.pt', 'save_models/'), ('logo/*', 'logo/')],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=['PyQt6','PySide6'],
    noarchive=False,
    optimize=0,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='rtsp_frame_gui',
    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,
    icon=['logo\\byt.ico'],
)

更多PyInstaller参数说明：

-F 或 --onefile：将所有内容打包到一个exe文件中。
-D 或 --onedir：创建一个包含exe和所有依赖文件的目录结构。
-w 或 --windowed：如果程序是GUI应用，运行时不显示控制台窗口。
-i 或 --icon=FILE.ico：指定程序的图标文件。
--add-data PATH;DESTPATH：将指定的文件或目录添加到打包结果中，并指定在程序内部访问的相对路径。
--hidden-import MODULE_NAME：强制导入未被自动检测到的模块。
--exclude-module MODULE_NAME：排除特定模块，防止其被打包。
--clean：在重新打包时清理旧的构建文件。

3. 使用PyInstaller打包

在命令行中，定位到您的项目目录，然后运行PyInstaller命令。假设您的主脚本是main.py，并且您希望排除PyQt6和PySide6，同时包含模型文件和图标资源，命令如下：

pyinstaller -F --exclude-module PyQt6 --exclude-module PySide6 --add-data "save_models/best.pt;save_models/" --add-data "logo/*;logo/" --icon=logo/byt.ico main.py