Delen via


AndroidSigning@3 - Android-handtekening v3-taak

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

Syntaxis

# 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.

Invoer

apkFiles - APK-bestanden
Invoeralias: files. string. Verplicht. 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. Voorbeeld:

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

apksign - de APK- ondertekenen
boolean. Standaardwaarde: true.

Ondertekent de APK met een meegeleverd 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 - keystore-bestand
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 bestanden bibliotheek, 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 bij 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 - sleutelarchiefwachtwoord
Invoeralias: keystorePass. string. Facultatief. Gebruiken wanneer apksign = true.

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. Facultatief. Gebruiken wanneer apksign = true.

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


apksignerKeyPassword - sleutelwachtwoord
Invoeralias: keyPass. string. Facultatief. Gebruiken wanneer apksign = true.

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. Facultatief. Gebruiken wanneer apksign = true. Standaardwaarde: latest.

De versie van de Android SDK-buildhulpprogramma's die door het apksigner uitvoerbare bestand voor de taak wordt gebruikt.


apksignerArguments - apksigner-argumenten
string. Facultatief. Gebruiken wanneer apksign = true. Standaardwaarde: --verbose.

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


apksignerFile - apksigner-locatie
Invoeralias: apksignerLocation. string. Facultatief. Gebruiken wanneer apksign = true.

Hiermee geeft u de locatie op van het uitvoerbare bestand apksigner dat tijdens de ondertekening wordt gebruikt. Dit is standaard de apksigner die is gevonden in de android SDK-versiemap waarop 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. Facultatief. Gebruiken wanneer zipalign = true. Standaardwaarde: latest.

De versie van de Android SDK-buildhulpprogramma's die door het zipalign uitvoerbare bestand voor de taak wordt gebruikt.


zipalignFile - Zipalign-locatie
Invoeralias: zipalignLocation. string. Facultatief. Gebruiken wanneer zipalign = true.

Hiermee geeft u de locatie van het zipalign uitvoerbaar bestand dat tijdens de ondertekening wordt gebruikt. Dit is standaard ingesteld op de zipalign in de android SDK-versiemap waarop uw toepassing bouwt.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Deze versie van de taak gebruikt apksigner in plaats van jarsigner om APK's te ondertekenen. AdnroidSigning@2 gebruikt jarsigner om APK's en AAB's te ondertekenen.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: JDK
mogelijkheden 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 : Variabelen instellen is uitgeschakeld
Agentversie 2.182.1 of hoger
Taakcategorie Bouwen
Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: JDK
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 2.116.0 of hoger
Taakcategorie Bouwen