MesonToolchain¶

重要提示

此类生成的 files 仅与 Meson 版本 >= 0.55.0 兼容

MesonToolchain 是 Meson 的工具链生成器，可以在 generate() 方法中如下使用

from conan import ConanFile
from conan.tools.meson import MesonToolchain

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    requires = "hello/0.1"
    options = {"shared": [True, False]}
    default_options = {"shared": False}

    def generate(self):
        tc = MesonToolchain(self)
        tc.preprocessor_definitions["MYDEFINE"] = "MYDEF_VALUE"
        tc.generate()

重要提示

当你的 recipe 有依赖项时，MesonToolchain 仅适用于 PkgConfigDeps 生成器。请不要使用其他生成器，因为它们可能具有重叠的定义，从而导致冲突。

生成的文件¶

MesonToolchain 在 conan install 命令之后（或在缓存中构建包时）生成以下文件，这些文件包含在 generate() 方法中提供的信息以及从当前的 settings、conf 等转换而来的信息。

conan_meson_native.ini: 如果执行本地构建。
conan_meson_cross.ini: 如果执行交叉构建 (conan.tools.build)。

conan_meson_native.ini¶

此文件包含与当前包、平台等的 Conan 选项和设置相关的所有 Meson 属性的定义。这包括但不限于以下内容

从 Conan 设置中检测 default_library。
- 基于名为 shared 的选项的存在/值。
从 Conan 设置中检测 buildtype。
根据需要定义 C++ 标准。
Visual Studio 运行时 (b_vscrt)，从 Conan 输入设置中获取。

conan_meson_cross.ini¶

此文件包含与之前的 conan_meson_native.ini 相同的信息，但添加了描述主机、目标和构建机器（例如处理器架构）的额外信息。

查看 meson 文档以获取有关 native 和 cross 文件的更多详细信息

默认目录¶

MesonToolchain 管理 Meson 使用的一些目录。这些是在文件 conan_meson_native.ini 和 conan_meson_cross.ini 的 [project options] 部分下声明的变量（有关更多信息，请参阅 Meson 目录）

bindir：值来自 self.cpp.package.bindirs。默认为 None。 sbindir：值来自 self.cpp.package.bindirs。默认为 None。 libexecdir：值来自 self.cpp.package.bindirs。默认为 None。 datadir：值来自 self.cpp.package.resdirs。默认为 None。 localedir：值来自 self.cpp.package.resdirs。默认为 None。 mandir：值来自 self.cpp.package.resdirs。默认为 None。 infodir：值来自 self.cpp.package.resdirs。默认为 None。 includedir：值来自 self.cpp.package.includedirs。默认为 None。 libdir：值来自 self.cpp.package.libdirs。默认为 None。

请注意，它需要一个 layout 才能初始化这些 self.cpp.package.xxxxx 变量。例如

from conan import ConanFile
from conan.tools.meson import MesonToolchain
class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    def layout(self):
        self.folders.build = "build"
        self.cpp.package.resdirs = ["res"]
    def generate(self):
        tc = MesonToolchain(self)
        self.output.info(tc.project_options["datadir"])  # Will print '["res"]'
        tc.generate()

注意

只有当它们有值时才会被保存。如果值为 None，则不会在 [project options] 部分中提及。

自定义¶

属性¶

project_options¶

此属性允许定义 Meson 项目选项

def generate(self):
    tc = MesonToolchain(self)
    tc.project_options["MYVAR"] = "MyValue"
    tc.generate()

这被转换为

在 conan_meson_native.ini 或 conan_meson_cross.ini 文件中为 MYVAR 定义一个项目选项。

wrap_mode: nofallback 默认被定义为项目选项，以确保在 Conan 包中找到依赖项。可以使用以下方法更改或删除它

def generate(self):
    tc = MesonToolchain(self)
    tc.project_options.pop("wrap_mode")
    tc.generate()

请注意，在这种情况下，Meson 可能能够在 “wraps” 中找到依赖项，用户有责任检查行为并确保依赖项的来源。

subproject_options¶

此属性允许定义 Meson 子项目选项

def generate(self):
    tc = MesonToolchain(self)
    tc.subproject_options["SUBPROJECT"] = [{'MYVAR': 'MyValue'}]
    tc.generate()

这被转换为

在 conan_meson_native.ini 或 conan_meson_cross.ini 文件中为子项目 SUBPROJECT 和选项 MYVAR 定义一个选项。

请注意，与 project_options 相比，subproject_options 是字典列表的字典。这是因为 Meson 允许有多个子项目，并且每个子项目可以有多个选项。

preprocessor_definitions¶

此属性允许为多个配置（Debug、Release 等）定义编译器预处理器定义。

def generate(self):
    tc = MesonToolchain(self)
    tc.preprocessor_definitions["MYDEF"] = "MyValue"
    tc.generate()

这被转换为

在 conan_meson_native.ini 或 conan_meson_cross.ini 文件中为 MYDEF 定义一个预处理器定义。

conf¶

MesonToolchain 受以下 [conf] 变量的影响

tools.meson.mesontoolchain:backend。要使用的 meson backend。可能的值：ninja, vs, vs2010, vs2015, vs2017, vs2019, xcode。
tools.apple:sdk_path 参数，用于 Apple 交叉编译时的 SDK 路径。它用作 -isysroot 标志的值。
tools.android:ndk_path 参数，用于 Android 交叉编译时的 NDK 路径。它用于从 conan_meson_cross.ini 的 [binaries] 部分获取一些二进制文件，如 c、cpp 和 ar。
tools.build:cxxflags 额外的 C++ 标志列表，供 cpp_args 使用。
tools.build:cflags 额外的纯 C 标志列表，供 c_args 使用。
tools.build:sharedlinkflags 额外的链接器标志列表，供 c_link_args 和 cpp_link_args 使用。
tools.build:exelinkflags 额外的链接器标志列表，供 c_link_args 和 cpp_link_args 使用。
tools.build:linker_scripts 链接器脚本列表，每个脚本都将以 -T 为前缀，并传递给 c_link_args 和 cpp_link_args。仅将此标志与支持使用 -T 标志指定链接器脚本的链接器一起使用，例如 ld、gold 和 lld。
tools.build:defines 预处理器定义列表，每个定义都将以 -D 为前缀，并传递给 cpp_args 和 c_args。
tools.build:compiler_executables 类似字典的 Python 对象，它将编译器指定为键，将编译器可执行文件路径指定为值。这些键将按如下方式映射
tools.build:sysroot 接受系统根目录的路径，并设置 --sysroot 标志，该标志由 c_args、cpp_args、c_link_args 和 cpp_link_args 使用。
- c：将在 conan_meson_xxxx.ini 的 [binaries] 部分中设置 c。
- cpp：将在 conan_meson_xxxx.ini 的 [binaries] 部分中设置 cpp。
- objc：将在 conan_meson_xxxx.ini 的 [binaries] 部分中设置 objc。
- objcpp：将在 conan_meson_xxxx.ini 的 [binaries] 部分中设置 objcpp。

在 Meson 中为 Conan 选项使用正确的数据类型¶

在将 Conan 选项分配为 Meson 值之前，始终将其转换为有效的 Python 数据类型

options = {{"shared": [True, False], "fPIC": [True, False], "with_msg": ["ANY"]}}
default_options = {{"shared": False, "fPIC": True, "with_msg": "Hi everyone!"}}

def generate(self):
    tc = MesonToolchain(self)
    tc.project_options["DYNAMIC"] = bool(self.options.shared)  # shared is bool
    tc.project_options["GREETINGS"] = str(self.options.with_msg)  # with_msg is str
    tc.subproject_options["SUBPROJECT"] = [{'MYVAR': str(self.options.with_msg)}]  # with_msg is str
    tc.subproject_options["SUBPROJECT"].append({'MYVAR': bool(self.options.shared)})  # shared is bool
    tc.generate()

相反，强烈建议不要直接将 Conan 选项分配为 Meson 值

options = {{"shared": [True, False], "fPIC": [True, False], "with_msg": ["ANY"]}}
default_options = {{"shared": False, "fPIC": True, "with_msg": "Hi everyone!"}}
# ...
def generate(self):
    tc = MesonToolchain(self)
    tc.project_options["DYNAMIC"] = self.options.shared  # == <PackageOption object>
    tc.project_options["GREETINGS"] = self.options.with_msg  # == <PackageOption object>
    tc.subproject_options["SUBPROJECT"] = [{'MYVAR': self.options.with_msg}]  # == <PackageOption object>
    tc.subproject_options["SUBPROJECT"].append({'MYVAR': self.options.shared})  # == <PackageOption object>
    tc.generate()

这些不是布尔值或字符串值，而是表示此类选项值的内部 Conan 类。如果您直接分配这些值，则在执行 generate() 函数时，您应该在控制台中收到警告，指出 WARN: deprecated: Please, do not use a Conan option value directly. 此方法被认为是不良做法，因为它可能导致项目构建过程中出现意外错误。

为 Apple 和 Android 进行交叉构建¶

MesonToolchain 生成器添加了为 Apple（MacOS M1、iOS 等）和 Android 进行交叉编译所需的所有标志。

Apple

它将链接标志 -arch XXX、-isysroot [SDK_PATH] 和最小部署目标标志（例如 -mios-version-min=8.0）添加到 MesonToolchain 的 c_args、c_link_args、cpp_args 和 cpp_link_args 属性，根据任何 Apple OS（iOS、watchOS 等）的 Conan 设置和 tools.apple:sdk_path 配置值，如以下主机配置文件的示例所示

ios_host_profile¶

[settings]
os = iOS
os.version = 10.0
os.sdk = iphoneos
arch = armv8
compiler = apple-clang
compiler.version = 12.0
compiler.libcxx = libc++

[conf]
tools.apple:sdk_path=/my/path/to/iPhoneOS.sdk

Android

它初始化了 MesonToolchain 的 c、cpp 和 ar 属性，这些属性是为 Android 进行交叉编译所必需的，根据 Android 的 Conan 设置和 tools.android:ndk_path 配置值，如以下主机配置文件的示例所示

android_host_profile¶

[settings]
os = Android
os.api_level = 21
arch = armv8

[conf]
tools.android:ndk_path=/my/path/to/NDK

交叉构建和 native=true¶

自 Conan 2.3.0 起新增

当您进行交叉构建时，有时需要构建一个用于生成源文件的工具。为此，您可能希望使用系统的本地编译器构建某些目标。然后，您需要 Conan 创建两个上下文文件

def generate(self):
    tc = MesonToolchain(self)
    tc.generate()
    # Forcing to create the native context too
    if cross_building(self):
        tc = MesonToolchain(self, native=True)
        tc.generate()

另请参阅 Meson 文档中的此参考，以获取更多信息。

Objective-C 参数¶

在 Apple 操作系统中，还有特定的 Objective-C/Objective-C++ 参数：objc、objcpp、objc_args、objc_link_args、objcpp_args 和 objcpp_link_args，作为 MesonToolchain 类的公共属性，其中变量 objc 和 objcpp 默认分别初始化为 clang 和 clang++。

另请参阅

Meson 入门

参考¶

class MesonToolchain(conanfile, backend=None, native=False)¶

MesonToolchain 生成器

参数:

conanfile – < ConanFile object > 当前的 recipe 对象。始终使用 self。
backend – str backend Meson 变量值。默认情况下为 ninja。
native – bool 指示是否希望 Conan 在交叉构建上下文中创建 conan_meson_native.ini。请注意，仅当您的项目的 meson.build 使用 native=true 时才有意义（另请参阅 https://meson.pythonlang.cn/Cross-compilation.html#mixing-host-and-build-targets）。

extra_cxxflags¶: 额外的 CXX 标志列表。添加到 cpp_args

extra_cflags¶: 额外的 C 标志列表。添加到 c_args

extra_ldflags¶: 额外的链接器标志列表。添加到 c_link_args 和 cpp_link_args

extra_defines¶: 额外的预处理器定义列表。以 -D[FLAG_N] 格式添加到 c_args 和 cpp_args。

arch_flag¶: Conan 推导出的架构标志，并添加到 c_args、cpp_args、c_link_args 和 cpp_link_args

properties¶: 类似字典的对象，用于定义 Meson properties，格式为 key=value

project_options¶: 类似字典的对象，用于定义 Meson project options，格式为 key=value

preprocessor_definitions¶: 类似字典的对象，用于定义 Meson preprocessor definitions

subproject_options¶: 类似字典的对象，用于定义 Meson subproject options。

pkg_config_path¶: 定义 Meson pkg_config_path 变量

cross_build¶: 类似字典的对象，其中 build、host 和 target 作为 Meson 机器上下文

c¶: 设置 Meson c 变量，默认为 CC 构建环境变量值。如果以空格分隔的字符串形式提供，它将被转换为列表。否则，它仍然是单个字符串。

cpp¶: 设置 Meson cpp 变量，默认为 CXX 构建环境变量值。如果以空格分隔的字符串形式提供，它将被转换为列表。否则，它仍然是单个字符串。

ld¶: 设置 Meson ld 变量，默认为 LD 构建环境变量值。如果以空格分隔的字符串形式提供，它将被转换为列表。否则，它仍然是单个字符串。

c_ld¶: 定义 Meson c_ld 变量。默认为 CC_LD 环境变量值

cpp_ld¶: 定义 Meson cpp_ld 变量。默认为 CXX_LD 环境变量值

ar¶: 定义 Meson ar 变量。默认为 AR 构建环境变量值

strip¶: 定义 Meson strip 变量。默认为 STRIP 构建环境变量值

as_¶: 定义 Meson as 变量。默认为 AS 构建环境变量值

windres¶: 定义 Meson windres 变量。默认为 WINDRES 构建环境变量值

pkgconfig¶: 定义 Meson pkgconfig 变量。默认为 PKG_CONFIG 构建环境变量值

c_args¶: 定义 Meson c_args 变量。默认为 CFLAGS 构建环境变量值

c_link_args¶: 定义 Meson c_link_args 变量。默认为 LDFLAGS 构建环境变量值

cpp_args¶: 定义 Meson cpp_args 变量。默认为 CXXFLAGS 构建环境变量值

cpp_link_args¶: 定义 Meson cpp_link_args 变量。默认为 LDFLAGS 构建环境变量值

apple_arch_flag¶: Apple 架构标志，以列表形式，例如 ["-arch", "i386"]

apple_isysroot_flag¶: Apple sysroot 标志，以列表形式，例如 ["-isysroot", "./Platforms/MacOSX.platform"]

apple_min_version_flag¶: Apple 最小二进制版本标志，以列表形式，例如 ["-mios-version-min", "10.8"]

objc¶: 定义 Meson objc 变量。如果任何 Apple 操作系统，则默认为 None，否则为 clang

objcpp¶: 定义 Meson objcpp 变量。如果任何 Apple 操作系统，则默认为 None，否则为 clang++

objc_args¶: 定义 Meson objc_args 变量。默认为 OBJCFLAGS 构建环境变量值

objc_link_args¶: 定义 Meson objc_link_args 变量。默认为 LDFLAGS 构建环境变量值

objcpp_args¶: 定义 Meson objcpp_args 变量。默认为 OBJCXXFLAGS 构建环境变量值

objcpp_link_args¶: 定义 Meson objcpp_link_args 变量。默认为 LDFLAGS 构建环境变量值

generate()¶: 创建包含适当内容的 conan_meson_native.ini（如果是本地构建）或 conan_meson_cross.ini（如果是交叉构建）。如果使用 Windows 操作系统，还将创建 conanvcvars.bat。