Sdílet prostřednictvím


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

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

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.

Vstupy

apkFiles - Soubory APK
Vstupní alias: files. string. Povinná hodnota. 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ů. Příklad:

  • outputs\apk*.apkk podepsání všech . Soubory APK v podsložce outputs\apk\
  • **/bin/*.apk k podepsání všech . Soubory APK ve všech bin podsložkách

apksign - Podepsání APK
boolean. Výchozí hodnota: true.

Podepíše apk s poskytnutým souborem Android Keystore. Nepodepsané sady API se můžou spouštět jenom v emulátoru. Aby bylo možné spouštět na zařízení, musí být podepsané sady API.


apksignerKeystoreFile - Soubor úložiště klíčů
Vstupní alias: keystoreFile. string. Vyžaduje se, když apksign = true.

Cesta k souboru Android Keystore, který se používá k podepsání APK. Tento soubor se musí nahrát do zabezpečené knihovny souborů , kde je bezpečně uložený pomocí šifrování. Po dokončení kanálu se soubor Úložiště klíčů Androidu odebere z počítače agenta.

Soubor je možné zkontrolovat ve správě zdrojového kódu nebo ho umístit přímo na počítač sestavení správcem. Doporučujeme zašifrovat soubor úložiště klíčů ve správě zdrojového kódu a použít Decrypt File úlohu k dešifrování souboru během sestavení.


apksignerKeystorePassword - Heslo úložiště klíčů
Vstupní alias: keystorePass. string. Nepovinný parametr. Použít, když apksign = true.

Heslo klíče pro zadaný soubor Android KeyStore.

Důležité

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


apksignerKeystoreAlias - Alias
Vstupní alias: keystoreAlias. string. Nepovinný parametr. Použít, když apksign = true.

Alias, který identifikuje pár veřejného nebo privátního klíče, který se má použít v souboru Android Keystore.


apksignerKeyPassword - Heslo klíče
Vstupní alias: keyPass. string. Nepovinný parametr. Použít, když apksign = true.

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

Důležité

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


apksignerVersion - apksigner verze
string. Nepovinný parametr. Použít, když apksign = true. Výchozí hodnota: latest.

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


apksignerArguments - Argumenty apksigneru
string. Nepovinný parametr. Použít, když apksign = true. Výchozí hodnota: --verbose.

Poskytuje možnosti pro předání do příkazového apksigner řádku. Projděte si dokumentaci apksigneru.


apksignerFile - apksigner umístění
Vstupní alias: apksignerLocation. string. Nepovinný parametr. Použít, když 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, na které se vaše aplikace sestavuje.


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

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


zipalignVersion - Verze zipalign
string. Nepovinný parametr. Použít, když zipalign = true. Výchozí hodnota: latest.

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


zipalignFile - Umístění zipalign
Vstupní alias: zipalignLocation. string. Nepovinný parametr. Použít, když zipalign = true.

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


Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace najdete v tématu Možnosti ovládacího prvku a společ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 místo jarsigner pro podepsání sad API.

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 funkce , které odpovídají následujícím požadavkům pro 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 spustí s využitím následujících omezení příkazů: omezené
Nastavitelné proměnné Tento úkol má oprávnění k nastavení následujících proměnných: Nastavení proměnných je zakázáno.
Verze agenta 2.182.1 nebo vyšší
Kategorie úloh Sestavení
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 funkce , které odpovídají následujícím požadavkům pro 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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.116.0 nebo vyšší
Kategorie úloh Sestavení
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 funkce , které odpovídají následujícím požadavkům pro spouštění úloh, které používají tuto úlohu: JDK, AndroidSDK
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.116.0 nebo vyšší
Kategorie úloh Sestavení