settings.yml¶

此配置文件位于 Conan 用户主目录中，即 [CONAN_HOME]/settings.yml。其内容如下

# This file was generated by Conan. Remove this comment if you edit this file or Conan
# will destroy your changes.
os:
    Windows:
        subsystem: [null, cygwin, msys, msys2, wsl]
    WindowsStore:
        version: ["8.1", "10.0"]
    WindowsCE:
        platform: [ANY]
        version: ["5.0", "6.0", "7.0", "8.0"]
    Linux:
    iOS:
        version: &ios_version
                   ["7.0", "7.1", "8.0", "8.1", "8.2", "8.3", "8.4", "9.0", "9.1", "9.2", "9.3",
                    "10.0", "10.1", "10.2", "10.3",
                    "11.0", "11.1", "11.2", "11.3", "11.4",
                    "12.0", "12.1", "12.2", "12.3", "12.4", "12.5",
                    "13.0", "13.1", "13.2", "13.3", "13.4", "13.5", "13.6", "13.7",
                    "14.0", "14.1", "14.2", "14.3", "14.4", "14.5", "14.6", "14.7", "14.8",
                    "15.0", "15.1", "15.2", "15.3", "15.4", "15.5", "15.6", "15.7", "15.8",
                    "16.0", "16.1", "16.2", "16.3", "16.4", "16.5", "16.6", "16.7",
                    "17.0", "17.1", "17.2", "17.3", "17.4", "17.5", "17.6", "17.7", "17.8",
                    "18.0", "18.1", "18.2", "18.3", "18.4", "18.5", "18.6", "18.7",
                    "26.0", "26.1"]
        sdk: ["iphoneos", "iphonesimulator"]
        sdk_version: [null, "11.3", "11.4", "12.0", "12.1", "12.2", "12.4",
                        "13.0", "13.1", "13.2", "13.3", "13.4", "13.5", "13.6", "13.7",
                        "14.0", "14.1", "14.2", "14.3", "14.4", "14.5", "15.0", "15.2", "15.4",
                        "15.5", "16.0", "16.1", "16.2", "16.4", "17.0", "17.1", "17.2", "17.4", "17.5",
                        "18.0", "18.1", "18.2", "18.4", "18.5",
                        "26.0", "26.1"]
    watchOS:
        version: ["4.0", "4.1", "4.2", "4.3", "5.0", "5.1", "5.2", "5.3", "6.0", "6.1", "6.2", "6.3",
                    "7.0", "7.1", "7.2", "7.3", "7.4", "7.5", "7.6",
                    "8.0", "8.1", "8.3", "8.4", "8.5", "8.6", "8.7",
                    "9.0","9.1", "9.2", "9.3", "9.4", "9.5", "9.6",
                    "10.0", "10.1", "10.2", "10.3", "10.4", "10.5", "10.6",
                    "11.0", "11.1", "11.2", "11.3", "11.4", "11.5", "11.6",
                    "26.0", "26.1"]
        sdk: ["watchos", "watchsimulator"]
        sdk_version: [null, "4.3", "5.0", "5.1", "5.2", "5.3", "6.0", "6.1", "6.2",
                        "7.0", "7.1", "7.2", "7.3", "7.4", "8.0", "8.0.1", "8.3", "8.5", "9.0", "9.1",
                        "9.4", "10.0", "10.1", "10.2", "10.4", "10.5",
                        "11.0", "11.1", "11.2", "11.4", "11.5",
                        "26.0", "26.1"]
    tvOS:
        version: ["11.0", "11.1", "11.2", "11.3", "11.4",
                    "12.0", "12.1", "12.2", "12.3", "12.4",
                    "13.0", "13.2", "13.3", "13.4",
                    "14.0", "14.2", "14.3", "14.4", "14.5", "14.6", "14.7",
                    "15.0", "15.1", "15.2", "15.3", "15.4", "15.5", "15.6",
                    "16.0", "16.1", "16.2", "16.3", "16.4", "16.5", "16.6",
                    "17.0", "17.1", "17.2", "17.3", "17.4", "17.5", "17.6",
                    "18.0", "18.1", "18.2", "18.3", "18.4", "18.5", "18.6",
                    "26.0", "26.1"]
        sdk: ["appletvos", "appletvsimulator"]
        sdk_version: [null, "11.3", "11.4", "12.0", "12.1", "12.2", "12.4",
                        "13.0", "13.2", "13.3", "13.4", "14.0", "14.2", "14.3", "14.4", "14.5", "15.0",
                        "15.2", "15.4", "15.5", "16.0", "16.1", "16.4", "17.0", "17.1", "17.2", "17.4", "17.5",
                        "18.0", "18.1", "18.2", "18.4", "18.5",
                        "26.0", "26.1"]
    visionOS:
        version: ["1.0", "1.1", "1.2", "1.3", "2.0", "2.1", "2.2", "2.3", "2.4", "2.5", "2.6",
                  "26.0", "26.1"]
        sdk: ["xros", "xrsimulator"]
        sdk_version: [null, "1.0", "1.1", "1.2", "1.3", "2.0", "2.1", "2.2", "2.4", "2.5",
                      "26.0", "26.1"]
    Macos:
        version: [null, "10.6", "10.7", "10.8", "10.9", "10.10", "10.11", "10.12", "10.13", "10.14", "10.15",
                    "11.0", "11.1", "11.2", "11.3", "11.4", "11.5", "11.6", "11.7",
                    "12.0", "12.1", "12.2", "12.3", "12.4", "12.5", "12.6", "12.7",
                    "13.0", "13.1", "13.2", "13.3", "13.4", "13.5", "13.6", "13.7",
                    "14.0", "14.1", "14.2", "14.3", "14.4", "14.5", "14.6", "14.7",
                    "15.0", "15.1", "15.2", "15.3", "15.4", "15.5", "15.6", "15.7",
                    "26.0", "26.1"]
        sdk_version: [null, "10.13", "10.14", "10.15", "11.0", "11.1", "11.2", "11.3", "12.0", "12.1",
                        "12.3", "12.4", "13.0", "13.1", "13.3", "14.0", "14.2", "14.4", "14.5",
                        "15.0", "15.1", "15.2", "15.4", "15.5",
                        "26.0", "26.1"]
        subsystem:
            null:
            catalyst:
                ios_version: *ios_version
    Android:
        api_level: [ANY]
        ndk_version: [null, ANY]
    FreeBSD:
    SunOS:
    AIX:
    Arduino:
        board: [ANY]
    Emscripten:
    Neutrino:
        version: ["6.4", "6.5", "6.6", "7.0", "7.1"]
    baremetal:
    VxWorks:
        version: ["7"]
arch: [x86, x86_64, ppc32be, ppc32, ppc64le, ppc64,
       armv4, armv4i, armv5el, armv5hf, armv6, armv7, armv7hf, armv7s, armv7k, armv8, armv8_32, armv8.3, arm64ec,
       sparc, sparcv9,
       mips, mips64, avr, s390, s390x, asm.js, wasm, wasm64, sh4le,
       e2k-v2, e2k-v3, e2k-v4, e2k-v5, e2k-v6, e2k-v7,
       riscv64, riscv32,
       xtensalx6, xtensalx106, xtensalx7,
       tc131, tc16, tc161, tc162, tc18]
compiler:
    sun-cc:
        version: ["5.10", "5.11", "5.12", "5.13", "5.14", "5.15"]
        threads: [null, posix]
        libcxx: [libCstd, libstdcxx, libstlport, libstdc++]
    gcc:
        version: ["4.1", "4.4", "4.5", "4.6", "4.7", "4.8", "4.9",
                    "5", "5.1", "5.2", "5.3", "5.4", "5.5",
                    "6", "6.1", "6.2", "6.3", "6.4", "6.5",
                    "7", "7.1", "7.2", "7.3", "7.4", "7.5",
                    "8", "8.1", "8.2", "8.3", "8.4", "8.5",
                    "9", "9.1", "9.2", "9.3", "9.4", "9.5",
                    "10", "10.1", "10.2", "10.3", "10.4", "10.5",
                    "11", "11.1", "11.2", "11.3", "11.4", "11.5",
                    "12", "12.1", "12.2", "12.3", "12.4", "12.5",
                    "13", "13.1", "13.2", "13.3", "13.4",
                    "14", "14.1", "14.2", "14.3",
                    "15", "15.1", "15.2"]
        libcxx: [libstdc++, libstdc++11]
        threads: [null, posix, win32, mcf]  # Windows MinGW
        exception: [null, dwarf2, sjlj, seh]  # Windows MinGW
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23, 26, gnu26]
        cstd: [null, 99, gnu99, 11, gnu11, 17, gnu17, 23, gnu23]
    msvc:
        version: [170, 180, 190, 191, 192, 193, 194, 195]
        update: [null, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
        runtime: [static, dynamic]
        runtime_type: [Debug, Release]
        cppstd: [null, 14, 17, 20, 23]
        toolset: [null, v110_xp, v120_xp, v140_xp, v141_xp]
        cstd: [null, 11, 17]
    clang:
        version: ["3.3", "3.4", "3.5", "3.6", "3.7", "3.8", "3.9", "4.0",
                  "5.0", "6.0", "7.0", "7.1",
                  "8", "9", "10", "11", "12", "13", "14", "15", "16", "17",
                  "18", "19", "20", "21"]
        libcxx: [null, libstdc++, libstdc++11, libc++, c++_shared, c++_static]
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23, 26, gnu26]
        runtime: [null, static, dynamic]
        runtime_type: [null, Debug, Release]
        runtime_version: [null, v140, v141, v142, v143, v144, v145]
        cstd: [null, 99, gnu99, 11, gnu11, 17, gnu17, 23, gnu23]
    apple-clang:
        version: ["5.0", "5.1", "6.0", "6.1", "7.0", "7.3", "8.0", "8.1", "9.0", "9.1",
                  "10.0", "11.0", "12.0", "13", "13.0", "13.1", "14", "14.0", "15", "15.0",
                  "16", "16.0", "17", "17.0"]
        libcxx: [libstdc++, libc++]
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23, 26, gnu26]
        cstd: [null, 99, gnu99, 11, gnu11, 17, gnu17, 23, gnu23]
    intel-cc:
        version: ["2021.1", "2021.2", "2021.3", "2021.4", "2022.1", "2022.2",
                  "2022.3", "2023.0", "2023.1", "2023.2", "2024.0", "2024.1",
                  "2025.0", "2025.1"]
        update: [null, ANY]
        mode: ["icx", "classic", "dpcpp"]
        libcxx: [null, libstdc++, libstdc++11, libc++]
        cppstd: [null, 98, gnu98, "03", gnu03, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23]
        runtime: [null, static, dynamic]
        runtime_type: [null, Debug, Release]
    qcc:
        version: ["4.4", "5.4", "8.3"]
        libcxx: [cxx, gpp, cpp, cpp-ne, accp, acpp-ne, ecpp, ecpp-ne]
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17]
    mcst-lcc:
        version: ["1.19", "1.20", "1.21", "1.22", "1.23", "1.24", "1.25"]
        libcxx: [libstdc++, libstdc++11]
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23]
    emcc:
        # From https://github.com/emscripten-core/emscripten/blob/main/ChangeLog.md
        # There is no ABI compatibility guarantee between versions
        version: [ANY]
        libcxx: [null, libstdc++, libstdc++11, libc++]
        threads: [null, posix, wasm_workers]
        cppstd: [null, 98, gnu98, 11, gnu11, 14, gnu14, 17, gnu17, 20, gnu20, 23, gnu23, 26, gnu26]
        cstd: [null, 99, gnu99, 11, gnu11, 17, gnu17, 23, gnu23]

build_type: [null, Debug, Release, RelWithDebInfo, MinSizeRel]

如您所见，settings 的可能值在同一个文件中定义。这样做是为了确保命名和拼写匹配，并在用户和 OSS 社区之间定义通用的设置模型。关于设置的一些常规信息

如果允许将设置设置为任何值，则可以使用 ANY。
如果允许将设置设置为任何值，或者也可以将其取消设置，则可以使用 [null, ANY]。

但是，可以根据需要修改此配置文件，包括新的设置或子设置及其值。如果您想分发统一的 settings.yml 文件，可以使用 conan config install 命令。

另请参阅

操作系统¶

baremetal 操作系统是一种约定，意味着二进制文件直接在硬件上运行，没有操作系统或等效层。这与 null 值区分开来，后者与“此值未定义”语义相关联。 baremetal 是嵌入式微处理器和微控制器的代码的常用命名约定。预计用户可能会使用进一步的子设置自定义 baremetal 设置中的空间，以指定其特定的硬件平台、板、系列等。目前，Conan 内置工具链和助手尚未利用 os=baremetal 值，但预计它们可以演化并开始使用它。

编译器¶

关于不同编译器的说明

msvc¶

msvc 编译器设置使用实际的 cl.exe 编译器版本，即 190 (19.0)、191 (19.1) 等，而不是 Visual Studio IDE 版本 (15、16 等)。

在使用 msvc 编译器时，Visual Studio 工具集版本（实际的 vcvars 激活和 MSBuild 位置）将由该编译器版本提供的默认值定义

msvc 编译器版本 ‘190’：Visual Studio 14 2015 (工具集 v140)
msvc 编译器版本 ‘191’：Visual Studio 15 2017 (工具集 v141)
msvc 编译器版本 ‘192’：Visual Studio 16 2019 (工具集 v142)
msvc 编译器版本 ‘193’：Visual Studio 17 2022 (工具集 v143，编译器版本高达 19.39，工具集版本 14.3X)
msvc 编译器版本 ‘194’：Visual Studio 17 2022 (工具集 v143，编译器版本从 19.40 开始，工具集版本 14.4X，Visual Studio 更新 17.10)
msvc 编译器版本 ‘195’：Visual Studio 18 2026 (工具集 v145，编译器版本从 19.50 开始，工具集版本 14.5X)

请注意，compiler.version=193 和 compiler.version=194 都映射到 v143 工具集，但映射到不同的工具集版本 14.3X 和 14.4X，这是由于 Visual Studio 更新 17.10 引入了编译器版本 19.40 和工具集版本 14.40，同时保留了工具集 v143 命名方案所致。Visual Studio 18 跳到了 v145 工具集，因此 v144 实际上不存在。

如果您想显式强制使用特定的 Visual Studio IDE 版本，可以使用 tools.microsoft.msbuild:vs_version 配置

[settings]
compiler=msvc
compiler.version=190

[conf]
tools.microsoft.msbuild:vs_version = 16

在这种情况下，vcvars 将激活 Visual Studio 16 安装，但仍将使用 190 编译器版本，因为将设置必要的 toolset=v140。

设置定义了最后一位 update: [null, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]，默认值为 null，这意味着 Conan 假定编译器补丁具有二进制兼容性，这通常适用于 Microsoft 编译器。对于需要更精细控制的情况，您可以将 update 部分添加到您的配置文件中

[settings]
compiler=msvc
compiler.version=191
compiler.update=3

这将等效于完整版本 1913 (19.13)。如果需要更详细的信息，甚至可以在 settings.yml 中的 update 子设置中添加您自己的数字。

注意

在使用 cmake 时，需要使用最新版本以确保 CMake 正确找到并处理取决于更新的正确工具集版本。
请注意，即使使用 MS VS 安装程序安装了最新的编译器更新，CMake 在未指定的情况下也可能不会使用它作为默认版本。CMake 从位于 C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build 的 Microsoft.VCToolsVersion.v143.default 和 Microsoft.VCToolsVersion.v143.default.props 文件中获取信息。检查输出日志以验证正在使用的工具集和编译器版本。

intel-cc¶

警告

此功能是实验性的，可能会发生重大更改。有关更多信息，请参阅 Conan 稳定性部分。

此编译器旨在处理新的 Intel oneAPI DPC++/C++/Classic 编译器。与其拥有 n 个不同的编译器，不如拥有 3 种不同的工作模式

icx 用于 Intel oneAPI C++。
dpcpp 用于 Intel oneAPI DPC++。
classic 用于 Intel C++ Classic 版本。

除此之外，Intel 发布了一些带有修订号的版本，因此 update 字段应为 Intel 编译器所用版本的任何可能的次要数字，例如，compiler.version=2021.1 和 compiler.update=311 表示 Intel 版本为 2021.1.311。

架构¶

以下是每个定义为 arch、arch_build 和 arch_target 设置的架构的简要说明。

x86：流行的 32 位 x86 架构。
x86_64：流行的 64 位 x64 架构。
ppc64le：PowerPC 64 位大端架构。
ppc32：PowerPC 32 位架构。
ppc64le：PowerPC 64 位小端架构。
ppc64：PowerPC 64 位大端架构。
armv5el：ARM 32 位版本 5 架构，软浮点。
armv5hf：ARM 32 位版本 5 架构，硬浮点。
armv6：ARM 32 位版本 6 架构。
armv7：ARM 32 位版本 7 架构。
armv7hf：ARM 32 位版本 7 硬浮点架构。
armv7s：ARM 32 位版本 7 swift 架构，主要用于 iPhone 5、iPhone 5C 和 iPad 4 上的 Apple 的 A6 和 A6X 芯片。
armv7k：ARM 32 位版本 7 k 架构，主要用于 Apple 的 WatchOS。
armv8：ARM 64 位和 32 位兼容版本 8 架构。它仅涵盖 aarch64 指令集。
armv8_32：ARM 32 位版本 8 架构。它仅涵盖 aarch32 指令集（又名 ILP32）。
armv8.3：ARM 64 位和 32 位兼容版本 8.3 架构。也称为 arm64e，它用于最新 iPhone 型号（XS/XS Max/XR）上的 A12 芯片。
arm64ec：Windows 11 ARM64EC（模拟兼容）。此架构支持是实验性的且不完整。在 CMake 中支持 VS 和 MSBuild 集成。如有必要，请在 Github 上报告新问题。
sparc：SPARC（可扩展处理器架构），最初由 Sun Microsystems 开发。
sparcv9：SPARC 版本 9 架构。
mips：32 位 MIPS（无互锁流水线阶段的微处理器），由 MIPS Technologies（前身为 MIPS 计算机系统）开发。
mips64：64 位 MIPS（无互锁流水线阶段的微处理器），由 MIPS Technologies（前身为 MIPS 计算机系统）开发。
avr：由 Atmel（Microchip Technology）开发的 8 位 AVR 微控制器架构。
s390：IBM 的 32 位地址企业系统架构 390。
s390x：IBM 的 64 位地址企业系统架构 390。
asm.js：可以用作编译器低级目标的 JavaScript 子集，并非真正的处理器架构，而是由 Emscripten 生成的。Conan 将其视为一种架构，以与构建系统设计（例如 GNU auto tools 和 CMake）保持一致。
wasm：WebAssembly，并非真正的处理器架构，而是 Web 的字节码格式，由 Emscripten 生成。Conan 将其视为一种架构，以与构建系统设计（例如 GNU auto tools、CMake 等）保持一致。
wasm64：64 位的 WebAssembly，与 wasm 相同，但用于 64 位。Conan 将添加必要的标志到编译器以生成 64 位 WebAssembly 代码。
sh4le：日立 SH-4 SuperH 架构。
e2k-v2：Elbrus 2000 v2 512 位 VLIW（超长指令字）架构（Elbrus 2CM、Elbrus 2C+ CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
e2k-v3：Elbrus 2000 v3 512 位 VLIW（超长指令字）架构（Elbrus 2S，又名 Elbrus 4C，CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
e2k-v4：Elbrus 2000 v4 512 位 VLIW（超长指令字）架构（Elbrus 8C、Elbrus 8C1、Elbrus 1C+ 和 Elbrus 1CK CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
e2k-v5：Elbrus 2000 v5 512 位 VLIW（超长指令字）架构（Elbrus 8C2，又名 Elbrus 8CB，CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
e2k-v6：Elbrus 2000 v6 512 位 VLIW（超长指令字）架构（Elbrus 2C3、Elbrus 12C 和 Elbrus 16C CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
e2k-v7：Elbrus 2000 v7 512 位 VLIW（超长指令字）架构（Elbrus 32C CPU），最初由 MCST（莫斯科 SPARC 技术中心）开发。
xtensalx6：ESP32 微控制器的 Xtensa LX6 DPU。
xtensalx106：ESP8266 微控制器的 Xtensa LX6 DPU。
xtensalx7：ESP32-S2 和 ESP32-S3 微控制器的 Xtensa LX7 DPU。

C++ 标准库（又名 compiler.libcxx)¶

compiler.libcxx 子设置定义要使用的 C++ 标准库实现。此子设置仅适用于某些编译器，例如，它适用于 clang、apple-clang 和 gcc，但不适用于 Visual Studio。

libstdc++ (gcc, clang, apple-clang, sun-cc, intel-cc, mcst-lcc, emcc)：GNU C++ 库。请注意，这隐式定义了 _GLIBCXX_USE_CXX11_ABI=0 以使用旧的 ABI。对于旧系统（例如 CentOS 6）来说，可能是一个明智的选择。在 Linux 系统上，您可能需要安装 libstdc++-dev（软件包名称可能因不同的发行版而异）才能使用标准库。请注意，在 Apple 系统上，使用 libstdc++ 已被弃用。
libstdc++11 (gcc, clang, intel-cc, mcst-lcc, emcc)：GNU C++ 库。请注意，这隐式定义了 _GLIBCXX_USE_CXX11_ABI=1 以使用新的 ABI。对于较新的系统（例如 Ubuntu 20）来说，可能是一个明智的选择。在 Linux 系统上，您可能需要安装 libstdc++-dev（软件包名称可能因不同的发行版而异）才能使用标准库。请注意，在 Apple 系统上，使用 libstdc++ 已被弃用。
libc++ (clang, apple-clang, intel-cc, emcc): LLVM libc++。在 Linux 系统上，您可能需要安装 libc++-dev（软件包名称在不同的发行版中可能不同）才能使用标准库。
c++_shared (clang, Android only): 使用 LLVM libc++ 作为共享库。请参阅 C++ Library Support 以获取更多详细信息。
c++_static (clang, Android only): 使用 LLVM libc++ 作为静态库。请参阅 C++ Library Support 以获取更多详细信息。
libCstd (sun-cc): Rogue Wave 的 stdlib。请参阅 Comparing C++ Standard Libraries libCstd, libstlport, and libstdcxx。
libstlport (sun-cc): STLport。请参阅 Comparing C++ Standard Libraries libCstd, libstlport, and libstdcxx。
libstdcxx (sun-cc): Apache C++ Standard Library。请参阅 Comparing C++ Standard Libraries libCstd, libstlport, and libstdcxx。
gpp (qcc): GNU C++ lib。请参阅 QCC documentation。
cpp (qcc): Dinkum C++ lib。请参阅 QCC documentation。
cpp-ne (qcc): Dinkum C++ lib (无异常)。请参阅 QCC documentation。
acpp (qcc): Dinkum Abridged C++ lib。请参阅 QCC documentation。
acpp-ne (qcc): Dinkum Abridged C++ lib (无异常)。请参阅 QCC documentation。
ecpp (qcc): Embedded Dinkum C++ lib。请参阅 QCC documentation。
ecpp-ne (qcc): Embedded Dinkum C++ lib (无异常)。请参阅 QCC documentation。
cxx (qcc): LLVM C++。请参阅 QCC documentation。

自定义设置¶

设置也可以自定义以添加您自己的设置

添加新设置¶

可以在 settings.yml 文件的根目录下添加新设置，例如

os:
    Windows:
        subsystem: [null, cygwin, msys, msys2, wsl]
distro: [null, RHEL6, CentOS, Debian]

如果我们要定义此新设置来从我们的配方创建不同的二进制文件，我们需要将它添加到我们的配方中

class Pkg(ConanFile):
    settings = "os", "compiler", "build_type", "arch", "distro"

值 null 允许不定义它（这将是默认值，对所有其他发行版有效）。也可以在配置文件中为它定义值

[settings]
os = "Linux"
distro = "CentOS"
compiler = "gcc"

并使用它们的值来影响我们的构建（如果需要）

class Pkg(ConanFile):
    settings = "os", "compiler", "build_type", "arch", "distro"

    def generate(self):
        tc = CMakeToolchain(self)
        if self.settings.distro == "CentOS":
            tc.cache_variables["SOME_CENTOS_FLAG"] = "Some CentOS Value"
            ...

添加新的子设置¶

上述方法需要修改所有配方才能将其考虑在内。也可以定义一些不兼容的设置，例如 os=Windows 和 distro=CentOS。虽然添加新设置完全适用，但将其作为 Linux 操作系统的子设置可能更有意义

os:
    Windows:
        subsystem: [null, cygwin, msys, msys2, wsl]
    Linux:
        distro: [null, RHEL6, CentOS, Debian]

有了这个定义，我们可以将我们的配置文件定义为

[settings]
os = "Linux"
os.distro = "CentOS"
compiler = "gcc"

并且任何尝试为另一个 os 值而不是 Linux 定义 os.distro 将引发错误。

由于这是一个子设置，它将自动被纳入所有声明 os 设置的配方中。请注意，允许 distro=null 的值非常重要，如果您想保留之前创建的二进制文件，否则您将强制始终定义特定的发行版值，并且没有这个子设置创建的二进制文件将无法使用。

子设置也可以从配方中访问

class Pkg(ConanFile):
    settings = "os", "compiler", "build_type", "arch"  # Note, no "distro" defined here

    def generate(self):
        tc = CMakeToolchain(self)
        if self.settings.os == "Linux" and self.settings.os.distro == "CentOS":
            tc.cache_variables["SOME_CENTOS_FLAG"] = "Some CentOS Value"

可以拥有 ANY 来定义嵌套的子设置，ANY 是任何不匹配已定义值的回退值

os:
    ANY:
        version: [null, ANY]
    Ubuntu:
        version: ["18.04", "20.04"]

这将允许设置像 -s os=MyOS -s os.version=1.2.3，因为版本可以是 ANY 对于 os!=Ubuntu，但是如果我们尝试 -s os=Ubuntu -s os.version=1.2.3 它将报错，因为 Ubuntu 仅接受那些定义的版本。

添加新值¶

就像我们添加了一个新的 distro 子设置一样，也可以向现有设置和子设置添加新值。例如，如果某些编译器版本不在接受值的范围内，您可以添加这些新值。

您也可以添加一个全新的编译器

os:
    Windows:
        subsystem: [null, cygwin, msys, msys2, wsl]
   ...
compiler:
    gcc:
        ...
    mycompiler:
        version: [1.1, 1.2]
    msvc:

这与上述关于配置文件及其从配方中访问方式相同。自定义编译器的主要问题是内置的构建助手，例如 CMake、MSBuild 等，内部包含将检查这些值的代码。例如，MSBuild 构建助手只会知道如何管理 msvc 设置和子设置，而不知道新的编译器。对于这些情况，可以在配方中实现自定义逻辑

class Pkg(ConanFile):
    settings = "os", "compiler", "build_type", "arch"

    def build(self):
        if self.settings.compiler == "mycompiler":
            my_custom_compile = ["some", "--flags", "for", "--my=compiler"]
            self.run(["mycompiler", "."] + my_custom_compile)

注意

您可以从 settings.yml 文件中删除项目：编译器、操作系统、架构等。仅在您真正想保护免受为其他平台创建二进制文件的侵害时才这样做。通常，您可以保留它们，二进制文件配置在 配置文件 中管理，并且您希望在配置文件中定义受支持的配置，而不是通过限制 settings.yml

注意

如果您自定义了 settings.yml，可以使用 conan config install 命令与您的团队和 CI 机器共享、分发和同步此配置。

settings_user.yml¶

上一节解释了如何自定义 Conan settings.yml，但您也可以创建自己的 settings_user.yml。此文件将仅包含您想在配方中使用的新的字段值，因此最终结果将是这两个文件的组合，即 settings.yml 和 settings_user.yml。

另请参阅

自定义您的设置：创建您的 settings_user.yml