使用我們的 Android 範例應用程式瞭解登入功能的運作方式,或是在現有應用程式中新增登入功能。
必要步驟:最新版的 Android Studio 和 Google Play 服務。
取得專案
如果您是第一次使用 Google 服務範例,請查看 google-services 存放區。
$ git clone https://github.com/googlesamples/google-services.git
開啟 Android Studio。
依序選取「File」>「Open」,瀏覽至您複製 google-services
存放區的位置,然後開啟 google-services/android/signin
。
設定 Google API 控制台專案
如要使用此範例,您必須使用 Android 用戶端和網頁應用程式用戶端設定 Google API 控制台專案:
- 在 API 控制台開啟現有專案,或是建立專案 (如果尚未建立)。
- 在 OAuth 同意畫面上,確認所有資訊皆完整且正確。
-
在「憑證」頁面上建立 Android 類型的用戶端 ID。範例應用程式的套件名稱為
com
。您也需提供簽署憑證指紋中的 SHA-1 雜湊。詳情請參閱「驗證用戶端」一文。.google .samples .quickstart .signin -
在「憑證」頁面上,建立「網頁應用程式」類型的用戶端 ID。您可以將「已授權的 JavaScript 來源」和「已授權的重新導向 URI」欄位留白。範例的
IdTokenActivity
和ServerAuthCodeActivity
範例需要這組網路用戶端 ID。在實際應用程式中,這個用戶端 ID 代表應用程式的後端伺服器。 -
複製用戶端 ID 並貼到專案的
strings.xml
檔案中:<string name="server_client_id">YOUR_SERVER_CLIENT_ID</string>
執行範例
您現在可以建構範例並透過 Android Studio 執行。
建構範例,然後按一下執行按鈕,然後選取已安裝最新版 Google Play 服務的連線裝置或模擬器。
![](https://developers.google.cn/static/identity/sign-in/android/images/gmpSignInAndroidRunSample.png?authuser=3&hl=zh-tw)
運作方式
應用程式會建構 GoogleSignInClient
,並指定所需的登入選項。之後,當使用者按一下登入按鈕時,應用程式會啟動登入意圖,提示使用者以 Google 帳戶登入。
// Configure sign-in to request the user's ID, email address, and basic // profile. ID and basic profile are included in DEFAULT_SIGN_IN. GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN) .requestEmail() .build();
// Build a GoogleSignInClient with the options specified by gso. mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
private void signIn() { Intent signInIntent = mGoogleSignInClient.getSignInIntent(); startActivityForResult(signInIntent, RC_SIGN_IN); }
後續步驟
如果您想瞭解如何在自己的應用程式中實作 Google 登入功能,請參閱實作指南。
您是否感覺愉快?遇到問題了嗎? 歡迎與我們聯絡!