Amulet Minecraft编辑器Flatpak版3D窗口崩溃问题求助

我在将Amulet Minecraft Map Editor打包为Flatpak时遇到问题：程序在Linux、Windows、macOS的Python 3.11.9虚拟环境中运行正常，但Flatpak版本加载3D地图窗口时崩溃，报错wx._glcanvas.GLAttributes初始化异常并伴随NotImplementedError。构建安装无报错，已尝试源码运行、重建清单、调整org.freedesktop.Platform.GL.default扩展，问题仍存在。以下是针对该问题的排查和修复方案：

可能的原因及修复步骤 #

1. 补充Flatpak沙箱的OpenGL权限与扩展 #

Flatpak沙箱默认限制了硬件加速相关的访问，wxWidgets的GLCanvas需要完整的OpenGL环境支持：

• 在Flatpak清单的根节点添加GL扩展，指定匹配的平台版本（建议使用22.08或更高稳定版）：

  extensions:
    - org.freedesktop.Platform.GL.default:22.08
    - org.freedesktop.Platform.GL32.default:22.08 # 仅32位程序需要，64位可省略
  

• 在finish-args中添加必要的硬件与窗口系统权限：

  finish-args:
    - --device=dri # 允许访问DRI设备以启用硬件加速
    - --socket=x11 # wxWidgets依赖X11套接字
    - --socket=wayland # 若使用Wayland桌面环境，需添加此项
    - --share=ipc
  

2. 强制指定OpenGL版本 #

Amulet可能依赖特定版本的OpenGL，Flatpak默认环境可能未正确暴露该版本。可在程序启动时设置环境变量强制指定：
修改清单中的command部分，添加GL版本环境变量：

command: sh
arguments:
  - -c
  - 'export WX_GL_CONTEXT_VERSION_MAJOR=4; export WX_GL_CONTEXT_VERSION_MINOR=5; python3 -m amulet_map_editor'

注意：请根据Amulet实际依赖的OpenGL版本调整MAJOR和MINOR值，可通过本地运行时的glxinfo或Amulet源码中的GL配置确认。

3. 对齐wxPython版本 #

Flatpak PIP Generator生成的依赖可能使用了与本地测试环境不一致的wxPython版本，导致GLCanvas兼容性问题：

• 本地虚拟环境中执行pip show wxPython获取测试通过的版本号
• 在Flatpak清单的pip安装模块中显式指定该版本，示例：

  modules:
    - name: amulet
      buildsystem: simple
      build-commands:
        - pip3 install --no-index --find-links="file://${PWD}" wxPython==4.2.1 amulet-map-editor
      sources:
        - type: file
          url: https://pypi.org/packages/source/w/wxPython/wxPython-4.2.1.tar.gz
          sha256: [替换为对应版本的哈希值]
        # 其他依赖文件...
  

4. 验证沙箱内的OpenGL环境 #

进入Flatpak沙箱执行glxinfo，确认OpenGL是否正常工作：

flatpak run --command=sh org.yourdomain.Amulet
glxinfo | grep "OpenGL version"

若无输出或报错，说明GL环境未正确配置，需重新检查扩展和权限设置。

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