包

提供核心基础包支持。更多信息...

从 Qbs 1.4

所有成员的列表，包括继承的成员

属性

bundleName : string
contentsFolderPath : string
documentationFolderPath : string
embedInfoPlist : bool
executableFolderPath : string
executablePath : string
executablesFolderPath : string
extension : string
frameworkVersion : string
frameworksFolderPath : string
generatePackageInfo : bool
identifier : string
identifierPrefix : string
infoPlist : var
infoPlistFormat : string
infoPlistPath : string
infoStringsPath : string
isBundle : bool
isShallow : bool
javaFolderPath : string
localizedResourcesFolderPath : string
packageType : string
pkgInfoPath : string
pluginsFolderPath : string
privateHeaders : pathList
privateHeadersFolderPath : string
processInfoPlist : bool
publicHeaders : pathList
publicHeadersFolderPath : string
resources : pathList
scriptsFolderPath : string
sharedFrameworksFolderPath : string
sharedSupportFolderPath : string
signature : string
unlocalizedResourcesFolderPath : string
useBuiltinXcodeBuildSpecs : bool
versionPlistPath : string
versionsFolderPath : 字符串

详细描述

此 bundle 模块包含在苹果平台上构建和使用 Core Foundation 模块（通常称为 CFBundles 或简单称为 bundle）的属性和规则，这些模块是具有标准层次结构的目录，包含可执行代码和资源。例如，应用、框架和插件。

此模块适用于所有平台，但目前仅在苹果平台上有用。

注意：Core Foundation 模块不要与 Mach-O 可加载模块混淆，后者在苹果术语中也被称为（可加载）bundle。在 Qbs 中，Core Foundation 模块被称为 bundle，而 Mach-O 可加载模块被称为 可加载模块。

标记	自动标记的文件名	从	描述
`"bundle.content"`	-	1.8	附加到生成 bundle 的规则的输出工件。
`"infoplist"`	`Info.plist`，`*-Info.plist`	1.5	带有此标记的文件是 Info 属性列表文件或碎片，它们将合并到 bundle 的最终 `Info.plist` 中。

属性文档

bundleName : 字符串

bundle 包装目录的文件名。

通常不需要更改此属性。

默认值：产品 targetName 和 bundle 的 extension 的组合。

[只读] contentsFolderPath : 字符串

bundle 的 Contents 子目录的路径。

路径相对于包含 bundle 的目录。

[只读，自 Qbs 1.5 起使用] documentationFolderPath : 字符串

文档将写入的目录的路径。

路径相对于包含 bundle 的目录。

此属性是在 Qbs 1.5 中引入的。

embedInfoPlist : 布尔值

是否在产品的可执行文件中创建一个包含处理后的 Info.plist 的 __TEXT 区段。

仅适用于命令行应用程序。

默认值：如果产品是命令行工具，则为 true，否则为 false。

[只读] executableFolderPath : 字符串

主可执行文件将写入的目录的路径。

路径相对于包含 bundle 的目录。

不要与 executablesFolderPath 混淆。

[只读] executablePath : 字符串

主可执行文件将写入的路径。

路径相对于包含 bundle 的目录。

[只读] executablesFolderPath : 字符串

将复制辅助执行文件的目录的路径。

路径相对于包含 bundle 的目录。

不要与 executableFolderPath 混淆。

extension : 字符串

bundle 包装目录的扩展名，不包括起始点（.）。

通常不需要设置此属性，除非创建自定义 bundle 类型。

默认值：对于 "APPL" 包，为 "app"，对于 "FMWK" 包，为 "framework"，对于 "BNDL" 和自定义包，为 "bundle"。

frameworkVersion : 字符串

对于框架 bundle，框架的版本。对于其他包类型不使用。

默认值: "A"

[只读] frameworksFolderPath : string

内部框架将被复制的目录路径。

路径相对于包含 bundle 的目录。

[自 Qbs 1.5] generatePackageInfo : bool

是否为捆绑包生成 PkgInfo 文件。

此属性几乎无需更改，即使允许在指定使用 packageType 的替代包类型为自定义捆绑包时启用它。

默认值: 应用程序的 true，否则 false。

此属性是在 Qbs 1.5 中引入的。

identifier : string

捆绑包的标识符。如果未设置，捆绑包标识符将是 identifierPrefix 值和 Product.targetName 属性的连接，格式化为 RFC-1034 标识符，由点（.）分隔。

默认值: identifierPrefix 和产品目标名称的连接，格式化为 RFC-1034 标识符。

identifierPrefix : string

产品捆绑标识符的前缀。如果 identifier 未设置，捆绑标识符将是此值与 Product.targetName 属性的连接，格式化为 RFC-1034 标识符，由点（.）分隔。这对应于 Xcode 中的组织标识符。

默认值: org.example

infoPlist : var

要添加到捆绑包 Info.plist 中的键值对字典。

此属性的内容将与任何 plist 文件中的值合并。如果此属性和任何 plist 文件包含相同的键，则此属性将具有优先权。然而，它可能在后处理期间被覆盖（参见 processInfoPlist）。

如果为 undefined，则不会考虑。

默认值: 未定义

infoPlistFormat : string

写入产品最终结果 Info.plist 的文件格式。

可能的值是

"binary1"
"json"
"same-as-input"
"xml1"

默认值: iOS 上的 "binary1"，macOS 上使用 "same-as-input" 或 "xml1"（取决于是否使用 plist 文件），以及所有其他操作系统上的 undefined。

[只读] infoPlistPath : string

将 Info.plist 文件编写的路径。

路径相对于包含 bundle 的目录。

[只读，自 Qbs 1.5] infoStringsPath : string

将 InfoPlist.strings 文件编写的路径。

路径相对于包含 bundle 的目录。

此属性是在 Qbs 1.5 中引入的。

isBundle : bool

产品是否应实际作为捆绑包打包，而不是平面文件。这允许间接依赖于 bundle 模块的产品保留对其是否实际构建为捆绑包的控制。

默认值: 苹果平台上的应用程序和动态库为 true，否则为 false。

[只读] isShallow : bool

捆绑目录树是否浅层。也就是说，它是否缺少 Contents 子目录。这是除 macOS 之外的所有平台上的默认值。

默认值: macOS 上为 false，否则为 true。

[自 Qbs 1.5 起为只读] javaFolderPath : string

将 Java 内容写入的目录路径。

路径相对于包含 bundle 的目录。

此属性是在 Qbs 1.5 中引入的。

[自 Qbs 1.5 起为只读] localizedResourcesFolderPath : string

本地化资源文件复制的目录路径。

路径相对于包含 bundle 的目录。

此属性是在 Qbs 1.5 中引入的。

packageType : string

包的四个字母文件类型代码，由包的 PkgInfo 文件和包的 Info.plist 文件中的 CFBundlePackageType 键指定。

这个属性几乎不需要更改，尽管允许为自定义包指定其他包类型。

默认：应用为 "APPL"，框架为 "FMWK"，自定义包为 "BNDL"。

[只读] pkgInfoPath : string

PkgInfo 文件将被写入的路径。

路径相对于包含 bundle 的目录。

[只读] pluginsFolderPath : string

插件复制的目录路径。

路径相对于包含 bundle 的目录。

privateHeaders : pathList

要复制到框架包的 PrivateHeaders 子目录的私有头文件列表。

默认值: 未定义

[只读] privateHeadersFolderPath : string

私有头文件复制的目录路径。

路径相对于包含 bundle 的目录。

processInfoPlist : bool

是否对聚合的 Info.plist 内容进行后处理。

如果此属性为 true，则在从磁盘上的任何 plist 文件内容聚合后，将对包的属性列表字典应用各种后处理操作，并对 infoPlist 属性。

首先，如果字典中尚未存在，将向列表中添加默认值。其次，如果字典中尚未存在，将平台 SDK 的 Info.plist 文件中的 AdditionalInfo 键的值以及一些其他杂项键（如 BuildMachineOSBuild 和 UIDeviceFamily （在 iOS 上））也将被添加到字典中。最后，将执行变量扩展，使形式为 $(VAR) 或 ${VAR} 的子字符串被它们对应的环境变量替换。

默认： true

publicHeaders : pathList

要复制到框架包的 Headers 子目录的公共头文件列表。

默认值: 未定义

[只读] publicHeadersFolderPath : string

公共头文件复制的目录路径。

路径相对于包含 bundle 的目录。

resources : pathList

要复制到包的 Resources 子目录的资源列表。文件将自动复制到与输入文件路径对应的 lproj 子目录中。

默认值: 未定义

[只读] scriptsFolderPath : string

脚本文件复制的目录路径。

路径相对于包含 bundle 的目录。

[只读] sharedFrameworksFolderPath : string

共享框架复制的目录路径。

路径相对于包含 bundle 的目录。

[只读] sharedSupportFolderPath : string

共享支持文件复制的目录路径。

路径相对于包含 bundle 的目录。

signature : string

该捆绑包特定的4个字符签名，也称为创建者代码，在捆绑包的PkgInfo文件以及在捆绑包的Info.plist中指定为CFBundleSignature键的值。

通常，不应设置此属性。

默认值："????"

[只读] unlocalizedResourcesFolderPath : 字符串

非本地化资源文件将被复制到的目录路径。

路径相对于包含 bundle 的目录。

这与其他资源基本路径相同。

[默认：false] useBuiltinXcodeBuildSpecs : 布尔型

将此属性设置为true以使用与Qbs一起提供的Xcode .xcspec文件。

当使用Qbs尚不支持的新Xcode版本时，可以使用此属性作为解决方案。

[只读] versionPlistPath : 字符串

将version.plist文件写入的路径。

路径相对于包含 bundle 的目录。

[自Qbs 1.5起只读] versionsFolderPath : 字符串

捆绑包的Versions子目录的路径。

路径相对于包含 bundle 的目录。

这对于（非浅层）框架捆绑包来说很重要。

此属性是在 Qbs 1.5 中引入的。

包

属性

详细描述

相关文件标记

属性文档