Kivy应用打包为EXE：PyInstaller与Spec文件配置指南-Python教程-PHP中文网

Kivy应用打包为EXE：PyInstaller与Spec文件配置指南

聖光之護

发布： 2025-10-21 14:11:12

原创

686人浏览过

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学习应用

674

查看详情

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文件配置指南的详细内容，更多请关注php中文网其它相关文章！