codesign
提供代码签名支持。 更多信息...
| 自 | Qbs 1.19 |
属性
- certificatePassword : string
- certificatePath : string
- codesignFlags : stringList
- codesignName : string
- codesignPath : string
- crossCertificatePath : string
- enableCodeSigning : bool
- hashAlgorithm : string
- keyAlias : string
- keyPassword : string
- keystorePassword : string
- keystorePath : string
- provisioningProfile : string
- provisioningProfilesPath : path
- rootSubjectName : string
- signingIdentity : string
- signingTimestamp : string
- signingType : string
- subjectName : string
- teamIdentifier : string
- timestampAlgorithm : string
- useApksigner : bool
详细描述
codesign模块包含在苹果和安卓平台上进行代码签名的属性和规则。
相关文件标签
| 标签 | 自动标签的文件名 | 自 | 描述 |
|---|---|---|---|
"codesign.entitlements" | *.entitlements | 1.19.0 | Xcode 权限 |
"codesign.provisioningprofile" | *.mobileprovision, *.provisionprofile | 1.19.0 | Xcode 配置文件 |
"codesign.signed_artifact" | n/a | 1.19.0 | 此标签附加到所有已签名的工件，如应用程序或库 |
属性文档
[since Qbs 1.19] certificatePassword : string |
指定打开签名证书文件 (*.pfx) 时使用的密码。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[since Qbs 1.19] certificatePath : string |
指定签名证书文件 (*.pfx) 的完整路径。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[since Qbs 1.19] codesignFlags : stringList |
传递给 codesign 工具的附加标志。
默认值: Undefined
此属性是在 Qbs 1.19 中引入的。
[since Qbs 1.19] codesignName : string |
codesign 可执行文件的名字。
默认值：自动确定
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]codesignPath : string |
codesign 工具的路径。
默认值：自动确定
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]crossCertificatePath : string |
指定额外证书文件（*.cer）的完整路径。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]enableCodeSigning : bool |
是否实际执行代码签名。
默认值：false
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]hashAlgorithm : string |
指定用于签名证书的默认哈希算法。可能的值有 sha1、sha256、sha384 和 sha512。
注意：仅在 Windows 10 套件构建 20236 及以后的版本可用。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]keyAlias : string |
密钥别名。
默认值："androiddebugkey"
此属性特定于 Android 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]keyPassword : string |
密钥密码。
默认值："android"
此属性特定于 Android 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]keystorePassword : string |
密钥库密码。
默认值："android"
此属性特定于 Android 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]keystorePath : string |
密钥库文件的绝对路径。
默认值："${HOME}/.android/debug.keystore"
此属性特定于 Android 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]provisioningProfile : string |
要嵌入产品的配置文件名称或 UUID。通常应该留空以允许 Qbs 使用自动配置。
默认值: undefined
此属性特定于 Apple 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]provisioningProfilesPath : path |
包含系统上安装的配置文件的目录的路径。通常不需要更改。
默认值："~/Library/MobileDevice/Provisioning Profiles"
此属性特定于 Apple 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]rootSubjectName : string |
指定签名证书必须链定的根证书的主体的名称。此值可以是根证书整个主体名称的子串。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]signingIdentity : string |
用于找到用于签名产品的证书的搜索字符串。这不需要是一个完整的证书名称，例如“Mac Developer: John Doe (XXXXXXXXXX)”，而是可以是一个部分字符串，例如“Mac Developer”或证书的 SHA1 指纹。搜索字符串通常如下之一：
- 第三方 Mac 开发者应用程序
- 第三方 Mac 开发者安装程序
- 开发者 ID 应用程序
- 开发者 ID 安装程序
- iPhone 开发者
- iPhone 分发
- Mac 开发者
还可以使用特殊的 "-" 值来进行临时签名。
有关现有证书类型的完整文档，请参阅 维护您的签名标识和证书。通常应使用 signingType。
默认值：由 signingType 确定默认值。
此属性特定于 Apple 平台。
此属性是在 Qbs 1.19 中引入的。
[自 Qbs 1.19 版起]signingTimestamp : string |
联系时间戳授权RFC 3161服务器以验证代码签名的URL。 undefined 或 empty 表示应使用系统特定的默认值；"none" 明确禁用Apple平台上的时间戳服务。
默认值：在Apple上为 "none"，否则为 "undefined"
此属性是在 Qbs 1.19 中引入的。
[自Qbs 1.19起] signingType : string |
使用的代码签名类型。通常，应优先考虑像 "Mac Developer: John Doe (XXXXXXXXXX)" 这样的显式签名身份，因为它不是用户特定的，并且可以设置在项目文件中。可能的值包括："app-store"、"apple-id"、"ad-hoc"，分别用于App Store或Mac App Store、开发者ID和阿霍代码签名。
signingType和signingIdentity之间的关系
以下表格显示了如何计算signingIdentity的默认值。
qbs.targetOS | codesign.signingType | qbs.buildVariant | codesign.signingIdentity |
|---|---|---|---|
"macos" | "ad-hoc" | 任何 | "-" |
"app-store" | "debug"、"profiling" | "Mac Developer" | |
"release" | "Third Party Mac Developer Application" | ||
"apple-id" | 任何 | "Developer ID Application" | |
"ios"、"tvos"、"watchos" | "app-store" | "debug"、"profiling" | "iPhone Developer" |
"release" | "iPhone Distribution" |
默认值：自动确定
此属性特定于 Apple 平台。
此属性是在 Qbs 1.19 中引入的。
[自Qbs 1.19起] subjectName : string |
指定签名证书主题的名称。此值可以是整个主题名称的子串。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在 Qbs 1.19 中引入的。
[自Qbs 1.19.2起] teamIdentifier : string |
属于签名身份的Apple开发团队的名称或10位数的标识符（可读）。这用于在不同团队之间区分同类型证书的多份。通常，如果开发机器仅注册到一个开发团队，则可以留空，否则应在配置文件中设置。
默认值: undefined
此属性特定于 Apple 平台。
此属性是在 Qbs 1.19 中引入的。
[自Qbs 1.19.2起] timestampAlgorithm : string |
指定与signingTimestamp属性一起使用的默认时间戳算法。可能的值是sha1、sha256。
注意：如果此值未设置，则将使用默认的sha1算法。
默认值: undefined
此属性仅在 Windows 上特定。
此属性是在Qbs 1.19.2中引入的。
[自Qbs 1.19起] useApksigner : bool |
如果设置为true，则使用apksignerFilePath二进制文件来签名包。将此属性设置为false以使用jarsignerFilePath。由Android.sdk模块设置。
默认值：true
此属性特定于 Android 平台。
此属性是在 Qbs 1.19 中引入的。
©2023年Qt公司有限公司。此处包含的文档贡献是各自所有者的版权。提供的文档是根据自由软件基金会发布的GNU自由文档许可证第1.3版的条款许可的。Qt以及相关的标志是芬兰Qt公司及其在全世界其他国家的商标。所有其他商标均为其各自所有者的财产。