AndroidSigning@3 - Android 서명 v3 작업

파이프라인에서 이 작업을 사용하여 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.

입력

apkFiles - APK 파일
입력 별칭: files. string. 필수 요소. 기본값은 **/*.apk입니다.

서명하려는 APK에 대한 리포지토리 루트의 상대 경로입니다. 와일드카드를 사용하여 여러 파일을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

• outputs\apk*.apk 모두 서명합니다. 하위 폴더의 outputs\apk\ APK 파일입니다.
• **/bin/*.apk 모두 서명합니다. 모든 bin 하위 폴더의 APK 파일입니다.

apksign - APK 서명
boolean. 기본값은 true입니다.

제공된 Android 키 저장소 파일을 사용하여 APK에 서명합니다. 서명되지 않은 APK는 에뮬레이터에서만 실행할 수 있습니다. APK는 디바이스에서 실행되도록 서명해야 합니다.

apksignerKeystoreFile - 키 저장소 파일
입력 별칭: keystoreFile. string. 필요한 경우 apksign = true.

APK에 서명하는 데 사용되는 Android Keystore 파일의 파일 경로입니다. 이 파일은 암호화를 사용하여 안전하게 저장되는 보안 파일 라이브러리에 업로드해야 합니다. Android Keystore 파일은 파이프라인이 완료되면 에이전트 컴퓨터에서 제거됩니다.

파일을 소스 제어에 체크 인하거나 관리자가 직접 빌드 컴퓨터에 배치할 수 있습니다. 소스 제어에서 키 저장소 파일을 암호화하고 작업을 사용하여 Decrypt File 빌드하는 동안 파일의 암호를 해독하는 것이 좋습니다.

apksignerKeystorePassword - 키 저장소 암호
입력 별칭: keystorePass. string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다.

제공된 Android Keystore 파일의 키 암호입니다.

중요

변수 창에서 잠금이 설정된 새 변수를 사용하여 이 값을 암호화합니다. 비밀 변수를 참조하세요.

apksignerKeystoreAlias - 별칭
입력 별칭: keystoreAlias. string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다.

Android Keystore 파일에서 사용할 공개/프라이빗 키 쌍을 식별하는 별칭입니다.

apksignerKeyPassword - 키 암호
입력 별칭: keyPass. string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다.

별칭 및 키 저장소 파일의 키 암호입니다.

중요

변수 창에서 잠금이 설정된 새 변수를 사용하여 이 값을 암호화합니다. 비밀 변수를 참조하세요.

apksignerVersion - apksigner 버전
string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다. 기본값은 latest입니다.

실행 파일이 작업에 사용하는 Android SDK 빌드 도구 버전 apksigner 입니다.

apksignerArguments - apksigner 인수
string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다. 기본값은 --verbose입니다.

명령줄에 전달하는 apksigner 옵션을 제공합니다. apksigner 설명서를 참조하세요.

apksignerFile - apksigner 위치
입력 별칭: apksignerLocation. string. 선택 사항입니다. 을 사용할 때 apksign = true사용합니다.

서명하는 동안 사용되는 apksigner 실행 파일의 위치를 지정합니다. 이는 기본적으로 애플리케이션이 빌드하는 Android SDK 버전 폴더에 있는 apksigner로 설정됩니다.

zipalign - Zipalign
boolean. 기본값은 true입니다.

패키지를 zipalign할 것인지 선택합니다. 이렇게 하면 앱에서 사용하는 RAM의 양이 줄어듭니다.

zipalignVersion - Zipalign 버전
string. 선택 사항입니다. 을 사용할 때 zipalign = true사용합니다. 기본값은 latest입니다.

실행 파일이 작업에 사용하는 Android SDK 빌드 도구 버전 zipalign 입니다.

zipalignFile - Zipalign 위치
입력 별칭: zipalignLocation. string. 선택 사항입니다. 을 사용할 때 zipalign = true사용합니다.

서명하는 동안 사용되는 실행 파일의 zipalign 위치를 지정합니다. 기본값은 애플리케이션이 zipalign 빌드하는 Android SDK 버전 폴더에 있는 것입니다.

작업 제어 옵션

모든 작업에는 해당 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

파이프라인에서 이 작업을 사용하여 Android APK 파일에 서명하고 정렬합니다.

이 버전의 태스크는 jarsigner 대신 apksigner를 사용하여 APK에 서명합니다.

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드
다음에서 실행	에이전트, DeploymentGroup
요청	자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. JDK
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한	이 작업은 다음 명령 제한을 사용하여 실행됩니다. 제한됨
설정 가능한 변수	이 작업에는 다음 변수를 설정할 수 있는 권한이 있습니다. 변수 설정이 비활성화되었습니다.
에이전트 버전	2.182.1 이상
작업 범주	빌드