다음을 통해 공유


AndroidSigning@3 - Android 서명 v3 작업

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

구문론

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

입력

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

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

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

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

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


apksignerKeystoreFile - Keystore 파일
입력 별칭: 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때 사용합니다.

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

중요합니다

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


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

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


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

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


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

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


zipalign - 지퍼 정렬
boolean; 기본값은 true입니다.

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


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

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


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

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


작업 제어 옵션

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

출력 변수

없음.

비고

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

이 버전의 작업은 APK에 서명하는 대신 jarsigner 사용합니다apksigner. AdnroidSigning@2 는 jarsigner를 사용하여 APK 및 AAB에 서명합니다.

요구 사항

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