如何将CMake项目转换为GN(BUILD.gn)？适配Chromium构建环境

1. 直接在GN中调用CMake构建（推荐，避免手动转换） #

对于大型CMake项目，无需手动转换BUILD.gn，可直接让GN调用CMake完成构建，步骤如下：

• 放置CMake项目
  将你的CMake项目完整放在//third_party/your_dep目录下，保留原有CMakeLists.txt及源码结构。

• 编写GN构建脚本
  在//third_party/your_dep下创建BUILD.gn，通过GN的action目标调用CMake和Ninja：

  import("//build/config/sysroot.gni")
  import("//build/toolchain/gcc_toolchain.gni")
  
  # 定义构建输出目录
  dep_out_dir = "${target_out_dir}/third_party/your_dep"
  
  # 生成Ninja构建文件
  action("generate_build") {
    script = "//build/run_cmake.py"
    inputs = [
      "CMakeLists.txt",
      # 列出所有CMake依赖的源文件、配置文件
    ]
    outputs = [
      "${dep_out_dir}/build.ninja",
      # 其他CMake生成的必要文件
    ]
    args = [
      "-S", rebase_path(".", root_build_dir),
      "-B", rebase_path(dep_out_dir, root_build_dir),
      "-G", "Ninja",
      "-DCMAKE_C_COMPILER=${cc}",
      "-DCMAKE_CXX_COMPILER=${cxx}",
      "-DCMAKE_BUILD_TYPE=" + (is_debug ? "Debug" : "Release"),
      "-DCMAKE_SYSROOT=${sysroot}",
      # 你的项目专属CMake参数
    ]
  }
  
  # 执行Ninja构建
  action("build") {
    deps = [ ":generate_build" ]
    script = "//build/run_ninja.py"
    inputs = [ "${dep_out_dir}/build.ninja" ]
    outputs = [
      "${dep_out_dir}/libyour_dep.a", # 替换为实际输出的库文件
    ]
    args = [
      "-C", rebase_path(dep_out_dir, root_build_dir),
    ]
  }
  
  # 定义可被主项目依赖的库目标
  static_library("your_dep") {
    deps = [ ":build" ]
    inputs = outputs_of(":build")
    include_dirs = [
      ".",
      "${dep_out_dir}/include", # 若CMake生成头文件到输出目录，需添加
    ]
    link_inputs = inputs
  }
  

• 主项目依赖该目标
  在需要使用依赖的BUILD.gn中添加：

  deps = [ "//third_party/your_dep:your_dep" ]
  

2. 自动转换CMakeLists.txt到BUILD.gn #

若必须生成原生GN文件，可借助工具辅助：

• 使用cmake2gn工具
  部分社区工具可解析CMakeLists.txt生成BUILD.gn，比如基于LLVM的cmake2gn，使用示例：

  cmake2gn /path/to/your/cmakelists.txt -o BUILD.gn
  

  注意：自动转换结果需手动调整，尤其是Chromium特定编译选项、复杂CMake逻辑（条件编译、自定义命令）需二次修正。

• Chromium辅助脚本
  可利用//build目录下的脚本分析CMake项目的依赖和编译选项（如analyze_cmake.py），生成的信息可辅助补全BUILD.gn。

3. 关键注意事项 #

• 工具链一致性：确保CMake使用的编译器、sysroot与Chromium GN构建完全匹配，避免链接或运行时错误。
• 增量构建：准确声明inputs和outputs，让GN能识别CMake项目的变化并触发增量构建。
• 许可证合规：第三方依赖需符合Chromium开源许可证要求，在//third_party/your_dep添加对应的LICENSE文件。

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