AndroidSigning@3 – Android-Signatur v3-Aufgabe

Verwenden Sie diese Aufgabe in einer Pipeline, um Android-APK-Dateien zu signieren und auszurichten.

Syntax

# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #apksign: true # boolean. Sign the APK. Default: true.
    apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file. 
    #apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password. 
    #apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias. 
    #apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password. 
    #apksignerVersion: 'latest' # string. Optional. Use when apksign = true. apksigner version. Default: latest.
    #apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
    #apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location. 
  # Zipalign Options
    #zipalign: true # boolean. Zipalign. Default: true.
    #zipalignVersion: 'latest' # string. Optional. Use when zipalign = true. Zipalign version. Default: latest.
    #zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.
# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #apksign: true # boolean. Sign the APK. Default: true.
    apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file. 
    #apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password. 
    #apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias. 
    #apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password. 
    #apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
    #apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location. 
  # Zipalign Options
    #zipalign: true # boolean. Zipalign. Default: true.
    #zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.

Eingaben

apkFiles - APK-Dateien
Eingabealias: files. string. Erforderlich. Standardwert. **/*.apk.

Der relative Pfad vom Repo-Stamm zu den APK(n), den Sie signieren möchten. Sie können Wildcards verwenden, um mehrere Dateien anzugeben. Beispiel:

  • outputs\apk*.apk um alle zu signieren. APK-Dateien im outputs\apk\ Unterordner.
  • **/bin/*.apk um alle zu signieren. APK-Dateien in allen bin Unterordnern.

apksign - Signieren der APK
boolean. Standardwert. true.

Signiert die APK mit einer bereitgestellten Android Keystore-Datei. Nicht signierte APKs können nur in einem Emulator ausgeführt werden. APKs müssen signiert werden, um auf einem Gerät ausgeführt zu werden.


apksignerKeystoreFile - Keystore-Datei
Eingabealias: keystoreFile. string. Erforderlich, wenn apksign = true.

Der Dateipfad zur Android Keystore-Datei, die zum Signieren der APK verwendet wird. Diese Datei muss in die sichere Dateienbibliothek hochgeladen werden, wo sie sicher mit Verschlüsselung gespeichert wird. Die Android Keystore-Datei wird vom Agentcomputer entfernt, wenn die Pipeline abgeschlossen ist.

Die Datei kann entweder in die Quellcodeverwaltung eingecheckt oder direkt von einem Administrator auf dem Buildcomputer platziert werden. Es wird empfohlen, die Keystore-Datei in der Quellcodeverwaltung zu verschlüsseln und die Decrypt File Aufgabe zum Entschlüsseln der Datei während des Builds zu verwenden.


apksignerKeystorePassword - Schlüsselspeicherkennwort
Eingabealias: keystorePass. string. Optional. Verwenden Sie wann apksign = true.

Das Schlüsselkennwort für die bereitgestellte Android Keystore-Datei.

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperrung im Variablenbereich, um diesen Wert zu verschlüsseln. Weitere Informationen finden Sie unter geheimen Variablen.


apksignerKeystoreAlias - Alias
Eingabealias: keystoreAlias. string. Optional. Verwenden Sie wann apksign = true.

Der Alias, der das öffentliche/private Schlüsselpaar identifiziert, das in der Android Keystore-Datei verwendet werden soll.


apksignerKeyPassword - Schlüsselkennwort
Eingabealias: keyPass. string. Optional. Verwenden Sie wann apksign = true.

Das Schlüsselkennwort für die Alias- und Keystore-Datei.

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperrung im Variablenbereich, um diesen Wert zu verschlüsseln. Weitere Informationen finden Sie unter geheimen Variablen.


apksignerVersion - apksigner-Version
string. Optional. Verwenden Sie wann apksign = true. Standardwert. latest.

Die Android SDK-Buildtools-Version, die die ausführbare Datei für die apksigner Aufgabe verwendet.


apksignerArguments - apksigner-Argumente
string. Optional. Verwenden Sie wann apksign = true. Standardwert. --verbose.

Bietet Optionen zum Übergeben an die apksigner Befehlszeile. Weitere Informationen finden Sie in der Dokumentation zu apksigner.


apksignerFile - Apksigner-Speicherort
Eingabealias: apksignerLocation. string. Optional. Verwenden Sie wann apksign = true.

Gibt den Speicherort der ausführbaren Datei für apksigner an, die während der Signatur verwendet wird. Diese Standardeinstellung befindet sich im Android SDK-Versionsordner, für den Ihre Anwendung erstellt wird.


zipalign - Zipalign
boolean. Standardwert. true.

Wählen Sie aus, ob Sie Ihr Paket zipalign möchten. Dadurch wird die Anzahl der von einer App verbrauchten RAM reduziert.


zipalignVersion - Zipalign-Version
string. Optional. Verwenden Sie wann zipalign = true. Standardwert. latest.

Die Android SDK-Buildtools-Version, die die ausführbare Datei für die zipalign Aufgabe verwendet.


zipalignFile - Zipalign-Position
Eingabealias: zipalignLocation. string. Optional. Verwenden Sie wann zipalign = true.

Gibt den Speicherort der ausführbaren Datei an, die während der zipalign Signatur verwendet wird. Dies wird standardmäßig im Ordner "Android SDK-Version" gefunden, für den zipalign Ihre Anwendung erstellt wird.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen über Steuerungsoptionen zusätzlich zu ihren Aufgabeneingaben. Weitere Informationen finden Sie unter Steuerelementoptionen und gängige Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Bemerkungen

Verwenden Sie diese Aufgabe in einer Pipeline, um Android-APK-Dateien zu signieren und auszurichten.

Diese Version der Aufgabe verwendet apksigner anstelle von Jarsigner, um APKs zu signieren.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassisches Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbst gehostete Agents müssen Funktionen haben, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: JDK
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungen ausgeführt: eingeschränkt
Settable-Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Festlegen von Variablen ist deaktiviert.
Agent-Version 2.182.1 oder höher
Aufgabenkategorie Entwickeln
Anforderung Beschreibung
Pipelinetypen YAML, Klassisches Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbst gehostete Agents müssen Funktionen haben, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: JDK
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Settable-Variablen Any
Agent-Version 2.116.0 oder höher
Aufgabenkategorie Entwickeln
Anforderung Beschreibung
Pipelinetypen YAML, Klassisches Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbst gehostete Agents müssen Funktionen haben, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: JDK, AndroidSDK
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Settable-Variablen Any
Agent-Version 2.116.0 oder höher
Aufgabenkategorie Entwickeln