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

apkFiles - Pliki APK
Alias wejściowy: files. string. Wymagane. Wartość domyślna: **/*.apk.

Ścieżka względna z katalogu głównego repozytorium do plików APK, które chcesz podpisać. Za pomocą symboli wieloznacznych można określić wiele plików. Przykład:

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

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

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

apksignerKeystoreFile - Plik magazynu kluczy
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 bezpiecznej biblioteki plików , w której jest bezpiecznie przechowywany przy użyciu szyfrowania. Po zakończeniu potoku plik magazynu kluczy systemu Android zostanie usunięty z maszyny 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 Decrypt File zadania do odszyfrowywania pliku podczas kompilacji.

apksignerKeystorePassword - Hasło magazynu kluczy
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 tajne.

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.

apksignerKeyPassword - Hasło klucza
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 tajne.

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

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

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

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

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

Określa lokalizację pliku wykonywalnego apksigner używanego podczas podpisywania. To ustawienie domyślne dla elementu apksigner znalezionego w folderze wersji zestawu Android SDK, względem którego aplikacja jest kompilować.

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

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

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

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

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

Określa lokalizację pliku wykonywalnego używanego zipalign podczas podpisywania. Ta wartość domyślna jest domyślnie zipalign znaleziono w folderze wersji zestawu Android SDK, dla którego aplikacja jest kompilowania.

Opcje sterowania zadaniami

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

Zmienne wyjściowe

Brak.

Uwagi

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

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: zestaw 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 w formie tabeli settable	To zadanie ma uprawnienia do ustawiania następujących zmiennych: Ustawienie zmiennych jest wyłączone
Wersja agenta	2.182.1 lub nowsza
Kategoria zadania	Kompilacja