AndroidSigning@1 – Aufgabe "Android Signing v1"

Artikel
07/02/2024

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

Syntax

# Android Signing v1
# Sign and align Android APK files.
- task: AndroidSigning@1
  inputs:
    files: # string. Required. APK Files. 
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    keystoreFile: # string. Required when jarsign = true. Keystore File. 
    #keystorePass: # string. Optional. Use when jarsign = true. Keystore Password. 
    #keystoreAlias: # string. Optional. Use when jarsign = true. Alias. 
    #keyPass: # string. 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.
    #zipalignLocation: # string. Optional. Use when zipalign = true. Zipalign Location.

Eingaben

files - APK-Dateien
string. Erforderlich.

Der relative Pfad vom Repositorystamm zu den APK(s), die Sie signieren möchten. Sie können Feldhalter 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.

Der Standardwert: /.apk Argumentalias: apkFiles

jarsign - Signieren des APK
boolean. Standardwert. true.

Signiert das 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 können.

keystoreFile - Keystore-Datei
string. Erforderlich, wenn jarsign = true.

Der Dateipfad zur Android Keystore-Datei, die zum Signieren des APK verwendet wird. Diese Datei muss in die Bibliothek für sichere Dateien hochgeladen werden, wo sie sicher mit Verschlüsselung gespeichert wird. Die Android Keystore-Datei wird nach Abschluss der Pipeline vom Agent-Computer 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 zu verwenden, um die Datei während des Builds zu entschlüsseln.

Argumentaliase: apksignerKeystoreFile

keystorePass - Keystore-Kennwort
string. Optional. Verwenden Sie , wenn jarsign = 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. Weitere Informationen finden Sie unter Geheimnisvariablen.

Argumentaliase: apksignerKeystorePassword

keystoreAlias - Alias
string. Optional. Verwenden Sie , wenn jarsign = true.

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

Argumentaliase: apksignerKeystoreAlias

keyPass - Schlüsselkennwort
string. Optional. Verwenden Sie , wenn jarsign = true.

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

Wichtig

Verwenden Sie eine neue Variable mit aktivierter Sperre im Bereich Variablen, um diesen Wert zu verschlüsseln. Weitere Informationen finden Sie unter Geheime Variablen.

jarsignerArguments - Jarsigner-Argumente
string. Optional. Verwenden Sie , wenn jarsign = true. Standardwert. -verbose -sigalg MD5withRSA -digestalg SHA1.

Stellt Optionen bereit, die an die jarsigner Befehlszeile übergeben werden können.

zipalign - Zipalign
boolean. Standardwert. true.

Wählen Sie diesen booleschen Wert aus, wenn Sie Ihr Paket zipalign erstellen möchten. Dadurch wird der von einer App benötigte RAM reduziert.

zipalignLocation - Zipalign-Standort
string. Optional. Verwenden Sie , wenn zipalign = true.

Gibt den Speicherort der ausführbaren Zipalign-Datei an, die während der Signatur verwendet wird. Standardmäßig handelt es sich hierbei um die Zipalign-Datei, die sich in dem für Ihren Anwendungsbuild verwendeten Android SDK-Versionsordner befindet.

Argumentaliase: zipalignFile

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, 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
Einstellbare Variablen	Any
Agent-Version	1.98.1 oder höher
Aufgabenkategorie	Entwickeln

Freigeben über