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