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() 方法未定义时,如果 implements ConanFile 属性中指定,Conan 可以自动管理某些传统选项:

auto_shared_fpic

自动管理的选项

  • fPIC (True, False)。

可以这样添加到配方中:

from conan import ConanFile

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

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

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

请注意,将此实现添加到配方中也可能影响 configure 步骤。

如果您需要在配方中实现自定义行为,但同时又需要此逻辑,则必须明确声明:

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

另请参阅