在 Android 應用中集成 Google Maps(舊版 Maps API v1,現已棄用遷移至 Maps SDK for Android)需要獲取 API Key。核心步驟是通過 JDK keytool 從簽名文件 debug.keystore 提取 MD5 指紋,提交至 Google 開發者控制台獲取 Key。本文詳細記錄全流程操作。
~/.android/debug.keystoreJDK_HOME/bin/keytool.exeEclipse/ADT 時代:
C:\Users\用戶名\.android\debug.keystore~/.android/debug.keystoreAndroid Studio: 同樣位於上述默認路徑,或在項目 signingConfigs 中配置的路徑。
通常在 JDK 安裝目錄下:
C:\Program Files\Java\jdk版本\bin\keytool.exe/usr/lib/jvm/.../bin/keytool 或直接在終端輸入 keytool打開命令行(CMD/PowerShell/Terminal),執行:
# 進入 keytool 目錄(或配置 PATH 環境變量後直接調用) cd "C:\Program Files\Java\jdk1.8.0_xxx\bin" # 執行指紋提取命令 keytool -list -v -keystore "C:\Users\用戶名\.android\debug.keystore"
提示輸入密碼時直接按 Enter(默認密碼為空)。
輸出示例:
Keystore type: JKS
Keystore provider: SUN
Your keystore contains 1 entry
Alias name: androiddebugkey
Creation date: 2023-01-15
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 12345678
Valid from: Mon Jan 15 10:00:00 CST 2023 until: Wed Jan 08 10:00:00 CST 2053
Certificate fingerprints:
MD5: 94:1E:43:49:87:73:BB:82:1A:34:56:78:9A:BC:DE:F0
SHA1: ...
SHA256: ...
Signature algorithm name: SHA256withRSA
Subject Public Key Algorithm: 2048-bit RSA
Version: 3
複製 MD5 行的值(去除冒號或保留均可,提交時通常需去除冒號)。
重要: Google Maps API v1(基於 MD5)已於 2013 年停止服務,現行 Maps SDK for Android 使用 SHA-1 指紋。獲取 SHA-1 方式相同,只需在 keytool 輸出中複製 SHA1 行的值。
# 直接獲取 SHA1(無需 -v 參數) keytool -list -keystore "C:\Users\用戶名\.android\debug.keystore" # 輸出: Certificate fingerprint (SHA1): 94:1E:43:49:87:73:BB:82:1A:34:56:78:9A:BC:DE:F0:12:34:56:78
修改 hosts 文件(需管理員權限):
C:\Windows\System32\drivers\etc\hosts/etc/hosts添加條目(IP 可能隨時間失效,建議使用代理):
203.208.45.200 google-developers.appspot.com 203.208.45.200 code.google.com
將 JDK bin 目錄添加到系統 PATH 環境變量,或使用完整路徑調用。
正式發布時需使用發布簽名文件 (release.keystore) 獲取 SHA-1,並在 Google Cloud Console 中添加該指紋。調試版和發布版 Key 互不相容。
build.gradle 中的 signingConfigs 統一管理簽名./gradlew signingReport 快速查看所有變體的 SHA-1/MD5