配置和选项如何影响食谱的包ID¶
在 Conan 中，包 ID 是包二进制文件的唯一标识符，它考虑了影响其二进制兼容性的所有因素。这些因素包括食谱选项和配置，以及依赖项或工具依赖项。
让我们看看配置和选项如何影响包 ID，以及它们不应该影响包 ID 的一些示例。
配置如何影响包 ID¶
配置是整个开发项目的变量，例如编译器、其版本或操作系统本身。这些变量值必须定义，应与我们的开发环境值匹配，并且不能像选项那样具有默认值。
例如，让我们定义一个食谱，它生成的包仅依赖于操作系统
from conan import ConanFile
class Pkg(ConanFile):
name = "pkg"
version = "1.0.0"
settings = "os" # Only OS setting affects the package ID
如果我们使用此食谱为 Linux 生成一个包，我们将得到以下包 ID
$ conan create . --settings os=Linux
...
pkg/1.0.0: Package '9a4eb3c8701508aa9458b1a73d0633783ecc2270' created
$ conan list pkg/1.0.0:*
Local Cache
pkg
pkg/1.0.0
revisions
476929a74c859bb5f646363a4900f7cf (2024-03-07 09:13:43 UTC)
packages
9a4eb3c8701508aa9458b1a73d0633783ecc2270
info
settings
os: Linux
如果我们对 Windows 做同样的事情，现在包 ID 将不同
$ conan create . --settings os=Windows
...
pkg/1.0.0: Package 'ebec3dc6d7f6b907b3ada0c3d3cdc83613a2b715' created
$ conan list pkg/1.0.0:*
Local Cache
pkg
pkg/1.0.0
revisions
476929a74c859bb5f646363a4900f7cf (2024-03-07 09:13:43 UTC)
packages
9a4eb3c8701508aa9458b1a73d0633783ecc2270
info
settings
os: Linux
ebec3dc6d7f6b907b3ada0c3d3cdc83613a2b715
info
settings
os: Windows
每当配置或子配置的值发生变化时，包 ID 也会不同以反映这种变化。
配置最常见的用法是建模可能影响包 ID 的不同项目范围的方面。一个这样做的高级食谱将是
from conan import ConanFile
class Pkg(ConanFile):
name = "pkg"
version = "1.0.0"
settings = "os", "arch", "compiler", "build_type"
现在，使用不同编译器版本编译包将导致不同的包 ID
$ conan create . --settings compiler.version=192
...
pkg/1.0.0: Package '4f267380690f99b3ef385199826c268f63147457' created
$ conan create . --settings compiler.version=193
...
pkg/1.0.0: Package 'c13a22a41ecd72caf9e556f68b406569547e0861' created
$ conan list pkg/1.0.0:*
Local Cache
pkg
pkg/1.0.0
revisions
f1f48830ecb04f3b328429b390fc5de8 (2024-03-07 09:21:07 UTC)
packages
4f267380690f99b3ef385199826c268f63147457
info
settings
arch: x86_64
build_type: Release
compiler: msvc
compiler.cppstd: 14
compiler.runtime: dynamic
compiler.runtime_type: Release
compiler.version: 192
os: Windows
c13a22a41ecd72caf9e556f68b406569547e0861
info
settings
arch: x86_64
build_type: Release
compiler: msvc
compiler.cppstd: 14
compiler.runtime: dynamic
compiler.runtime_type: Release
compiler.version: 193
os: Windows
移除用作 tool_require 的包的配置¶
有些情况下，配置不应影响生成的包 ID。一个例子是食谱打包了一个工具，该工具将通过 tool_requires 用于构建其他包。
在那种情况下，用于编译工具的编译器值是必需的，但对使用者来说并不那么重要，因为我们只想执行该工具来构建其他项目。所以我们最终可以从包 ID 中移除编译器对其的影响。
from conan import ConanFile
class CMake(ConanFile):
name = "cmake"
version = "1.0.0"
settings = "os", "arch", "compiler", "build_type" # Only OS and architecture influence the resulting package
def build(self):
# self.settings.compiler value will be used here to compile cmake
def package_id(self):
# Remove compiler setting from package ID
del self.info.settings.compiler
为什么不从 settings 属性中移除该配置？因为在 build() 方法中仍然需要编译器值来执行可执行文件的编译。
注意
如果我们正在生成自己的可执行文件（我们自己的应用程序，而不是 tool_require），不建议从包 ID 中移除编译器配置，因为我们总是希望知道该包是使用特定编译器生成的。
然而，如果我们打包的工具在构建时甚至不需要编译器输入（例如 Python 脚本），我们也可以直接移除 settings 属性
from conan import ConanFile
class MyPythonScripts(ConanFile):
name = "my-python-scripts"
version = "1.0.0"
# No settings this time
或者，如果该工具是平台特定的，我们可以只保留操作系统和架构信息
from conan import ConanFile
class MyScripts(ConanFile):
name = "my-scripts"
version = "1.0.0"
settings = "os", "arch"
选项如何影响包 ID¶
选项用于指定特定于单个食谱的特性，这与配置不同，配置通常在项目中的食谱之间保持一致。它们通常是库可执行文件或 Conan 包可能拥有的一组特定特性。
例如，shared 选项是一种在可以生成共享库的食谱中非常常用的选项。然而，它不能成为配置，因为并非所有食谱都生成共享库。
from conan import ConanFile
class Pkg(ConanFile):
name = "pkg"
version = "1.0.0"
options = {"shared": [True, False]}
default_options = {"shared": True}
与前面配置的情况一样，选项的不同值会影响包 ID，因此会根据选项生成不同的包。
$ conan create . --options shared=True
...
pkg/1.0.0: Package '1744785cb24e3bdca70e27041dc5abd20476f947' created
$ conan create . --options shared=False
...
pkg/1.0.0: Package '55c609fe8808aa5308134cb5989d23d3caffccf2' created
同样地，有些“选项”在食谱中需要作为输入来生成包，但不应在包 ID 中考虑。例如，一个选项用于控制构建阶段的某些内容，但不会影响包的结果，比如编译的详细程度（verbosity）。在这种情况下，食谱应在 package_id() 方法中移除该选项。
然而，一般建议是 选项应始终影响包 ID，如果我们需要一个不应影响包 ID 的食谱输入，则应通过配置文件的 conf 部分来实现。然后在食谱中，我们只需添加
from conan import ConanFile
class MyPkg(ConanFile):
name = "my-pkg"
version = "1.0.0"
def build(self):
verbosity = self.conf.get("user.my-pkg:verbosity")
self.output.info(f"Using verbosity level: {verbosity})
...
[conf]
user.my-pkg:verbosity=silent
这样，包 ID 将不受影响，食谱也会更简洁（没有与包 ID 无关的选项），并且输入可以通过配置文件的 conf 部分轻松管理。