AndroidSigning@3 – úloha podepisování androidu v3

Pomocí této úlohy v kanálu můžete podepsat a zarovnat soubory Android APK.

Syntaxe

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

Vstupy

apkFiles - souborů APK
Vstupní alias: files. string. Povinné. Výchozí hodnota: **/*.apk.

Relativní cesta z kořenového adresáře úložiště k souborům APK, které chcete podepsat. Pomocí zástupných znaků můžete zadat více souborů. Například:

• outputs\apk*.apk podepsat vše . Soubory APK v podsložce outputs\apk\.
• **/bin/*.apk podepsat vše . Soubory APK ve všech bin podsložkách.

apksign - Podepisovat APK
boolean. Výchozí hodnota: true.

Podepíše APK s poskytnutým souborem úložiště klíčů Pro Android. Nepodepsané sady API se dají spustit jenom v emulátoru. Aby bylo možné spustit na zařízení, musí být podepsané sady AKS.

souboru úložiště klíčů apksignerKeystoreFile -
Vstupní alias: keystoreFile. string. Požadováno při apksign = true.

Cesta k souboru android keystore, který slouží k podepsání APK. Tento soubor se musí nahrát do zabezpečené soubory knihovny, kde je bezpečně uložen s šifrováním. Po dokončení kanálu se soubor úložiště klíčů Androidu odebere z počítače agenta.

Soubor může být buď vrácený se změnami do správy zdrojového kódu, nebo přímo na buildovací počítač správcem. Doporučuje se zašifrovat soubor úložiště klíčů ve správě zdrojového kódu a pomocí úlohy Decrypt File dešifrovat soubor během sestavení.

apksignerKeystorePassword - hesla k úložišti klíčů
Vstupní alias: keystorePass. string. Volitelný. Používá se při apksign = true.

Heslo klíče pro zadaný soubor úložiště klíčů Androidu.

Důležité

K zašifrování této hodnoty použijte novou proměnnou s povoleným zámkem v podokně Proměnné. Viz tajných proměnných.

apksignerKeystoreAlias - alias
Vstupní alias: keystoreAlias. string. Volitelný. Používá se při apksign = true.

Alias, který identifikuje pár veřejného nebo privátního klíče, který se má použít v souboru úložiště klíčů Androidu.

apksignerKeyPassword - heslo klíče
Vstupní alias: keyPass. string. Volitelný. Používá se při apksign = true.

Heslo klíče pro alias a soubor úložiště klíčů.

Důležité

K zašifrování této hodnoty použijte novou proměnnou s povoleným zámkem v podokně Proměnné. Viz tajných proměnných.

apksignerVersion - apksigner verze
string. Volitelný. Používá se při apksign = true. Výchozí hodnota: latest.

Verze build-tools sady Android SDK, kterou apksigner spustitelný soubor používá pro úlohu.

apksignerArguments - argumenty apksigneru
string. Volitelný. Používá se při apksign = true. Výchozí hodnota: --verbose.

Poskytuje možnosti předání apksigner příkazovému řádku. Viz apksigner dokumentace.

apksignerFile - umístění apksigner
Vstupní alias: apksignerLocation. string. Volitelný. Používá se při apksign = true.

Určuje umístění spustitelného souboru apksigner použitého při podepisování. Ve výchozím nastavení se soubor apksigner nachází ve složce verze sady Android SDK, kterou vaše aplikace sestavuje.

zipalign - zipalign
boolean. Výchozí hodnota: true.

Vyberte, jestli chcete balíček zazipovat. Tím se sníží množství paměti RAM spotřebované aplikací.

zipalignVersion - verze zipalignu
string. Volitelný. Používá se při zipalign = true. Výchozí hodnota: latest.

Verze build-tools sady Android SDK, kterou zipalign spustitelný soubor používá pro úlohu.

umístění zipalignu zipalignFile -
Vstupní alias: zipalignLocation. string. Volitelný. Používá se při zipalign = true.

Určuje umístění spustitelného souboru zipalign použitého při podepisování. Výchozí hodnota je zipalign nalezená ve složce verze sady Android SDK, kterou vaše aplikace sestavuje.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Pomocí této úlohy v kanálu můžete podepsat a zarovnat soubory Android APK.

Tato verze úlohy používá apksigner soubory APK místo jarsigner k podepisování. AdnroidSigning@2 používá k podepisování souborů APK a AAB soubor jarsigner.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
Běží na	Agent, DeploymentGroup
požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke spouštění úloh, které používají tuto úlohu: JDK
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Tato úloha se spouští s následujícími omezeními příkazů : omezeno:
nastavitelné proměnné	Tento úkol má oprávnění nastavit následující proměnné: Nastavení proměnných je zakázáno.
Verze agenta	2.182.1 nebo vyšší
Kategorie úkolu	Stavět