Kivy应用打包为EXE：PyInstaller与Spec文件配置指南
本文详细介绍了如何使用PyInstaller将Kivy应用程序打包成独立的Windows可执行文件（.exe）。教程涵盖了PyInstaller的安装、Kivy应用特有的.spec文件和版本信息的配置，以及最终的编译步骤。通过本文，开发者将学会如何正确处理依赖，解决打包过程中常见的Spec文件找不到等问题，从而成功发布Kivy应用。
在Python生态系统中，将图形用户界面（GUI）应用程序打包成独立的可执行文件是发布和分发软件的重要一步。对于使用Kivy框架开发的应用程序，PyInstaller是一个功能强大且广泛推荐的工具。本教程将引导您完成使用PyInstaller将Kivy应用打包为Windows .exe文件的完整过程，并特别关注.spec文件的正确配置。
1. 安装PyInstaller
首先，您需要安装PyInstaller库。打开您的终端或命令行工具，并执行以下命令：
pip install pyinstaller
2. 创建PyInstaller配置文件：.spec文件
.spec文件是PyInstaller的核心配置文件，它告诉PyInstaller如何分析您的应用程序、包含哪些文件、处理哪些依赖以及如何构建最终的可执行文件。对于Kivy应用，需要特别处理其渲染和输入依赖（如sdl2和glew）。
豆包爱学
豆包旗下AI学习应用
26
查看详情
2.1 .spec文件模板
请创建一个名为 your_app_name.spec 的文件（例如 Autoclicker.spec），并将以下模板内容复制进去。务必根据您的项目实际情况修改其中的占位符。
# -*- mode: python ; coding: utf-8 -*-
from kivy_deps import sdl2, glew
from kivy.tools.packaging.pyinstaller_hooks import get_deps_minimal, get_deps_all, hookspath, runtime_hooks
block_cipher = None
a = Analysis(
['../your_main_file.py'], # 您的主Python文件路径，相对于.spec文件
pathex=[],
datas=[
("../your_folder","your_folder"), # 如果有额外文件夹需要包含
("../your_file.ext",".") # 如果有额外文件需要包含
],
hookspath=[],
hooksconfig={},
runtime_hooks=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher,
hiddenimports=["tkinter"], # 根据需要添加隐藏导入模块，例如Kivy可能间接依赖的tkinter
noarchive=False
)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
exe = EXE(pyz,
a.scripts,
a.binaries,
a.zipfiles,
a.datas,
name='YourAppName', # 您的应用程序名称，将作为.exe文件名
version="version.txt", # 指向版本信息文件
*[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)], # 关键：包含Kivy的SDL2和GLEW依赖
debug=False,
strip=False,
upx=True, # 启用UPX压缩，可以减小文件大小
runtime_tmpdir=None,
console=False, # True: 带控制台窗口 (调试用), False: 无控制台窗口 (发布用)
icon='../your_icon.ico') # 您的应用程序图标路径
2.2 .spec文件关键配置项说明
- ['../your_main_file.py']: 这是您Kivy应用程序的入口Python文件。请确保路径正确，通常是相对于您放置.spec文件的位置。
- datas=[...]: 如果您的Kivy应用需要额外的资源文件（如图片、KV文件、字体等）或整个文件夹，您需要在这里指定。例如 ("../my_assets_folder", "my_assets_folder") 会将 my_assets_folder 及其内容打包到可执行文件根目录下的 my_assets_folder 中。
- hiddenimports=["tkinter"]: 有时PyInstaller无法自动检测到某些模块的导入，您可以在此手动添加。Kivy在某些情况下可能间接使用tkinter。
- name='YourAppName': 设置生成的可执行文件的名称。
- version="version.txt": 指定一个版本信息文件，用于配置可执行文件的属性（如公司名、版本号等）。我们将在下一步创建它。
- *`[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)]**: 这是Kivy应用打包的关键。kivy_deps.sdl2和kivy_deps.glew` 提供了PyInstaller所需的Kivy核心依赖（如SDL2和OpenGL/GLEW）的路径，确保它们被正确打包。
- console=False: 对于Kivy这样的GUI应用程序，通常设置为False，这样运行时不会弹出控制台窗口。如果您在调试阶段遇到应用闪退等问题，可以暂时设置为True来查看错误信息。
- icon='../your_icon.ico': 指定应用程序的图标文件路径。图标必须是.ico格式。
3. 创建版本信息文件：version.txt
版本信息文件允许您为生成的.exe文件设置详细的元数据，如公司名称、文件描述、版本号等。这有助于提升应用程序的专业性。
3.1 version.txt文件模板
请创建一个名为 version.txt 的文件（与您的.spec文件位于同一目录或可被访问的路径），并将以下模板内容复制进去。同样，请根据您的项目信息进行修改。
# UTF-8 # # For more details about fixed file info 'ffi' see: # http://msdn.microsoft.com/en-us/library/ms646997.aspx VSVersionInfo( ffi=FixedFileInfo( # filevers and prodvers should be always a tuple with four items: (1, 2, 3, 4) # Set not needed items to zero 0. filevers=(1, 0, 0, 0), prodvers=(1, 0, 0, 0), # Contains a bitmask that specifies the valid bits 'flags'r mask=0x3f, # Contains a bitmask that specifies the Boolean attributes of the file. flags=0x0, # The operating system for which
以上就是Kivy应用打包为EXE：PyInstaller与Spec文件配置指南的详细内容，更多请关注昆居客【www.kunjuke.com】。