Freigeben über


AndroidSigning@3 – Android-Aufgabe "Signieren v3"

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.

Eingänge

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 Unterordner outputs\apk\.
  • **/bin/*.apk, um alle zu signieren. APK-Dateien in allen bin Unterordnern.

apksign - Signieren Sie die 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 sein, damit sie auf einem Gerät ausgeführt 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 sicheren Dateien Bibliothek hochgeladen werden, wo sie sicher mit Verschlüsselung gespeichert wird. Die Android Keystore-Datei wird nach Abschluss der Pipeline vom Agentcomputer entfernt.

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 Decrypt File Aufgabe zum Entschlüsseln der Datei während des Builds zu verwenden.


apksignerKeystorePassword - Keystore-Kennwort
Eingabealias: keystorePass. string. Wahlfrei. Wird verwendet, wenn apksign = true.

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

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperre im Bereich "Variablen", um diesen Wert zu verschlüsseln. Siehe geheimen Variablen.


apksignerKeystoreAlias - Alias-
Eingabealias: keystoreAlias. string. Wahlfrei. Wird verwendet, wenn 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. Wahlfrei. Wird verwendet, wenn apksign = true.

Das Schlüsselkennwort für die Alias- und Keystoredatei.

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperre im Bereich "Variablen", um diesen Wert zu verschlüsseln. Siehe geheimen Variablen.


apksignerVersion - apksigner Version
string. Wahlfrei. Wird verwendet, wenn apksign = true. Standardwert: latest.

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


apksignerArguments - apksigner-Argumente
string. Wahlfrei. Wird verwendet, wenn apksign = true. Standardwert: --verbose.

Stellt Optionen bereit, die an die Befehlszeile apksigner übergeben werden. Weitere Informationen finden Sie in der apksigner-Dokumentation.


apksignerFile - apksigner-Standort
Eingabealias: apksignerLocation. string. Wahlfrei. Wird verwendet, wenn apksign = true.

Gibt den Speicherort der ausführbaren Apksigner-Datei an, die beim Signieren verwendet wird. Dies ist standardmäßig der apksigner im Android SDK-Versionsordner enthalten, mit dem Ihre Anwendung erstellt wird.


zipalign - Zipalign-
boolean. Standardwert: true.

Wählen Sie aus, ob Sie Ihr Paket zipalignieren möchten. Dadurch wird die Menge des von einer App verbrauchten RAM reduziert.


zipalignVersion - Zipalign-Version
string. Wahlfrei. Wird verwendet, wenn zipalign = true. Standardwert: latest.

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


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

Gibt den Speicherort der zipalign ausführbaren Datei an, die beim Signieren verwendet wird. Dies ist standardmäßig die zipalign im Android SDK-Versionsordner gefunden, mit dem Ihre Anwendung erstellt wird.


Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

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, klassischer Build
Läuft auf Agent, DeploymentGroup
Anforderungen Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: JDK
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion 2.182.1 oder höher
Vorgangskategorie Bauen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, klassischer Build
Läuft auf Agent, DeploymentGroup
Anforderungen Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: JDK
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.116.0 oder höher
Vorgangskategorie Bauen