validate()

validate() 方法可用于将包二进制文件标记为“无效”或不适用于当前配置。例如，如果我们有一个在 Windows 上不起作用的头文件库，我们可以使用以下 conanfile.py

from conan import ConanFile
from conan.errors import ConanInvalidConfiguration

class Pkg(ConanFile):
    name = "pkg"
    version = "1.0"
    package_type = "header-library"
    settings = "os"

    def validate(self):
        if self.settings.os == "Windows":
            raise ConanInvalidConfiguration("Windows not supported")

    def package_id(self):
        self.info.clear()  # header-only

如果我们尝试在 Windows 上创建此包，它将失败，但如果我们在 Linux 上创建它，它将成功

$ conan create . -s os=Windows # FAILS
...
ERROR: There are invalid packages:
pkg/1.0: Invalid: Windows not supported
$ conan create . -s os=Linux # WORKS

如果我们尝试在 Windows 上使用它，它将再次失败

$ conan install --requires=pkg/1.0 -s os=Windows # FAILS
...
ERROR: There are invalid packages:
pkg/1.0: Invalid: Windows not supported

当 ConanInvalidConfiguration 导致错误时，Conan 应用程序退出代码将为 6

可以使用 conan graph info 命令检查给定图的有效性，而不会引发错误

$ conan graph info --requires=pkg/1.0 -s os=Windows --filter=binary
conanfile:
ref: conanfile
binary: None
pkg/1.0#cfc18fcc7a50ead278a7c1820be74e56:
ref: pkg/1.0#cfc18fcc7a50ead278a7c1820be74e56
binary: Invalid

validate() 方法在计算完整个图之后进行评估。这意味着它可以使用 self.dependencies 信息来引发错误

from conan import ConanFile
from conan.errors import ConanInvalidConfiguration

class Pkg(ConanFile):
    requires = "dep/0.1"

    def validate(self):
        if self.dependencies["dep"].options.myoption == 2:
            raise ConanInvalidConfiguration("Option 2 of 'dep' not supported")

注意

最佳实践

configure() 方法在图完成之前进行评估，因此它没有依赖项 options 的真实值。 validate() 方法是应该检查这些依赖项选项值（如果需要）的方法，而不是 configure()。

另请参阅