产品

表示构建过程的结果。 更多信息...

属性

详细描述

产品通常表示构建过程的结果。它规定了一组输入和输出文件以及将前者转换为后者的方式。例如,以下产品设置了一个非常简单的 C++ 应用程序

Product {
    name: "helloworld"
    type: "application"
    files: "main.cpp"
    Depends { name: "cpp" }
}

类型 属性指定了将构建的内容(一个可执行文件)。文件 属性指定了输入文件(一个 C++ 源文件),而 Depends 项目从 cpp 模块中拉取必要的转换逻辑。对于一些常用类型的产物,Qbs 预定义了特别的派生项目以节省用户输入。这些是

因此,上面的例子也可以写成这样

CppApplication {
    name: "helloworld"
    files: "main.cpp"
}

附加到此项目的任何属性 prop 都可以作为 product.prop 在子项目中使用,同时也可以在从这个产品加载的模块中使用。

多路复用属性

以下属性仅与产品复用相关。除非需要进行复用,否则可以保留默认值。

注意: 我们不保证复用属性与向后兼容性,因为它们在未来Qbs版本中可能会发生变化。

只读属性

以下属性由Qbs自动设置,用户无法更改。

属性文档

aggregate : bool

如果设置为 true,则将创建一个聚合产品,该产品依赖于本产品的所有复用实例。

注意: 如果您不想进行复用,可以使用默认值 undefined


[只读]buildDirectory : path

该产品的构建目录。这是生成文件放置的目录。

此属性的值由Qbs自动设置,用户无法更改。


builtByDefault : bool

确定产品是否将被构建。

如果设置为 false,则只有当显式请求产品时,该产品才会被构建,无论是通过将产品名作为 –products 选项的参数,还是使用 –all-products 选项构建命令。

默认值:true


condition : bool

确定产品是否将被构建。

如果设置为 false,则 产品将不会被构建。

默认值:true


consoleApplication : bool

在Windows上,确定是否生成控制台或GUI应用程序。

如果设置为 true,则生成控制台应用程序。如果设置为 false,则生成GUI应用程序。

在Apple平台上,影响默认应用程序类型。

如果设置为 true,则生成正常可执行文件。如果设置为 false,则生成应用程序包。

默认:链接器依赖


destinationDirectory : string

目标工件所在目录。如果给定的是相对路径,则基本目录将是 project.buildDirectory

默认:product.buildDirectory


excludeFiles : stringList

不要包含的源文件列表。与通配符一起使用非常有用。更多信息,请参见 Group

默认:空列表


files : stringList

源文件列表。简单产品的语法糖来保存 Group 项目。

使用设置属性的工程文件父目录解析相对路径。

默认:空列表


multiplexByQbsProperties : stringList

指定要用于产品复用的 qbs 模块的哪些属性

值必须是上述值的子集。

注意: 如果您不想进行复用,可以使用默认值 ["profiles"]


multiplexedType : stringList

指定复用产品实例的产品类型。

注意: 如果您不想进行复用,可以使用默认值 undefined


name : string

产品的名称。用于在依赖项中识别产品,例如。此属性值必须是一个简单的JavaScript表达式,不能依赖于模块属性或非本产品本地值。

CppApplication {
    name: "hello" + "world"
    // valid
}
CppApplication {
    name: "app_" + qbs.targetOS.join("_")
    // invalid
}

要更改产品目标代码文件的名称,请修改targetName

默认:空字符串


[自Qbs 1.21起]qbsModuleProviders : stringList

要为此产品使用的模块提供者列表。

覆盖Project.qbsModuleProviders

此属性在Qbs 1.21中引入。

另见 Project::qbsModuleProviders


qbsSearchPaths : stringList

搜索导入、模块和模块提供者的路径列表。

此处设置的值将与project.qbsSearchPaths的值合并。

有关如何添加自定义项的详细信息,请参阅自定义模块和项页面。

默认:project.qbsSearchPaths


[只读] sourceDirectory : path

此产品的源目录。这是定义此产品的文件的目录。

此属性的值由Qbs自动设置,用户无法更改。


targetName : string

产品目标代码文件的基本文件名。

默认:用下划线替换非法文件名字符的name的值。


type : stringList

匹配产品目标代码文件的字节码标记。

默认:空列表


version : string

产品的版本号。例如,用于共享库文件名和Apple应用程序和框架包中生成的Info.plist文件。

默认:未定义


©2023 Qt公司。此处包含的文档贡献的版权属于其各自的所有者。此处提供的文档是根据自由软件开发基金会的GNU自由文档许可证版本1.3的条款授予的。Qt及其相关标志是芬兰的Qt有限公司及其全球其他地区的商标。所有其他标志属于其各自所有者。