안드로이드 서명 정보 보기

signingReport 명령어는 안드로이드 프로젝트의 빌드 변형(build variant)별 서명(signing) 정보를 출력하는 Gradle Task입니다. 이 명령어를 실행하면 각 빌드 변형에 설정된 키 스토어(keystore), 키 앨리어스(key alias), 그리고 중요한 SHA-1, SHA-256, MD5 등의 서명 해시(certificate fingerprint) 값을 확인할 수 있습니다.

왜 signingReport 명령어가 중요할까요?

• 앱 서명 정보 확인: 앱을 배포하기 위해서는 반드시 서명이 필요합니다. 이 명령어를 통해 앱이 어떤 키로 서명되었는지 정확하게 확인할 수 있습니다.
• Firebase 연동: Firebase와 같은 백엔드 서비스와 앱을 연동할 때, 앱의 서명 해시 값을 등록해야 하는 경우가 많습니다. signingReport를 통해 필요한 해시 값을 쉽게 얻을 수 있습니다.
• Google Play 앱 서명 확인: Google Play Console에서 앱 서명을 관리하는 경우, 업로드된 앱의 서명 정보를 확인하고 싶을 때 유용합니다.
• 디버그 및 릴리스 키 확인: 개발 과정에서는 디버그 키로 서명하고, 실제 배포 시에는 릴리스 키로 서명합니다. signingReport를 통해 각 빌드 변형에 어떤 키가 설정되어 있는지 명확히 파악할 수 있습니다.
• 문제 해결: 앱 서명 관련 오류가 발생했을 때, signingReport 결과를 통해 문제의 원인을 파악하는 데 도움이 됩니다.

signingReport 명령어 사용 방법

Android Studio를 사용하신다면, 다음과 같은 방법으로 signingReport 명령어를 실행할 수 있습니다.

1. Terminal 창 열기: Android Studio 하단의 "Terminal" 탭을 클릭하여 터미널 창을 엽니다. 프로젝트의 루트 디렉토리로 이동되어 있는지 확인하세요.

2. 명령어 실행: 터미널에 다음 명령어를 입력하고 Enter 키를 누릅니다.

./gradlew signingReport

• Windows 환경에서는 ./gradlew 대신 gradlew를 사용합니다.

gradlew signingReport

3. 결과 확인: 명령어가 성공적으로 실행되면, 각 빌드 변형 (debug, release 등)에 대한 서명 정보가 터미널에 출력됩니다. 출력 결과에서 다음과 같은 정보를 확인할 수 있습니다.

> Task :app:signingReport

Variant: debug
Config: debug
Store: /Users/your_user/.android/debug.keystore
Alias: AndroidDebugKey
MD5: XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX
SHA1: YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY:YY
SHA-256: ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ:ZZ

Variant: release
Config: release
Store: /path/to/your/release.keystore
Alias: your_release_key_alias
MD5: AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA
SHA1: BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB:BB
SHA-256: CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC

• Variant: 빌드 변형 이름 (예: debug, release)
• Config: 빌드 타입 (예: debug, release)
• Store: 키 스토어 파일 경로
• Alias: 키 앨리어스 이름
• MD5, SHA1, SHA-256: 서명 해시 값

팁

• 특정 빌드 변형의 서명 정보만 확인하고 싶다면, 다음과 같이 빌드 변형 이름을 명시할 수 있습니다.

./gradlew signingReport -Pandroid.variant=release

또는

./gradlew app:signingReport -Pandroid.variant=debug

• build.gradle (app) 파일의 signingConfigs 블록에서 키 스토어 정보가 어떻게 설정되어 있는지 함께 확인하면 signingReport 결과의 이해도를 높일 수 있습니다.