안드로이드 구글맵 키 생성(Android Google Map API Key)

안드로이드에서 구글맵을 사용하려면 구글 맵 API Key가 필요합니다. 

구글 맵 API Key는 https://console.cloud.google.com/apis/에서 생성할 수 있습니다.

이때, 구글 맵 API에서는 SHA1 해시값이 필요한 데 이를 발행하는 절차는 다음과 같습니다.

#1 개발용(Debug) 키 - Android Studio에서 개발 시 필요

C:\Users\AI_HUBRIS\.android> keytool  -list  -v  -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android

C:\Users\AI_HUBRIS 는 '명령 프롬프트' 프로그램을 실행하면 나오는 경로입니다. 각자의 이름에 맞게 AI_HUBRIS는 다를 것입니다(예: C:\Users\MINSOO, C:\Users\MYCOM, C:\Users\PC, ...)

'명령 프롬프트'를 실행하고 해당 디렉터리를 보면 다양한 것들이 있는데 그중 '.android' 디렉터리로 이동합니다.

C:\Users\AI_HUBRIS> cd .android [enter]

C:\Users\AI_HUBRIS\.android>

그러면 위 상태에서 키를 생성해야 합니다. 

(keytool은 JDK 설치 디렉터리에 있습니다. JDK를 설치한 디렉터리가 C:\Program Files\Java\jdk1.8.0_144라면, 

C:\Program Files\Java\jdk1.8.0_144\bin 디렉터리에 keytool.exe 파일이 있습니다, 안드로이드 스튜디오를 설치 시 JDK 경로 설정을 하였다면 keytool이 아래와 같이 실행됩니다)

C:\Users\AI_HUBRIS\.android> keytool  -list  -v  -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android [enter]

JDK 경로가 설정돼 있지 않으면 아래처럼 사용하세요.

C:\Users\AI_HUBRIS\.android> "C:\Program Files\Java\jdk1.8.0_144\bin\keytool.exe"  -list  -v  -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android [enter]

그러면 아래와 같이 디버그용 키를 생성할 수 있는 인증서 지문에 보입니다.

별칭 이름: androiddebugkey

생성 날짜: 2018. 11. 9

항목 유형: PrivateKeyEntry

인증서 체인 길이: 1

인증서[1]:

소유자: C=US, O=Android, CN=Android Debug

발행자: C=US, O=Android, CN=Android Debug

일련 번호: 1

적합한 시작 날짜: Fri Nov 09 19:45:54 KST 2018, 종료 날짜: Sun Nov 01 19:45:54 KST 2048

인증서 지문:

         MD5: 7D:61:AD:C0:F3:63:2D:FD:4F:F6:3F:3D:8A:06:94:55

         SHA1: 7C:EF:32:34:93:65:95:6D:00:00:00:00:A6:8C:75:2B:52:25:10:74     <- 구글 API에 등록할 값

         SHA256: A7:19:24:36:A7:5C:B1:A0:5C:87:73:19:B7:6C:1A:BC:73:C4:56:FD:DE:A2:95:6F:9D:72:B4:40:5E:1E:3D:3B

         서명 알고리즘 이름: SHA1withRSA

         버전: 1

SHA1 값은 각자 PC마다 다르므로 위 값을 사용하면 안 되며, 각자 PC에서 표시된 값을 사용해야 합니다.

#2 배포용(Relese) 키 - 일반 배포 또는 구글 플레이스토어용

배표용 키는 다음과 같이 안드로이드 스튜디오의 메뉴에서 Build > Generate Signed APK...를 실행해 키 스토어 파일을 생성해야 합니다. 아래 그림에서는 myapp.jks(각자 앱에 맞게 이름을 설정, 예: test.jks, cat.jks, ...)으로 만들었으며, 처음 생성 시에는 Create new... 버튼을 클릭해 생성하면 됩니다.

아래와 같이 Key store path, 비밀번호(Password), 별칭(Alias) 등 필요한 정보를 입력합니다.

myapp.jks 키가 생성되었으면 일반 배포용 또는 구글 플레이스토어 배포용 키를 다음과 같이 생성할 수 있습니다.

C:\Dev\Android\Project\myapp> keytool -list -keystore myapp.jks [enter]

키 저장소 비밀번호 입력:  (여기에 생성 시 설정한 비밀번호 입력)

키 저장소 유형: JKS

키 저장소 제공자: SUN

키 저장소에 1개의 항목이 포함되어 있습니다.

auction, 2019. 3. 7, PrivateKeyEntry,

인증서 지문(SHA1): F2:50:7D:20:D2:D4:00:00:00:00:00:00:98:79:E2:FC:9C:D7:9D:31    <- 구글 API에 등록할 값

#3 참고할 구글 사이트는 다음과 같습니다.

https://developers.google.com/maps/documentation/android-sdk/signup

구글 맵 API Key는 https://console.cloud.google.com/apis/에서 생성할 수 있습니다.

구글에서 키를 Android 앱으로 등록해도 되고 다음처럼 등록해도 됩니다.

다음은 Android 앱에 키 제한을 두어 등록하는 화면입니다. 앱은 출시 후 구글에 의해 다시 서명되므로 구글에서 서명된 키를 아래처럼 등록하면 됩니다. 아래 화면은 Debug용 키와 구글 서명키를 등록한 화면입니다. 키는 등록 후 5분~10분 정도 후에 적용되는 경우가 있으므로 바로 적용되지 않더라도 잠시 기다리면 적용이 됩니다.