您必須先設定 Google API 控制台專案並設定 Android Studio 專案,才能開始在應用程式中整合 Google 登入功能。本頁提供的步驟接下來,請按照後續步驟的說明,將 Google 登入功能整合至您的應用程式。
必要條件
Android 適用的 Google 登入功能符合下列需求:
- 搭載 Android 4.4 以上版本的相容 Android 裝置,包括 Google Play 商店,或具有 AVD 的模擬器,而 AVD 以搭載 Android 4.2.2 以上版本的 Google API 平台執行,且具有 Google Play 服務 15.0.0 以上版本。
- 最新版 Android SDK,包括 SDK 工具元件。 您可以透過 Android Studio 的 Android SDK Manager 取得 SDK。
- 針對 Android 4.4 (KitKat) 以上版本進行編譯的專案。
本指南的適用對象為 Android Studio,此為建議的開發環境。
新增 Google Play 服務
在專案的頂層 build.gradle
檔案中,確認已包含 Google 的 Maven 存放區:
allprojects {
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
}
然後在應用程式層級的 build.gradle
檔案中,宣告 Google Play 服務做為依附元件:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:20.4.1'
}
設定 Google API 控制台專案
- 在 API 控制台中開啟專案;如果您尚未建立專案,請先建立專案。
- 在 OAuth 同意畫面頁面上,確認所有資訊皆完整且正確。
- 在憑證頁面上,為您的應用程式建立 Android 類型用戶端 ID (如果您尚未建立)。您必須指定應用程式的套件名稱和 SHA-1 憑證指紋。詳情請參閱驗證用戶端一文。
取得後端伺服器的 OAuth 2.0 用戶端 ID
如果應用程式使用後端伺服器進行驗證或透過後端伺服器存取 Google API,則必須取得代表後端伺服器的 OAuth 2.0 用戶端 ID。
如何為伺服器建立用戶端 ID:
在 API 控制台中開啟專案。
在「憑證」頁面上建立「用戶端應用程式」類型。請記下用戶端 ID 字串,在建立
GoogleSignInOptions
物件時將必須傳遞至requestIdToken
或requestServerAuthCode
方法。
後續步驟
設定 Google API 主控台專案並設定 Android Studio 專案後,您可以在應用程式中整合 Google 登入功能。