Qbs

Qbs 构建助手是对 Qbs 构建工具命令行调用的包装器。它将 qbs resolveqbs buildqbs install 等调用抽象为 Python 方法调用。

该助手旨在用于 build()package() 方法中,以便当包由 Conan 直接构建(创建、安装)时自动调用 Qbs 命令。

from conan import ConanFile
from conan.tools.qbs import Qbs, QbsProfile, QbsDeps

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    exports_sources = "*.h", "*.cpp", "*.qbs",
    requires = "hello/0.1"
    options = {"shared": [True, False], "fPIC": [True, False]}
    default_options = {"shared": False, "fPIC": True}

    def generate(self):
        profile = QbsProfile(self)
        profile.generate()
        deps = QbsDeps(self)
        deps.generate()

    def build(self):
        qbs = Qbs(self)
        qbs.resolve()
        qbs.build()

    def package(self):
        qbs = Qbs(self)
        qbs.install()

参考

class Qbs(conanfile, project_file=None)

Qbs 助手与 QbsDeps 功能一起使用。此类别提供封装对 Qbs 工具调用的辅助方法。

参数:
  • conanfile – 当前的配方对象。始终使用 self

  • project_file – 主项目文件的名称。如果未设置,Qbs 将尝试自动检测项目文件。

add_configuration(name, values)

添加用于多配置构建的配置。此 Qbs 功能很少需要,因为每个 conan 包只能包含一个配置,但是当创建同一产品的多个版本并将其放入同一个 Conan 包中时,这可能会很有用。

参数:
  • name – 配置的名称。这对应于 qbs resolveqbs buildqbs install 命令的 config 参数。

  • values – 包含此配置的 Qbs 属性及其值的字典。

resolve(parallel=True)

封装 qbs resolve 调用。如果使用 QbsDeps 生成器,这将自动设置 Qbs “conan” 模块提供程序的必要属性,将依赖项添加到项目中。:param parallel: 是否使用多线程解析。默认为 True

build(products=None)

封装 qbs build 调用。

参数:

products – 要构建的产品名称列表。如果未设置,则构建所有 builtByDefault 设置为 true 的产品。此参数对应于 qbs build 命令的 --products 选项。

在调用此方法之前,应调用 resolve() 方法。

build_all()

封装 qbs build --all-products 调用。此方法构建所有产品,即使它们的 builtByDefault 属性为 false。在调用此方法之前,应调用 resolve() 方法。

install()

封装 qbs install 调用。执行 Qbs 项目中标记为可安装文件的安装。在调用此方法之前,应调用 build()build_all() 方法。