PyQt5 使用 pyinstaller 将多个 .py 文件构建成一个可执行文件的方法

在本文中，我们将介绍如何使用 pyinstaller 将多个 .py 文件构建成一个单一的可执行文件。PyQt5 是一个用于创建 GUI 应用程序的强大工具，而 pyinstaller 是一个将 Python 程序打包成单个可执行文件的工具。

阅读更多：PyQt5 教程

什么是 pyinstaller？

pyinstaller 是一个用于将 Python 程序打包成单个可执行文件的工具。它是一个非常方便的工具，可以将你的 Python 代码和依赖的所有库一起打包，这样你就可以将你的程序分享给其他人，而无需让他们安装 Python 或任何其他依赖项。

安装 pyinstaller

在开始之前，我们需要先安装 pyinstaller。你可以通过以下命令使用 pip 进行安装：

pip install pyinstaller

准备你的代码

在构建可执行文件之前，需要确保你的代码已经完成并且准备就绪。确保你的代码中包含了 PyQt5 的引入，并且所有的依赖项都已满足。

构建可执行文件

构建可执行文件的第一步是在命令行中导航到你的代码所在的目录。然后，使用以下命令将你的代码构建成一个可执行文件：

pyinstaller --onefile your_script.py

其中 your_script.py 是你的主要 Python 脚本文件名。

在构建过程中，pyinstaller 会自动分析你的代码并将其相关的所有依赖项打包到一个文件中。完成后，你将在当前目录中生成一个名为 dist 的文件夹，其中包含你的可执行文件。

构建包含多个 .py 文件的可执行文件

有时候，我们的应用程序可能由多个 .py 文件组成。在这种情况下，你可以通过在命令行中指定多个文件来将所有的 .py 文件构建成一个可执行文件。例如：

pyinstaller --onefile main.py module1.py module2.py

其中 main.py 是你的主要 Python 脚本文件，而 module1.py 和 module2.py 是你的其他辅助模块。

打包静态资源文件

如果你的应用程序依赖于一些静态资源文件，例如图像或样式表，你可以使用 --add-data 选项将这些文件一起打包。以下是一个示例命令：

pyinstaller --onefile --add-data "images/*.png:images" --add-data "styles/*.css:styles" your_script.py

上述命令将 images 文件夹中的所有 .png 文件和 styles 文件夹中的所有 .css 文件打包到可执行文件中，并将其放置在与可执行文件相同的文件夹中的 images 和 styles 文件夹中。

指定可执行文件的名称和输出目录

默认情况下，pyinstaller 会将可执行文件命名为与你的脚本文件相同的名称。如果你想指定一个不同的名称，可以使用 -n 或 --name 选项。例如：

pyinstaller --onefile --name my_app your_script.py

上述命令将生成一个名为 my_app 的可执行文件。

另外，如果你想将可执行文件输出到不同的目录，可以使用 -d 或 --distpath 选项。例如：

pyinstaller --onefile --distpath /path/to/output your_script.py

上述命令将在 /path/to/output 目录中输出可执行文件。

添加命令行参数

如果你的应用程序接受命令行参数，你可以在构建可执行文件时通过 --add-options 选项将它们添加到可执行文件中。例如：

pyinstaller --onefile --add-options "-w --arg1 value1 --arg2 value2" your_script.py

上述命令将添加 -w --arg1 value1 --arg2 value2 作为命令行参数到可执行文件中。

使用 PyInstaller 的 spec 文件

除了通过命令行构建可执行文件，你还可以使用 PyInstaller 的 spec 文件来定义构建过程。spec 文件是一个普通的 Python 脚本，可以指定所有构建选项和文件依赖性。

首先，创建一个名为 your_script.spec 的文件（使用你的脚本文件的名称）。然后，打开该文件并添加以下内容：

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

block_cipher = None

a = Analysis(['your_script.py'],
             pathex=['/path/to/your/script'],
             binaries=[],
             datas=[('images/*.png', 'images'), ('styles/*.css', 'styles')],
             hiddenimports=[],
             hookspath=[],
             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,
          exclude_binaries=True,
          name='your_executable_name',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          console=False )

coll = COLLECT(exe,
               a.binaries,
               a.zipfiles,
               a.datas,
               strip=False,
               upx=True,
               name='dist/your_output_directory')

app = BUNDLE(coll,
             name='your_bundle_name.app',
             icon=None)

确保将 /path/to/your/script 替换为你的脚本文件所在的路径，并根据需要修改其他选项。

完成后，保存该文件并在命令行中执行以下命令来构建可执行文件：