萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android Google Maps API Key 獲取完整教程(含 debug.keystore 與 keytool 詳解)

前言

在 Android 應用中集成 Google Maps(舊版 Maps API v1,現已棄用遷移至 Maps SDK for Android)需要獲取 API Key。核心步驟是通過 JDK keytool 從簽名文件 debug.keystore 提取 MD5 指紋,提交至 Google 開發者控制台獲取 Key。本文詳細記錄全流程操作。

核心概念

  • debug.keystore:Eclipse/ADT 時代調試簽名文件,現 Android Studio 同樣生成於 ~/.android/debug.keystore
  • keytool:JDK 自帶的密鑰和證書管理工具,位於 JDK_HOME/bin/keytool.exe
  • MD5 指紋:證書的唯一標識,Google Maps API v1 以此綁定應用

詳細操作步驟

步驟 1:定位 debug.keystore 文件

Eclipse/ADT 時代:

  1. 打開 Eclipse → Window → Preferences
  2. 導航至 Android → Build
  3. 查看 Default debug keystore 路徑,通常為:
  • Windows: C:\Users\用戶名\.android\debug.keystore
  • Mac/Linux: ~/.android/debug.keystore

Android Studio: 同樣位於上述默認路徑,或在項目 signingConfigs 中配置的路徑。

步驟 2:定位 keytool.exe

通常在 JDK 安裝目錄下:

  • Windows: C:\Program Files\Java\jdk版本\bin\keytool.exe
  • Mac/Linux: /usr/lib/jvm/.../bin/keytool 或直接在終端輸入 keytool

步驟 3:生成 MD5 指紋

打開命令行(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 行的值(去除冒號或保留均可,提交時通常需去除冒號)。

步驟 4:申請 Google Maps API Key

  1. 訪問 Google Maps API 註冊頁(舊版 v1 地址,現已重定向至新版控制台)
  2. 現代流程:訪問 Google Cloud Console
  3. 創建/選擇項目 → API 和服務 → 庫 → 搜索並啟用 Maps SDK for Android
  4. 憑證 → 創建憑證 → API 密鑰
  5. 在「應用限制」選 Android 應用,添加包名和 SHA-1 指紋(注意:現代版本使用 SHA-1,非 MD5)
  6. 點擊保存,生成的 API Key 即為所需 Key

關鍵遷移說明:從 MD5 到 SHA-1

重要: 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

常見問題排查

1. 無法訪問 Google 開發者頁面

修改 hosts 文件(需管理員權限):

  • Windows: C:\Windows\System32\drivers\etc\hosts
  • Mac/Linux: /etc/hosts

添加條目(IP 可能隨時間失效,建議使用代理):

203.208.45.200 google-developers.appspot.com
203.208.45.200 code.google.com

2. keytool 非內部命令

將 JDK bin 目錄添加到系統 PATH 環境變量,或使用完整路徑調用。

3. 發布版簽名

正式發布時需使用發布簽名文件 (release.keystore) 獲取 SHA-1,並在 Google Cloud Console 中添加該指紋。調試版和發布版 Key 互不相容。

現代開發建議

  • 使用 Maps SDK for Android 替代舊版 MapView
  • 配置 build.gradle 中的 signingConfigs 統一管理簽名
  • 使用 ./gradlew signingReport 快速查看所有變體的 SHA-1/MD5
  • 啟用 API Key 限制(包名 + 指紋 + API 限制)保障安全
copyright © 萬盛學電腦網 all rights reserved