Freigeben über


AndroidSigning@2 – Android Signieren v2-Aufgabe

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

Syntax

# Android Signing v2
# Sign and align Android APK files.
- task: AndroidSigning@2
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    jarsignerKeystoreFile: # string. Alias: keystoreFile. Required when jarsign = true. Keystore file. 
    #jarsignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when jarsign = true. Keystore password. 
    #jarsignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when jarsign = true. Alias. 
    #jarsignerKeyPassword: # string. Alias: keyPass. Optional. Use when jarsign = true. Key password. 
    #jarsignerArguments: '-verbose -sigalg MD5withRSA -digestalg SHA1' # string. Optional. Use when jarsign = true. Jarsigner arguments. Default: -verbose -sigalg MD5withRSA -digestalg SHA1.
  # 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 Repositorystamm zu den APK(n), die 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.

jarsign - Signieren der APK
boolean. Standardwert. true.

Signiert die APK mit einer bereitgestellten Keystoredatei. 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.


jarsignerKeystoreFile - Keystore-Datei
Eingabealias: keystoreFile. string. Erforderlich, wenn jarsign = 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 Keystoredatei in der Quellcodeverwaltung zu verschlüsseln und die Aufgabe zum Entschlüsseln der Decrypt File Datei während des Builds zu verwenden.


jarsignerKeystorePassword - Schlüsselspeicherkennwort
Eingabealias: keystorePass. string. Optional. Wird verwendet, wenn jarsign = true.

Das Kennwort für die bereitgestellte Android Keystore-Datei.

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen", um diesen Wert zu verschlüsseln. Siehe geheime Variablen.


jarsignerKeystoreAlias - Alias
Eingabealias: keystoreAlias. string. Optional. Wird verwendet, wenn jarsign = true.

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


jarsignerKeyPassword - Schlüsselkennwort
Eingabealias: keyPass. string. Optional. Wird verwendet, wenn jarsign = true.

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

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperre auf der Registerkarte "Variablen", um diesen Wert zu verschlüsseln. Siehe geheime Variablen.


jarsignerArguments - Jarsigner-Argumente
string. Dies ist optional. Wird verwendet, wenn jarsign = true. Standardwert. -verbose -sigalg MD5withRSA -digestalg SHA1.

Bietet Optionen zum Übergeben an die jarsigner Befehlszeile.


zipalign - Zipalign
boolean. Standardwert. true.

Wählen Sie dieses boolesche Objekt aus, wenn Sie Ihr Paket zipalignieren möchten. Dadurch wird der von einer App verbrauchte RAM reduziert.


zipalignFile - Zipalign-Position
Eingabealias: zipalignLocation. string. Optional. Wird verwendet, wenn zipalign = true.

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


Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keine.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbst gehostete Agents müssen Über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: JDK
Capabilities Dieser Vorgang erfüllt keine Anforderungen an nachfolgende Vorgänge 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, Klassischer Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbst gehostete Agents müssen Über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: JDK
Capabilities Dieser Vorgang erfüllt keine Anforderungen an nachfolgende Vorgänge 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