AndroidSigning@3 — zadanie podpisywania systemu Android w wersji 3

Użyj tego zadania w potoku, aby podpisać i wyrównać pliki APK systemu Android.

Składnia

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

Dane wejściowe

plików apkFiles - APK
Alias wejściowy: files. string. To jest wymagane. Wartość domyślna: **/*.apk.

Ścieżka względna z katalogu głównego repozytorium do plików APK, które chcesz podpisać. Aby określić wiele plików, można użyć symboli wieloznacznych. Na przykład:

• outputs\apk*.apk, aby podpisać wszystko . Pliki APK w podfolderze outputs\apk\.
• **/bin/*.apk, aby podpisać wszystko . Pliki APK we wszystkich podfolderach bin.

apksign - podpisywania APK
boolean. Wartość domyślna: true.

Podpisuje plik APK z udostępnionym plikiem magazynu kluczy systemu Android. Niepodpisane zestawy API mogą być uruchamiane tylko w emulatorze. Aby można było uruchamiać na urządzeniu, należy podpisać zestawy API.

pliku magazynu kluczy apksignerKeystoreFile -
Alias wejściowy: keystoreFile. string. Wymagane, gdy apksign = true.

Ścieżka pliku do pliku magazynu kluczy systemu Android, który jest używany do podpisywania pliku APK. Ten plik musi zostać przekazany do bezpiecznych plików biblioteki, gdzie jest bezpiecznie przechowywany przy użyciu szyfrowania. Po zakończeniu potoku plik magazynu kluczy systemu Android zostanie usunięty z komputera agenta.

Plik można zaewidencjonować w kontroli źródła lub umieścić na maszynie kompilacji bezpośrednio przez administratora. Zaleca się szyfrowanie pliku magazynu kluczy w kontroli źródła i użycie zadania Decrypt File do odszyfrowania pliku podczas kompilacji.

haseł magazynu kluczy apksignerKeystorePassword -
Alias wejściowy: keystorePass. string. Opcjonalny. Użyj polecenia , gdy apksign = true.

Hasło klucza dla podanego pliku magazynu kluczy systemu Android.

Ważne

Użyj nowej zmiennej z włączoną blokadą w okienku Zmienne, aby zaszyfrować tę wartość. Zobacz zmienne wpisu tajnego .

apksignerKeystoreAlias - alias
Alias wejściowy: keystoreAlias. string. Opcjonalny. Użyj polecenia , gdy apksign = true.

Alias identyfikujący parę kluczy publicznych/prywatnych do użycia w pliku magazynu kluczy systemu Android.

hasła klucza apksignerKeyPassword -
Alias wejściowy: keyPass. string. Opcjonalny. Użyj polecenia , gdy apksign = true.

Hasło klucza dla aliasu i pliku magazynu kluczy.

Ważne

Użyj nowej zmiennej z włączoną blokadą w okienku Zmienne, aby zaszyfrować tę wartość. Zobacz zmienne wpisu tajnego .

wersji apksignerVersion - apksigner
string. Opcjonalny. Użyj polecenia , gdy apksign = true. Wartość domyślna: latest.

Wersja narzędzi kompilacji zestawu SDK systemu Android używana przez plik wykonywalny apksigner dla zadania.

apksignerArguments - argumenty apksigner
string. Opcjonalny. Użyj polecenia , gdy apksign = true. Wartość domyślna: --verbose.

Udostępnia opcje przekazywania do wiersza polecenia apksigner. Zapoznaj się z dokumentacją apksigner.

lokalizacji apksignerFile - apksigner
Alias wejściowy: apksignerLocation. string. Opcjonalny. Użyj polecenia , gdy apksign = true.

Określa lokalizację pliku wykonywalnego apksigner używanego podczas podpisywania. Domyślnie jest to plik apksigner znajdujący się w folderze wersji zestawu Android SDK, dla którego aplikacja jest kompilowania.

zipalign - Zipalign
boolean. Wartość domyślna: true.

Wybierz, jeśli chcesz spakować pakiet. Zmniejsza to ilość pamięci RAM zużywanej przez aplikację.

zipalignVersion - wersji zipalign
string. Opcjonalny. Użyj polecenia , gdy zipalign = true. Wartość domyślna: latest.

Wersja narzędzi kompilacji zestawu SDK systemu Android używana przez plik wykonywalny zipalign dla zadania.

zipalignFile - lokalizacji zipalign
Alias wejściowy: zipalignLocation. string. Opcjonalny. Użyj polecenia , gdy zipalign = true.

Określa lokalizację pliku wykonywalnego zipalign używanego podczas podpisywania. Ta wartość domyślna to zipalign znaleziona w folderze wersji zestawu Android SDK tworzonym przez aplikację.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Użyj tego zadania w potoku, aby podpisać i wyrównać pliki APK systemu Android.

Ta wersja zadania używa elementu apksigner zamiast pliku jarsigner do podpisywania zestawów API.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: JDK
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń : ograniczone
zmienne ustawiane	To zadanie ma uprawnienia do ustawić następujące zmienne: Ustawienie zmiennych jest wyłączone
Wersja agenta	2.182.1 lub nowsza
Kategoria zadań	Zbuduj