产品
表示构建过程的结果。 更多信息...
继承自 | AppleDiskImage, Application, InnoSetup, InstallPackage, JavaClassCollection, JavaJarFile, 以及 Library |
- 所有成员的列表,包括继承成员
- 产品是所有项目列表的一部分。所有项目的列表.
属性
- aggregate : bool
- buildDirectory : path
- builtByDefault : bool
- condition : bool
- consoleApplication : bool
- destinationDirectory : string
- excludeFiles : stringList
- files : stringList
- multiplexByQbsProperties : stringList
- multiplexedType : stringList
- name : string
- qbsModuleProviders : stringList
- qbsSearchPaths : stringList
- sourceDirectory : path
- targetName : string
- type : stringList
- version : string
详细描述
产品通常表示构建过程的结果。它规定了一组输入和输出文件以及将前者转换为后者的方式。例如,以下产品设置了一个非常简单的 C++ 应用程序
类型 属性指定了将构建的内容(一个可执行文件)。文件 属性指定了输入文件(一个 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 |
multiplexByQbsProperties : stringList |
multiplexedType : stringList |
指定复用产品实例的产品类型。
注意: 如果您不想进行复用,可以使用默认值 undefined
。
name : string |
产品的名称。用于在依赖项中识别产品,例如。此属性值必须是一个简单的JavaScript表达式,不能依赖于模块属性或非本产品本地值。
CppApplication { name: "hello" + "world" // valid } CppApplication { name: "app_" + qbs.targetOS.join("_") // invalid }
要更改产品目标代码文件的名称,请修改targetName。
默认:空字符串
[自Qbs 1.21起]qbsModuleProviders : stringList |
qbsSearchPaths : stringList |
[只读] sourceDirectory : path |
此产品的源目录。这是定义此产品的文件的目录。
此属性的值由Qbs自动设置,用户无法更改。
targetName : string |
产品目标代码文件的基本文件名。
默认:用下划线替换非法文件名字符的name的值。
type : stringList |
匹配产品目标代码文件的字节码标记。
默认:空列表
version : string |
产品的版本号。例如,用于共享库文件名和Apple应用程序和框架包中生成的Info.plist文件。
默认:未定义
©2023 Qt公司。此处包含的文档贡献的版权属于其各自的所有者。此处提供的文档是根据自由软件开发基金会的GNU自由文档许可证版本1.3的条款授予的。Qt及其相关标志是芬兰的Qt有限公司及其全球其他地区的商标。所有其他标志属于其各自所有者。