AndroidSigning@3 – Android Signing v3-uppgift

Använd den här uppgiften i en pipeline för att signera och justera Android APK-filer.

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.

Indata

apkFiles - APK-filer
Indataalias: files. string. Krävs. Standardvärde: **/*.apk.

Den relativa sökvägen från lagringsplatsens rot till de APK:er som du vill signera. Du kan använda jokertecken för att ange flera filer. Ett exempel:

• outputs\apk*.apk för att signera alla . APK-filer i undermappen outputs\apk\ .
• **/bin/*.apk för att signera alla . APK-filer i alla bin undermappar.

apksign - Signera APK
boolean. Standardvärde: true.

Signerar APK med en tillhandahållen Android Keystore-fil. Osignerade API:er kan bara köras i en emulator. API:er måste signeras för att köras på en enhet.

apksignerKeystoreFile - Keystore-fil
Indataalias: keystoreFile. string. Krävs när apksign = true.

Filsökvägen till Android Keystore-filen som används för att signera APK:en. Den här filen måste laddas upp till biblioteket för säkra filer , där den lagras säkert med kryptering. Android Keystore-filen tas bort från agentdatorn när pipelinen är klar.

Filen kan antingen checkas in i källkontrollen eller placeras på byggdatorn direkt av en administratör. Vi rekommenderar att du krypterar nyckelarkivfilen i källkontrollen och använder Decrypt File uppgiften för att dekryptera filen under bygget.

apksignerKeystorePassword - Nyckellagringslösenord
Indataalias: keystorePass. string. Valfritt. Använd när apksign = true.

Nyckellösenordet för den angivna Android Keystore-filen.

Viktigt

Använd en ny variabel med låset aktiverat i fönstret Variabler för att kryptera det här värdet. Se hemliga variabler.

apksignerKeystoreAlias - Alias
Indataalias: keystoreAlias. string. Valfritt. Använd när apksign = true.

Aliaset som identifierar det offentliga/privata nyckelparet som ska användas i Android Keystore-filen.

apksignerKeyPassword - Nyckellösenord
Indataalias: keyPass. string. Valfritt. Använd när apksign = true.

Nyckellösenordet för alias- och nyckelarkivfilen.

Viktigt

Använd en ny variabel med låset aktiverat i fönstret Variabler för att kryptera det här värdet. Se hemliga variabler.

apksignerVersion - apksigner-version
string. Valfritt. Använd när apksign = true. Standardvärde: latest.

Version av Android SDK-build-tools som den apksigner körbara versionen använder för uppgiften.

apksignerArguments - apksigner-argument
string. Valfritt. Använd när apksign = true. Standardvärde: --verbose.

Innehåller alternativ för att skicka till kommandoraden apksigner . Se apksigner-dokumentationen.

apksignerFile - apksigner-plats
Indataalias: apksignerLocation. string. Valfritt. Använd när apksign = true.

Anger platsen för den körbara apksigner som användes under signeringen. Detta är standardinställningen för den apksigner som finns i mappen Android SDK-version som ditt program bygger mot.

zipalign - Zipalign
boolean. Standardvärde: true.

Välj om du vill zipaljustera paketet. Detta minskar mängden RAM-minne som används av en app.

zipalignVersion - Zipalign-version
string. Valfritt. Använd när zipalign = true. Standardvärde: latest.

Version av Android SDK-build-tools som den zipalign körbara versionen använder för uppgiften.

zipalignFile - Zipalign-plats
Indataalias: zipalignLocation. string. Valfritt. Använd när zipalign = true.

Anger platsen för den zipalign körbara filen som användes under signeringen. Detta är standardinställningen för den zipalign som finns i mappen Android SDK-version som ditt program bygger mot.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften i en pipeline för att signera och justera Android APK-filer.

Den här versionen av aktiviteten använder apksigner i stället för jarsigner för att signera APK:er.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: JDK
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här aktiviteten körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här aktiviteten har behörighet att ange följande variabler: Inställningsvariabler har inaktiverats
Agentversion	2.182.1 eller senare
Uppgiftskategori	Skapa