Kubuntu下用GTK4 crate交叉编译Rust程序至Windows遇库缺失问题

1. 先搞定pkg-config交叉编译配置 #

Kubuntu 22.04默认源里没有预编译的GTK4 mingw交叉包，先补全基础工具和pkg-config的交叉支持：

• 安装依赖工具：

  sudo apt install mingw-w64 pkg-config-mingw-w64
  

• 导出正确的环境变量，让cargo能定位到mingw下的库配置：

  export PKG_CONFIG_ALLOW_CROSS=1
  export PKG_CONFIG_PATH=/usr/x86_64-w64-mingw32/lib/pkgconfig
  export PKG_CONFIG_SYSROOT_DIR=/usr/x86_64-w64-mingw32
  export PKG_CONFIG_LIBDIR=${PKG_CONFIG_SYSROOT_DIR}/lib/pkgconfig:${PKG_CONFIG_SYSROOT_DIR}/share/pkgconfig
  

  只设置PKG_CONFIG_SYSROOT_DIR不够，必须明确指定pkgconfig的搜索路径，否则它会默认查找本地Linux库。

2. 手动编译静态版GTK4交叉库 #

由于Ubuntu源没有现成的静态交叉GTK4包，只能自行编译，需严格按依赖顺序执行（glib → cairo → pango → gdk-pixbuf → gtk4）：

• 先安装编译基础依赖：

  sudo apt install build-essential meson ninja-build gettext glib2.0-dev libcairo2-dev libpango1.0-dev libgdk-pixbuf-2.0-dev
  

• 创建交叉编译配置文件x86_64-w64-mingw32.ini：

  [binaries]
  c = 'x86_64-w64-mingw32-gcc'
  cpp = 'x86_64-w64-mingw32-g++'
  ar = 'x86_64-w64-mingw32-ar'
  strip = 'x86_64-w64-mingw32-strip'
  pkgconfig = 'x86_64-w64-mingw32-pkg-config'
  
  [host_machine]
  system = 'windows'
  cpu_family = 'x86_64'
  cpu = 'x86_64'
  endian = 'little'
  

• 逐个编译依赖库（以glib为例，其他库步骤完全一致）：

  mkdir build-glib && cd build-glib
  meson setup --cross-file ../x86_64-w64-mingw32.ini --prefix=/usr/x86_64-w64-mingw32 --default-library=static
  ninja
  sudo ninja install
  cd ..
  

  核心是添加--default-library=static参数确保编译静态库，且必须按依赖顺序安装，否则后续库会因缺失前置依赖编译失败。

3. 配置Rust项目强制静态链接 #

在项目根目录的.cargo/config.toml中添加以下配置：

[target.x86_64-pc-windows-gnu]
linker = "x86_64-w64-mingw32-gcc"
rustflags = [
    "-C", "link-arg=-static",
    "-C", "link-arg=-static-libgcc",
    "-C", "link-arg=-static-libstdc++",
]

这些参数会让Rust将所有依赖的静态库打包进最终的exe文件，彻底避免用户额外安装glib、cairo等依赖。

4. 用cross简化编译（可选） #

如果手动编译库过于繁琐，可以基于现有gtk4-cross镜像自定义构建带静态库的镜像：

• 编写Dockerfile，在原镜像基础上重新编译GTK4及其依赖为静态版，替换原有动态库。
• 在项目的Cross.toml中指定自定义镜像：

  [target.x86_64-pc-windows-gnu]
  image = "your-custom-gtk4-static-cross-image"
  

注意事项 #

静态编译后的exe体积会显著增大，但能彻底解决用户端依赖缺失问题。编译过程中若遇到库找不到的错误，优先检查是否漏装前置依赖，或meson交叉配置文件是否写错。

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