如何为GtkSharp应用构建Flatpak包及添加资源文件？

1. 核心错误原因 #

你遇到的bwrap: execvp gtkex.exe: No such file or directory并非文件不存在，而是Flatpak沙箱内没有Mono运行时来解释.NET exe文件。直接执行.exe文件系统无法识别，必须通过mono命令启动。

2. 修正Flatpak清单（含依赖与资源处理） #

以下是包含GtkSharp3依赖编译、资源文件安装的完整清单配置：

id: org.flatpak.Gtkex
runtime: org.freedesktop.Platform
runtime-version: '23.08'
sdk: org.freedesktop.Sdk
sdk-extensions:
  - org.freedesktop.Sdk.Extension.mono
runtime-extensions:
  - org.freedesktop.Platform.Extension.mono
command: mono /app/bin/gtkex.exe
modules:
  # 编译安装GtkSharp3依赖（默认Freedesktop Runtime不含该库）
  - name: gtk-sharp3
    buildsystem: autotools
    sources:
      - type: git
        url: https://github.com/mono/gtk-sharp.git
        tag: 2.99.3
    build-commands:
      - ./configure --prefix=/app
      - make
      - make install

  # 编译并打包你的应用
  - name: gtkex
    buildsystem: simple
    build-commands:
      # 激活Mono扩展环境
      - source /usr/lib/sdk/mono/enable.sh
      # 编译源码（替代本地编译，确保沙箱内兼容性）
      - mcs -pkg:gtk-sharp-3.0 gtkex.cs -out:gtkex.exe
      # 安装主程序到标准bin目录
      - install -D gtkex.exe /app/bin/gtkex.exe
      # 安装Glade文件到应用专属共享目录
      - install -D gtkex.glade /app/share/org.flatpak.Gtkex/gtkex.glade
      # 安装图标到系统标准图标目录
      - install -D icon.png /app/share/icons/hicolor/48x48/apps/org.flatpak.Gtkex.png
      # 安装桌面启动文件
      - install -D org.flatpak.Gtkex.desktop /app/share/applications/org.flatpak.Gtkex.desktop
    sources:
      - type: file
        path: gtkex.cs
      - type: file
        path: gtkex.glade
      - type: file
        path: icon.png
      - type: file
        path: org.flatpak.Gtkex.desktop

3. 资源文件读取规范 #

程序中禁止使用相对路径读取资源，必须使用沙箱内的绝对路径，示例代码：

// 读取Glade文件
string gladePath = Path.Combine("/app/share", "org.flatpak.Gtkex", "gtkex.glade");
var builder = new Gtk.Builder(gladePath);

// 读取图片资源
string iconPath = Path.Combine("/app/share/icons/hicolor/48x48/apps", "org.flatpak.Gtkex.png");
var icon = new Gdk.Pixbuf(iconPath);

桌面文件示例（org.flatpak.Gtkex.desktop） #

[Desktop Entry]
Name=Gtkex
Comment=简易GtkSharp测试应用
Exec=mono /app/bin/gtkex.exe
Icon=org.flatpak.Gtkex
Type=Application
Categories=Utility;

4. 调试与验证 #

若仍有问题，进入沙箱环境手动排查：

flatpak run --command=bash org.flatpak.Gtkex

在沙箱内执行以下命令定位问题：

• 检查Mono环境：which mono
• 手动启动程序：mono /app/bin/gtkex.exe（查看具体依赖错误）
• 确认资源路径：ls /app/share/org.flatpak.Gtkex/

5. 最终打包安装命令 #

flatpak-builder build-dir org.flatpak.Gtkex.yml
flatpak-builder --user --install --force-clean build-dir org.flatpak.Gtkex.yml
flatpak run org.flatpak.Gtkex

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