Binary compatibility

This plugin, located in the cache extensions/plugins/compatibility/ allows defining custom rules for the binary compatibility of packages across settings and options. It has some built-in logic implemented, but can be customized.

def compatibility(conanfile):
    result = []
    if conanfile.settings.build_type == "Debug":
        result.append({"settings": [("build_type", "Release")]})
    return result

Some important rules:

  • The built-in is subject to changes in future releases. To avoid being updated in the future, please remove the first comment # This file was generated by Conan.


The feature is in preview. The current default is experimental. See the Conan stability section for more information.

See also

Read the binary model reference for a full view of the Conan binary model.