Kivy+PyInstaller打包OSX应用：声音播放崩溃及SDL2导入问题求助

我之前也碰到过一模一样的问题，折腾了好几天才搞定Kivy+PyInstaller在OSX上带声音功能的部署，分享下我亲测有效的解决方案：

1. 补全GStreamer依赖打包 #

Kivy的GstPlayer依赖GStreamer的playbin组件，PyInstaller默认不会自动打包这些系统级的GStreamer插件，这是报错的核心原因：

• 先通过Homebrew安装完整的GStreamer套件：

  brew install gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly
  

• 修改PyInstaller的spec文件，手动引入GStreamer的依赖，借助kivy_deps工具来简化操作：

  from kivy_deps import gst_player
  
  a = Analysis(
      'your_main_script.py',
      pathex=['./'],
      hiddenimports=['kivy.lib.gstplayer'],
      # 保留你原来的其他配置项
  )
  # 添加GStreamer的依赖文件
  a.datas += gst_player.deps_datas
  

2. 修复SDL2导入问题 #

SDL2是Kivy的底层音频/视频依赖，打包时很容易被遗漏：

• 同样在spec文件里引入SDL2和GLEW的依赖：

  from kivy_deps import sdl2, glew
  
  a.datas += sdl2.deps_datas
  a.datas += glew.deps_datas
  

• 确保你的PyInstaller是最新版本，旧版本对Kivy的依赖处理存在bug：

  pip install --upgrade pyinstaller
  

3. 打包后手动补全缺失组件（可选但关键） #

有时候自动打包还是会漏掉部分GStreamer插件，这时候需要手动补全：

• 打包完成后，右键点击生成的.app文件，选择「显示包内容」
• 进入Contents/MacOS目录，检查是否存在gstreamer-1.0文件夹，如果没有，直接从/usr/local/lib/gstreamer-1.0复制整个文件夹到这里
• 给应用赋予音频权限：打开系统偏好设置 → 安全性与隐私 → 隐私 → 音频输入/输出，把你的应用添加进去

4. 调试技巧帮你快速定位问题 #

不要直接双击应用运行，而是通过终端启动，这样能看到完整的报错日志：

• 终端里进入Contents/MacOS目录，运行里面的可执行文件：

  cd /path/to/your/app/Contents/MacOS
  ./your_app_name
  

• 这样能看到比崩溃弹窗更详细的错误信息，比如哪个GStreamer插件缺失，方便针对性补全

我当时最后卡在playbin找不到音频解码器，后来发现是gst-plugins-good里的一些插件没被打包进去，手动复制后就完全正常了。

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