使用 Python 3.10 修复 Kivy 应用程序中的 PyInstaller 启动崩溃

处理 Kivy 应用程序的 PyInstaller 构建中缺少的依赖项

Python 后端解决方案，重点解决 PyInstaller 中的隐藏导入问题

# Step 1: Modify the SPEC file to include hidden imports manually
# Import necessary dependencies from Kivy, sdl2, and glew
from kivy_deps import sdl2, glew
# Add numpy, pandas, scipy to hidden imports manually
a = Analysis([r'path_to_your_app.py'],
             pathex=['.'],
             binaries=[],
             datas=[],
             hiddenimports=['numpy', 'pandas', 'scipy'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             noarchive=False)
# Add Tree() for all Kivy dependencies to the collect step
coll = COLLECT(exe, Tree('C:\\path_to_project'),
               a.binaries, a.zipfiles, a.datas,
               *[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)],
               strip=False, upx=True, name='Prototype')

在 Kivy PyInstaller 构建中管理 JSONStore 和数据文件

使用 PyInstaller 处理 JSONStore 和数据文件包含的 Python 后端解决方案

# Step 2: Ensure that the generated JSON file from kivy.storage.jsonstore is included
from kivy.storage.jsonstore import JsonStore
# If JSONStore is used, manually add the JSON file to the build
store = JsonStore('data.json')
# Create the SPEC file to explicitly include the JSON data
datas=[('data.json', '.')],
a = Analysis([r'path_to_your_app.py'],
             pathex=['.'],
             binaries=[],
             datas=[('data.json', '.')],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             noarchive=False)
coll = COLLECT(exe, Tree('C:\\path_to_project'),
               a.binaries, a.zipfiles, a.datas,
               *[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)],
               strip=False, upx=True, name='Prototype')

使用 PyInstaller 时 Kivy 应用程序崩溃的常见问题

1. 为什么我的 Kivy 应用程序在使用 PyInstaller 构建后崩溃？
2. 最常见的原因是缺少依赖项。确保所有必要的库，例如 numpy, scipy， 和 pandas，作为隐藏导入包含在 PyInstaller SPEC 文件中。
3. 如何在我的构建中包含 sdl2 和 glew 依赖项？
4. 使用 Tree 函数在 COLLECT 步骤包括 sdl2 和 glew 二进制文件。这些是 Kivy 的图形操作所必需的。
5. PyInstaller可以正确处理虚拟环境吗？
6. 可以，但是必须设置正确 pathex 在 SPEC 文件中指向安装依赖项的环境，否则应用程序可能无法找到它们。
7. 如果我的应用程序在 PyCharm 中运行但打包时崩溃了，我该怎么办？
8. 确保包含所有运行时依赖项，并验证 datas SPEC 文件中的 部分包含应用程序使用的所有必需文件，例如字体、图像或 JSON 数据。
9. 如何在不进行回溯的情况下解决“意外错误”消息？
10. 设置 console 参数为 True 在 EXE 步。这会将错误输出到终端，使您能够追踪崩溃的原因。

总结 PyInstaller 崩溃的解决方案

在本指南中，我们研究了为什么 Kivy 应用程序在使用 PyInstaller 构建时可能会崩溃，尽管在开发环境中完美运行。解决诸如缺少库、不正确捆绑数据或依赖项配置错误等问题有助于防止这些崩溃。

通过仔细调整 SPEC 文件、管理隐藏导入并确保包含所有资源和依赖项，您可以成功打包 Kivy 应用程序。正确处理这些细节将确保您的应用程序在使用 PyInstaller 构建后无缝运行。