如何构建可同时兼容Gtk 2与Gtk 3的C++应用（CMake构建）

嘿，很高兴你问这个问题——我之前也处理过类似的跨GTK版本兼容需求，结合C++和CMake的话，有几种靠谱的方案，完全不需要拆成两个独立项目，咱们一步步说清楚：

核心思路：条件编译+CMake配置切换 #

首先明确：不需要创建两个独立项目，通过条件编译和CMake的构建选项，就能在同一个代码库下完美支持两个GTK版本。

1. 两种主流实现方案 #

方案A：双构建目标，生成对应版本的可执行文件

这是社区里最常用、最稳妥的方式。通过CMake的自定义选项控制编译时链接的GTK库，最终生成两个不同的可执行文件（比如myapp-gtk2和myapp-gtk3）。

具体操作步骤：

• 在CMakeLists.txt中添加版本切换选项：

  # 新增编译选项，默认构建GTK3版本
  option(BUILD_FOR_GTK2 "Build application with GTK 2 support" OFF)
  

• 根据选项判断链接的GTK库并配置编译定义：

  find_package(PkgConfig REQUIRED)
  
  if(BUILD_FOR_GTK2)
      pkg_check_modules(GTK REQUIRED gtk+-2.0)
      add_compile_definitions(USE_GTK2)
      set(APP_SUFFIX "-gtk2")
  else()
      pkg_check_modules(GTK REQUIRED gtk+-3.0)
      add_compile_definitions(USE_GTK3)
      set(APP_SUFFIX "-gtk3")
  endif()
  
  include_directories(${GTK_INCLUDE_DIRS})
  link_directories(${GTK_LIBRARY_DIRS})
  
  # 根据GTK版本生成带后缀的可执行文件
  add_executable(myapp${APP_SUFFIX} src/main.cpp src/gtk_adapter.cpp)
  target_link_libraries(myapp${APP_SUFFIX} ${GTK_LIBRARIES})
  

• 代码中用宏区分版本差异：

  #ifdef USE_GTK2
      // GTK2专属实现，比如旧版菜单创建逻辑
      GtkWidget *menu = gtk_menu_new();
  #else
      // GTK3专属实现，比如新的GAction系统
      GtkWidget *menu = gtk_menu_new_from_model(GTK_MENU_MODEL(action_model));
  #endif
  

方案B：单个可执行文件适配双版本（不推荐）

理论上可以实现，但维护成本极高，仅适合特殊场景。核心思路是动态加载GTK库（用dlopen/dlsym），避开静态链接的API冲突：

• 不直接链接GTK2或GTK3，运行时根据环境动态加载对应库的符号
• 每个GTK API调用都要通过动态获取的函数指针实现，代码复杂度会飙升
• 容易出现版本兼容bug，排查难度大，除非你有必须单文件的需求，否则不建议尝试

2. 构建步骤的处理 #

不需要设置独立的构建步骤，通过CMake选项+单独构建目录即可实现版本切换：

• 构建GTK2版本：

  mkdir build-gtk2 && cd build-gtk2
  cmake -DBUILD_FOR_GTK2=ON ..
  make
  

• 构建GTK3版本：

  mkdir build-gtk3 && cd build-gtk3
  cmake ..
  make
  

3. 关键优化建议 #

• 封装版本差异：把GTK2/GTK3的差异逻辑封装到单独的适配模块（比如gtk_adapter.cpp），主业务代码尽量不直接依赖GTK版本，减少条件编译的代码量
• 分开测试：在两种环境下分别测试，因为GTK2和GTK3在控件布局、事件处理上有细微差异
• 依赖检查：确保系统同时安装了GTK2和GTK3的开发包（比如Debian系的libgtk2.0-dev和libgtk-3-dev）

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