如何将含数据库、kivy文件及Python文件的Kivy App打包为Windows可执行文件？

方法1：PyInstaller（手动配置，最常用且可控） #

PyInstaller是Python打包工具的首选，auto-py-to-exe是它的GUI封装，手动编写.spec文件能解决大部分GUI工具无法处理的问题。

1. 准备环境
   激活你的虚拟环境，安装依赖：

   pip install pyinstaller kivy
   

   补充安装你的数据库依赖（比如pip install psycopg2-binary（PostgreSQL），SQLite为Python自带可省略）。

2. 生成并编辑.spec文件
   先生成基础配置文件：

   pyinstaller --name MyApp main.py
   

   打开生成的MyApp.spec，修改以下关键部分：

   • 包含资源文件：在datas列表中添加你的.kv文件和数据库文件：

     datas=[('ui.kv', '.'), ('mydb.db', '.')]
     

   • 添加Kivy隐藏依赖：在hiddenimports中补充Kivy的底层依赖：

     hiddenimports=['kivy.deps.sdl2', 'kivy.deps.glew', 'kivy.deps.gstreamer', 'kivy.uix.widget']
     

   • 设置窗口模式：将console=False、windowed=True，避免打包后显示命令行窗口。

3. 执行打包

   pyinstaller --clean MyApp.spec
   

   打包完成后，可执行文件在dist/MyApp/目录下，测试运行并检查资源加载是否正常。

方法2：cx_Freeze #

cx_Freeze也是稳定的打包工具，适合对打包流程有定制需求的场景。

1. 安装依赖

   pip install cx_Freeze
   

2. 编写setup.py配置文件
   示例配置（根据你的应用调整）：

   import sys
   from cx_Freeze import setup, Executable
   import kivy
   kivy.require('2.0.0')  # 替换为你的Kivy版本
   
   # Windows下隐藏命令行窗口
   base = 'Win32GUI' if sys.platform == 'win32' else None
   
   executables = [Executable('main.py', base=base, target_name='MyApp.exe')]
   
   setup(
       name='MyApp',
       version='1.0',
       description='My Kivy Application',
       options={
           'build_exe': {
               'includes': ['kivy', 'kivy.uix.label', 'kivy.uix.button'],  # 按需添加你的Kivy组件
               'include_files': ['ui.kv', 'mydb.db'],  # 包含资源文件
               'packages': ['kivy.deps.sdl2', 'kivy.deps.glew'],
           }
       },
       executables=executables
   )
   

3. 执行打包

   python setup.py build
   

   生成的可执行文件在build/目录下的对应子文件夹中。

方法3：Nuitka（编译型打包，性能更优） #

Nuitka会将Python代码编译为C代码后打包，运行速度更快，适合对性能有要求的应用。

1. 安装依赖

   pip install nuitka
   

2. 执行打包命令

   python -m nuitka --standalone --windows-disable-console --include-data-file=ui.kv=. --include-data-file=mydb.db=. main.py
   

   参数说明：

   • --standalone：生成独立可执行文件
   • --windows-disable-console：隐藏命令行窗口
   • --include-data-file：指定需要打包的资源文件（格式：源文件=目标路径）

关键注意事项 #

• 必须使用虚拟环境打包，避免全局环境的依赖冲突。
• 打包前确保你的Python脚本能正常运行，所有依赖都已正确安装。
• 数据库路径处理：如果应用运行时需要读写数据库，建议用动态路径获取，比如：

  import os
  import sys
  db_path = os.path.join(os.path.dirname(sys.executable), 'mydb.db')
  

• 若遇到导入错误，查看打包日志，将缺失的模块添加到对应配置的hiddenimports或includes列表中。

内容的提问来源于stack exchange，提问作者Morteza