AndroidSigning@3 - Taak Android-ondertekening v3

Gebruik deze taak in een pijplijn om Android APK-bestanden te ondertekenen en uit te lijnen.

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.

Invoerwaarden

apkFiles - APK-bestanden
Invoeralias: files. string. Vereist. Standaardwaarde: **/*.apk.

Het relatieve pad van de hoofdmap van de opslagplaats naar de APK('s) die u wilt ondertekenen. U kunt jokertekens gebruiken om meerdere bestanden op te geven. Bijvoorbeeld:

• outputs\apk*.apk om alles te ondertekenen. APK-bestanden in de outputs\apk\ submap.
• **/bin/*.apk om alles te ondertekenen. APK-bestanden in alle bin submappen.

apksign - De APK ondertekenen
boolean. Standaardwaarde: true.

Ondertekent de APK met een opgegeven Android Keystore-bestand. Niet-ondertekende API's kunnen alleen worden uitgevoerd in een emulator. API's moeten zijn ondertekend om te worden uitgevoerd op een apparaat.

apksignerKeystoreFile - Sleutelarchiefbestand
Invoeralias: keystoreFile. string. Vereist wanneer apksign = true.

Het bestandspad naar het Android Keystore-bestand dat wordt gebruikt om de APK te ondertekenen. Dit bestand moet worden geüpload naar de beveiligde bestandsbibliotheek , waar het veilig wordt opgeslagen met versleuteling. Het Android KeyStore-bestand wordt verwijderd van de agentcomputer wanneer de pijplijn is voltooid.

Het bestand kan worden ingecheckt in broncodebeheer of rechtstreeks door een beheerder op de buildcomputer worden geplaatst. Het wordt aanbevolen om het sleutelarchiefbestand in broncodebeheer te versleutelen en de Decrypt File taak te gebruiken om het bestand tijdens de build te ontsleutelen.

apksignerKeystorePassword - Wachtwoord voor sleutelarchief
Invoeralias: keystorePass. string. Optioneel. apksign = trueWanneer gebruiken.

Het sleutelwachtwoord voor het opgegeven Android KeyStore-bestand.

Belangrijk

Gebruik een nieuwe variabele met de vergrendeling ingeschakeld in het deelvenster Variabelen om deze waarde te versleutelen. Zie geheime variabelen.

apksignerKeystoreAlias - Alias
Invoeralias: keystoreAlias. string. Optioneel. apksign = trueWanneer gebruiken.

De alias die het openbare/persoonlijke sleutelpaar identificeert dat moet worden gebruikt in het Android Keystore-bestand.

apksignerKeyPassword - Sleutelwachtwoord
Invoeralias: keyPass. string. Optioneel. apksign = trueWanneer gebruiken.

Het sleutelwachtwoord voor het alias- en sleutelarchiefbestand.

Belangrijk

Gebruik een nieuwe variabele met de vergrendeling ingeschakeld in het deelvenster Variabelen om deze waarde te versleutelen. Zie geheime variabelen.

apksignerVersion - apksigner-versie
string. Optioneel. apksign = trueWanneer gebruiken. Standaardwaarde: latest.

De buildhulpprogrammaversie van de Android SDK die door het apksigner uitvoerbare bestand voor de taak wordt gebruikt.

apksignerArguments - apksigner-argumenten
string. Optioneel. apksign = trueWanneer gebruiken. Standaardwaarde: --verbose.

Biedt opties om door te geven aan de apksigner opdrachtregel. Raadpleeg de apksigner-documentatie.

apksignerFile - apksigner-locatie
Invoeralias: apksignerLocation. string. Optioneel. apksign = trueWanneer gebruiken.

Hiermee geeft u de locatie van het uitvoerbare bestand apksigner dat wordt gebruikt tijdens het ondertekenen. Dit is standaard de apksigner die is gevonden in de android SDK-versiemap waarmee uw toepassing bouwt.

zipalign - Zipalign
boolean. Standaardwaarde: true.

Selecteer of u uw pakket wilt zipaligneren. Dit vermindert de hoeveelheid RAM-geheugen die door een app wordt verbruikt.

zipalignVersion - Zipalign-versie
string. Optioneel. zipalign = trueWanneer gebruiken. Standaardwaarde: latest.

De buildhulpprogrammaversie van de Android SDK die door het zipalign uitvoerbare bestand voor de taak wordt gebruikt.

zipalignFile - Zipalign-locatie
Invoeralias: zipalignLocation. string. Optioneel. zipalign = trueWanneer gebruiken.

Hiermee geeft u de locatie op van het zipalign uitvoerbare bestand dat tijdens de ondertekening wordt gebruikt. Deze standaardinstelling is de map met de zipalign Android SDK-versie waarmee uw toepassing bouwt.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast de taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak in een pijplijn om Android APK-bestanden te ondertekenen en uit te lijnen.

In deze versie van de taak wordt apksigner gebruikt in plaats van jarsigner om API's te ondertekenen.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende vereisten voor het uitvoeren van taken die gebruikmaken van deze taak: JDK
Functies	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
Variabelen instellen	Deze taak is gemachtigd om de volgende variabelen in te stellen: Het instellen van variabelen is uitgeschakeld
Agentversie	2.182.1 of hoger
Taakcategorie	Build