compatibility()

警告

这是一个预览功能

compatibility() 方法实现了与 compatibility 插件 相同的二进制兼容性机制，但它是在 recipe 层面实现的。总的来说，全局兼容性插件在大多数情况下都足够了，只有在特殊情况下才需要 recipe 方法。

此方法可以在 conanfile.py 中使用，用于定义彼此兼容的包。如果不存在满足所请求设置和选项的二进制文件，则此机制将检索兼容包的二进制文件（如果存在）。此方法应返回一个兼容配置的列表。

例如，如果我们希望用 gcc 版本 4.8、4.7 和 4.6 构建的二进制文件被认为与用 4.9 编译的二进制文件兼容，我们可以声明一个 compatibility() 方法，如下所示

def compatibility(self):
    if self.settings.compiler == "gcc" and self.settings.compiler.version == "4.9":
        return [{"settings": [("compiler.version", v)]}
                for v in ("4.8", "4.7", "4.6")]

返回列表的格式如下所示

[
    {
        "settings": [(<setting>, <value>), (<setting>, <value>), ...],
        "options": [(<option>, <value>), (<option>, <value>), ...]
    },
    {
        "settings": [(<setting>, <value>), (<setting>, <value>), ...],
        "options": [(<option>, <value>), (<option>, <value>), ...]
    },
    ...
]

另请参阅

请阅读 二进制模型参考 以完整了解 Conan 二进制模型。