溪流 — Sat, 05 Nov 2022 18:05:00 GMT

背景

事情的�v因是�Q�想找个�?Windows �?Mac 的构建方案。第一考虑自然�?CMake�Q�毕竟基本上是事实标准了�?/p>

但是研究了一�?Modern CMake�Q�也��是�?target 为核心的理念。但发现看了好几天文档，也折腑և�了可用的东西�Q�但仍然是没梳理清楚什么理��c��原理。然�?CMake 本��n语法��很复杂�Q�再加上�?target 一套概念，要给 target 讄��各种属性之�cȝ��Q�有点强�?OOP 的感觉……但其实我们只是需要一�?include_dir �?lib_dir 而已�Q�其他都是��Q云~

但如果退回到传统模式�Q�不�?Modern 概念呢，好像可以��就�Q�但�W�一不去用一个工��L��最新模式，好像有点不上�q�的感觉�Q�python 2 除外�Q�；�W�二�Q�CMake 的两大痛点——语法特立独行、文档晦涩难懂——还是让人有点不爽�?/p>

那蟩出来看别的选择呢？目前相对成熟的也只有 Google �?gn+ninja �Ҏ��了。gn �q�套东西�?Chromium 里是完全配置好的�Q�用��h��q�算��手�Q�但要是独立拿出来呢�Q�就没那么便宜了。关键是它的 toolchain 是要自己定义的�?/p>

之前�q�在公司搞客��L��的时候，大家��׃�� Chromium 里面�?build、build_overrides �{�等东西全部拷出来，好家伙，几百 MB 甚至�?G。但是公叔R��嘛，没�h��干不干净�Q�怎么快怎么来。后来又看到 Google 自家�?Crashpad 里面也用了这套构建，但工具链被简化了一下，�?mini_chromium。这个比 Chromium 里的��多了，是可以拿�q�来直接用的�Q�缺��一些配�|�可以自己加。但是呢�Q�像我们�q�种�z�癖�Q�仍然是受不鸟的。所以呢�Q�我们要�q�干净净的徏立一套工具链�?/p>

构徏�pȝ��安装

首先�Q�我们明��定位。gn �?ninja 都是开发机上需要预装的�Q�不是��Y件提供的。Chromium 的搞法是自己提供�Q�gn 的文档也说让开发者提供工兗��但�q�套思�\跟传�l�的理念是冲�H�的。同�Ӟ��自己安装工具成本是比较低的：

linux
- ninja 在主��包��理�pȝ��里已�l�有了，包名可能�?ninja �?ninja-build�Q�直接安装就可以
- gn 在部分包��理�pȝ��有，��试包名 gn �?gn-build �{�，没有的话可以下蝲二进制版�?/a>�Q�或者从源代码自行编�?/li>

mac
- gn �?brew 里没有，可以下蝲二进制版�?/a>�Q�在 MacPorts 里叫 gn-devel

win
- ninja 可以�?GitHub 下蝲二进制版本，gn 可以�?gn 官网下蝲二进制版�?/a>

自己下蝲的设�|�到 PATH�Q�测�?gn --version 以及 ninja --version�Q�能�q�行卛_��

目标

希望做到提供一�?git repo�Q��用�?clone 到自己项目的 build 目录�Q�然后��用者只要在 .gn 文�g里配�|?/p>

buildconfig = "//build/BUILDCONFIG.gn"

��可以��用我们提供的工具链，�?PC 三端�q�行构徏�?/p>

使用者的唯一负担��是�~�写自己�?BUILD.gn

工具链搭�?/h2>
首先我们�?gn 的文档，以及它的例程 simple_build 里的工具��N��|�：

https://gn.googlesource.com/gn/+/HEAD/examples/simple_build/build/toolchain/BUILD.gn

�q�个是可以直接用的，只不�q�只�?linux 端（当然 mac 也能用）。我们再�l�合 chrome 里的工具��N��|�，�q�行一些完善�?/p>

基础概念

首先我们了解 gn 体系需要的最��配�|�是什么�?/p>

�W�一�Q�它需要在根目录写一�?.gn 文�g�Q�在里面定义 buildconfig�Q�指到另一个文�Ӟ��一般是

buildconfig = "//build/BUILDCONFIG.gn"

�W�二、BUILDCONFIG.gn 里面需要设�|�默认工具链�Q�也��是写一�?/p>

set_default_toolchain("//build/toolchain:gcc")

�W�三、定义工具链�Q�如上例�?//build/toolchain:gcc�?/p>

需要在 build/toolchain 下徏�?BUILD.gn 文�g�Q�内�Ҏ��

toolchain("gcc") {
	# ...
}

最后在 toolchain 里定义各�U?tool�?/p>

工具链中的工�?/h3>

�q�部分文档在�q�里�Q�https://gn.googlesource.com/gn/+/main/docs/reference.md#func_tool

��单复�q�C��下，可被定义的工��h��Q?/p>

�~�译工具:
"cc": C �~�译�?br /> "cxx": C++ �~�译�?br /> "cxx_module": 支持 module �?C++ �~�译�?br /> "objc": Objective C �~�译�?br /> "objcxx": Objective C++ �~�译�?br /> "rc": Windows 资源脚本�~�译�?br /> "asm": 汇编�?br /> "swift": Swift �~�译�?/li>
链接工具:
"alink": 静态库链接�?br /> "solink": 动态库链接�?br /> "link": 可执行文仉��接器

�Q�其他的��先不看了）

我们来看一�?https://gn.googlesource.com/gn/+/HEAD/examples/simple_build/build/toolchain/BUILD.gn 的一些关键配�|�：

toolchain("gcc") {
  tool("cc") {
    command = "gcc -MMD -MF $depfile {{defines}} {{include_dirs}} {{cflags}} {{cflags_c}} -c {{source}} -o {{output}}"
    outputs = [ "{{source_out_dir}}/{{target_output_name}}.{{source_name_part}}.o" ]
    # ...
  }
  tool("cxx") {
    command = "g++ -MMD -MF $depfile {{defines}} {{include_dirs}} {{cflags}} {{cflags_cc}} -c {{source}} -o {{output}}"
    outputs = [ "{{source_out_dir}}/{{target_output_name}}.{{source_name_part}}.o" ]
    # ...
  }
  tool("alink") {
    command = "rm -f {{output}} && ar rcs {{output}} {{inputs}}"
    outputs = [ "{{target_out_dir}}/{{target_output_name}}{{output_extension}}" ]
    # ...
  }
  tool("solink") {
    command = "g++ -shared {{ldflags}} -o $sofile $os_specific_option @$rspfile"
    outputs = [ sofile ]
    # ...
  }
  tool("link") {
    command = "g++ {{ldflags}} -o $outfile -Wl,--start-group @$rspfile {{solibs}} -Wl,--end-group {{libs}}"
    outputs = [ outfile ]
    # ...
  }
  tool("stamp") {
    command = "touch {{output}}"
  }
  tool("copy") {
    command = "cp -af {{source}} {{output}}"
  }
}

可以看到�Q�cc �?cxx 执行 command 后，生成 .o 文�g�Q�然后这�?.o 文�g可以作�ؓ alink、solink、link �?inputs�Q�被它们 command �l�箋使用�Q�最后输出静态库、动态库以及可执行文件�?/p>

其余属性可以查文档了解含义�?/p>

�Ҏ�� Chromium 中的配置

Linux

主要配置在这里：https://source.chromium.org/chromium/chromium/src/+/main:build/toolchain/gcc_toolchain.gni

也是 gcc 的，�?simple_build 里的大同��异�Q�没有特别的�?/p>

Mac

主要配置在这里：https://source.chromium.org/chromium/chromium/src/+/main:build/toolchain/apple/toolchain.gni

区别有：

�?clang �p�d��~�译工具�Q�而不�?gcc
alink 不是�?ar�Q�而��?libtool
solink 的默认扩展名�Ҏ��?dylib
用了一�?linker_driver.py 来支持生�?dSYM�Q�在里面调用�?dsymutil �?strip

Win

�~�译�?cl�Q�静态库链接�?lib�Q�动态库和可执行文�g的链接用 link
lib_switch = ""�Q�lib_dir_switch = "/LIBPATH:"�Q�前两�?lib_switch = "-l"�Q�lib_dir_switch = "-L"

建立我们的工具链

基本上是�Ҏ��上面分析的要炚w��|�，最�l�结果在此：https://github.com/Streamlet/gn_toolchain

新增的一些差异有�Q?/p>

增加全局参数 is_debug�Q�可以在 gn gen out --args="is_debug=true"传入。默�?is_debug �?false�Q�开启所有优化�?/p>
mac 下生�?dSYM 不��?python 脚本�Q�直接是 $ld ... && dsymutil ... && strip
mac 下加了一�?template�Q�app_bundle�Q�用来生�?xxx.app�Q�主要配�|�来自于 create_bundle 文档里的例子
win 下增加了一些配�|�集
- 动�?静态链�?CRT�Q?/build/config/win:console_subsystem�?/build/config/win:static_runtime
- 控制台程序、Win32 �E�序�Q?/build/config/win:console_subsystem�?/build/config/win:windows_subsystem
  
  �q�个其实一般情况下用不着�Q�只要入口函数是 main/WinMain�Q�link 默认��是控制台程�?Win32 �E�序
- XP 支持�Q?/build/config/win:console_subsystem_xp�?/build/config/win:windows_subsystem_xp
  
  具体实现是链接参数加 /SUBSYSTEM:CONSOLE,5.01 �?/SUBSYSTEM:WINDOWS,5.01。关键是后面的版本号 5.01�Q��ؓ了加版本号则必须指定子系�l�名�U�ͼ�所以分�?console_subsystem_xp �?windows_subsystem_xp。又�Q�xp �q�里提供了两�?subsystem 的配�|�集�Q�非 xp 也提供两个�?/p>
  但是我们没有�?_WIN32_WINNT=0x0501、WINVER=0x0501、_USING_V110_SDK71_�Q�也没有指定必须使用 7.0 版本�?SDK�Q�这些都是非必须的，只要不用�?XP 以后��d��?API 卛_��。��用者可以在自己�?target 里面定义�q�些宏�?/p>

使用案例

提供一个��用案例：https://github.com/Streamlet/gn_toolchain_sample

因�ؓ它以 git submodule 形式引用�?https://github.com/Streamlet/gn_toolchain�Q�所�?git clone 以后�Q�需�?git submodule update --init一下�?/p>

然后在根目录执行�Q�（��保 gn �?ninja 已经�?PATH 中）

gn gen out
ninja -C out

卛_��?/p>

Mac 下会额外生成一�?objc ��目 objc_console_application 以及一�?app_bundle�Q�ns_application.app�?/p>

Win 会额外生成一�?Win32 ��目 win32_application�?/p>

Win 下需要先执行一�?Visual Studio 带的命��o行环境，�?VS 2022 Community �?“x64 Native Tools Command Prompt for VS 2022”，cl �{�工��h��会可用�?/p>

如果要测�?XP�Q?2位）�Q�用“x86 Native Tools Command Prompt for VS 2022”进入，CD 到项目目录，执行�Q?/p>

gn gen out --args="target_cpu=\"x86\""
ninja -C out

�ȝ��

我们只用几十 KB 的大��完成了跨端支持�Q�是很轻量的一个配�|�。如果您觉得实用�q�认可这�U�方式，�Ƣ迎一��h��l�护、完善�?/p>

溪流 2022-11-06 02:05 发表评论

欧洲成人午夜精品无码区久久,99久久国语露脸精品国产,色综合久久综合中文综合网

背景