对移动应用进行签名

在执行生成应用的步骤后，将 AndroidSigning@3 任务添加到 YAML 管道中。 在 AndroidSigning@3 任务中：

• <apkFiles> 是必需的，并且是要签名的 APK 文件的路径和名称。 默认为 **/*.apk。
• <apksign> 必须是 true（默认值）。
• <keystore-file> 是安全文件库中上传的密钥存储文件的名称。
• <apksignerKeystorePassword> 是未加密密钥存储文件的密码。
• <apksignerKeystoreAlias> 是签名证书的密钥别名。
• <apksignerKeyPassword> 是与指定别名关联的密钥的密码。

你可以在 YAML 中设置和使用变量，也可以使用 Azure Pipelines UI 中的变量选项卡设置变量，并在 YAML 中引用它们。

variables:
  keystore-password: <keystore file password>
  key-alias: <key alias for the signing certificater>
  key-password: <password for the key associated with the alias>

steps:
- task: AndroidSigning@3
  displayName: 'Signing and aligning APK file(s) **/*.apk'
  inputs:
    apkFiles: '**/*.apk'
    apksign: true
    apksignerKeystoreFile: <keystore-filename.keystore>
    apksignerKeystorePassword: $(keystore-password)
    apksignerKeystoreAlias: $(key-alias)
    apksignerKeyPassword: $(key-password)

1. 基于 Android 或 Xamarin.Android 生成模板创建生成管道。 或者，如果你已有生成管道，请确保生成应用的任务后面存在 Android 签名任务。

2. 在 Android 签名任务中，选中签名选项下面的对 APK 签名复选框。

3. 选择密钥存储文件字段旁边的设置图标，然后从密钥存储文件下拉列表中选择上传的密钥存储文件。

4. 选择管道的变量选项卡并添加以下变量：

   名称	值
   keystore-password	未加密密钥存储文件的密码。 请务必选择锁图标来保护密码，并在日志中掩盖密码。
   key-alias	你生成的签名证书的密钥别名。
   key-password	与指定的别名关联的密钥的密码。 请务必选择锁形图标。

5. 在任务选项卡上，选择 Android 签名任务，并在签名选项中将新创建的变量的名称引用为 $(keystore-password)、$(key-alias) 和 $(key-password)。

• 在执行 Xcode 或 Xamarin.iOS 任务之前将 InstallAppleCertificate@2 任务添加到 YAML 管道中。 在此代码中，将 <secure-file.p12> 替换为上传的 .p12 文件的名称。 将此变量用于安全的 P12password。

  - task: InstallAppleCertificate@2
      inputs:
        certSecureFile: '<secure-file.p12>'
        certPwd: '$(P12password)'
  

  注意

  在 InstallAppleCertificate@2 任务中，deleteCert 参数默认为 true，这会在生成后删除证书。

• 在 Xcode 或 Xamarin.iOS 任务之前将 InstallAppleProvisioningProfile@1 任务添加到 YAML 中。 请将 <secure-file.mobileprovision> 替换为预配配置文件的名称。

  - task: InstallAppleProvisioningProfile@1
      inputs:
        provProfileSecureFile: '<secure-file.mobileprovision>'
  

  注意

  在 InstallAppleProvisioningProfile@1 任务中，removeProfile 参数默认为 true，这会在生成后删除配置文件。

• 在生成中的 Xcode 或 Xamarin.iOS 任务前面添加安装 Apple 证书任务。

  在安装 Apple 证书任务设置中：

  • 在证书 (P12) 字段旁边，从证书 (P12) 下拉列表中选择已上传的证书。
  • 在 证书 (P12) 密码字段中，引用 $(P12password) 变量。

• 在生成中的 Xcode 或 Xamarin.iOS 任务前面添加安装 Apple 预配配置文件任务。

  在安装 Apple 预配配置文件任务设置中：

  • 对于预配配置文件位置选项，请选择安全文件，然后在预配配置文件下拉列表中选择已上传的文件。
  • 选中标记为生成后删除配置文件的复选框，以确保在代理计算机上不保留预配配置文件。

• 在执行 Xcode 或 Xamarin.iOS 任务之前将 InstallAppleCertificate@2 任务添加到 YAML 管道中。 在此代码中，设置以下值：

  • certSecureFile：上传的 .p12 文件的名称。
  • certPwd：安全 P12password 的变量。
  • signingIdentity：签名标识的全名。
  • keychain：default，以允许访问默认密钥链。
  • keychainPassword：KEYCHAIN_PWD 变量。
  • deleteCert：false，用于在生成之间保留证书。

  - task: InstallAppleCertificate@2
    inputs:
      certSecureFile: '<secure-file.p12>'
      certPwd: '$(P12password)'
      signingIdentity: <full-signing-identity>
      keychain: default
      keychainPassword: `$(KEYCHAIN_PWD)
      deleteCert: false
  

• 添加 InstallAppleProvisioningProfile@1 任务。 在代码中：

  • 将 provProfileSecureFile 设置为你的预配配置文件的名称。
  • 将 removeProfile 设置为 false 以在生成之间保留配置文件。

  - task: InstallAppleProvisioningProfile@1
      inputs:
        provProfileSecureFile: '<secure-file.mobileprovision>'
        removeProfile: false
  

• 在生成中的 Xcode 或 Xamarin.iOS 任务前面添加安装 Apple 证书任务。 在安装 Apple 证书任务设置中：

  • 在证书 (P12) 字段旁边，从证书 (P12) 下拉列表中选择已上传的证书。
  • 在 证书 (P12) 密码字段中，引用 $(P12password) 变量。
  • 在高级下面，将密钥链设置为默认密钥链。
    • 将密钥链密码设置为密钥链密码变量。
    • 取消选中从密钥链中删除证书复选框，以在生成后将证书保留在代理计算机上。

• 在生成中的 Xcode 或 Xamarin.iOS 任务前面添加安装 Apple 预配配置文件任务。 在安装 Apple 预配配置文件任务设置中：

  • 对于预配配置文件位置选项，请选择安全文件，然后在预配配置文件下拉列表中选择已上传的文件。
  • 取消选中生成后删除配置文件复选框，以在生成后在代理计算机上保留预配配置文件。

对于 Xcode：

- task: Xcode@5
  inputs:
    signingOption: 'manual'
    signingIdentity: '$(APPLE_CERTIFICATE_SIGNING_IDENTITY)'
    provisioningProfileUuid: '$(APPLE_PROV_PROFILE_UUID)'

对于 Xamarin.iOS：

- task: XamariniOS@2
    inputs:
      solutionFile: '**/*.iOS.csproj'
      signingIdentity: '$(APPLE_CERTIFICATE_SIGNING_IDENTITY)'
      signingProvisioningProfileID: '$(APPLE_PROV_PROFILE_UUID)'

对于 Xcode 任务设置：

• 对于“签名样式”选项，请选择“手动签名”。
• 在“签名标识”字段中，输入 $(APPLE_CERTIFICATE_SIGNING_IDENTITY)。
• 在预配配置文件 UUID 字段中，输入 $(APPLE_PROV_PROFILE_UUID)。

对于 Xamarin.iOS 任务设置：

• 对于“替代方式”选项，请选择“标识符”。
• 在“签名标识”字段中，输入 $(APPLE_CERTIFICATE_SIGNING_IDENTITY)。
• 在“预配配置文件 UUID”字段中，输入 $(APPLE_PROV_PROFILE_UUID)。