config_options()

config_options() 方法用于在为包的可用选项分配值**之前**对其进行配置或约束。一个典型的用例是在特定平台上移除某个选项。例如，SSE2 标志在 32 位架构以外的架构上不存在，因此应该在此方法中像这样移除：

def config_options(self):
    if self.settings.arch != "x86_64":
        del self.options.with_sse2

config_options() 方法的执行时机：

  • 在调用 configure() 方法之前。

  • 在分配 options 值之前。

  • 在 settings 已经定义之后。

可用的自动实现

警告

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

当未定义 config_options() 方法时，Conan 可以在 implements ConanFile 属性中指定的情况下，自动管理一些常规选项。

auto_shared_fpic

自动管理的选项

  • fPIC (True, False)。

可以在 recipe 中像这样添加：

from conan import ConanFile

class Pkg(ConanFile):
    implements = ["auto_shared_fpic"]
    ...

然后，如果在 recipe 中未指定 config_options() 方法，Conan 将在 config_options 步骤中自动管理 fPIC 设置，如下所示：

if conanfile.settings.get_safe("os") == "Windows":
    conanfile.options.rm_safe("fPIC")

请注意，将此实现添加到 recipe 中也可能会影响 configure 步骤。

如果您需要在 recipe 中实现自定义行为，同时又需要此逻辑，则必须显式声明。

def config_options(self):
    if conanfile.settings.get_safe("os") == "Windows":
        conanfile.options.rm_safe("fPIC")
    if self.settings.arch != "x86_64":
        del self.options.with_sse2

另请参阅