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 imoutputs\apk\
Unterordner.**/bin/*.apk
um alle zu signieren . APK-Dateien in allenbin
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 |