将Google登录功能集成到您的Android应用中

要将Google登录功能集成到您的Android应用中,请配置Google登录并在您的应用布局中添加一个按钮,以启动登录流程。

在你开始之前

配置Google API控制台项目并设置您的Android Studio项目

配置Google登录和GoogleSignInClient对象

  1. 在登录活动的onCreate方法中,配置Google登录以请求您的应用所需的用户数据。例如,要配置Google登录以请求用户ID和基本个人资料信息,请使用DEFAULT_SIGN_IN参数创建一个GoogleSignInOptions对象。要同时请求用户的电子邮件地址,请使用requestEmail选项创建GoogleSignInOptions对象。

    // 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();

    如果您需要请求其他范围来访问Google API,请使用requestScopes指定。为了获得最佳的用户体验,请在登录时仅请求使应用程序正常运行所需的作用域。仅在需要时才请求其他作用域,以便用户在其执行的操作的上下文中看到同意屏幕。请参阅请求其他范围

  2. 然后,同样在登录活动的onCreate方法中,使用您指定的选项创建一个GoogleSignInClient对象。

    // Build a GoogleSignInClient with the options specified by gso.
    mGoogleSignInClient = GoogleSignIn.getClient(this, gso);

检查现有的登录用户

在活动的onStart方法中,检查用户是否已经通过Google登录到您的应用。

// Check for existing Google Sign In account, if the user is already signed in
// the GoogleSignInAccount will be non-null.
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
updateUI(account);

如果GoogleSignIn.getLastSignedInAccount返回一个GoogleSignInAccount对象(而不是null ),则该用户已经使用Google登录到您的应用程序。相应地更新您的UI,即隐藏登录按钮,启动您的主要活动或适合您的应用程序的任何操作。

如果GoogleSignIn.getLastSignedInAccount返回null ,则该用户尚未使用Google登录到您的应用。更新您的用户界面以显示Google登录按钮。

将Google登录按钮添加到您的应用中

  1. 标准的Google登录按钮在应用程序的布局中添加SignInButton

    <com.google.android.gms.common.SignInButton
     android:id="@+id/sign_in_button"
     android:layout_width="wrap_content"
     android:layout_height="wrap_content" />
    
  2. 可选:如果您使用默认的登录按钮图形而不是提供自己的登录按钮资产,则可以使用setSize方法自定义按钮的大小。

    // Set the dimensions of the sign-in button.
    SignInButton signInButton = findViewById(R.id.sign_in_button);
    signInButton.setSize(SignInButton.SIZE_STANDARD);
    
  3. 在Android活动中(例如,在onCreate方法中),注册按钮的OnClickListener以便在单击时登录用户:

    findViewById(R.id.sign_in_button).setOnClickListener(this);
    

开始登录流程

  1. 登录帐户选择器的图像在活动的onClick方法中,通过使用getSignInIntent方法创建登录意图并使用startActivityForResult启动意图来处理登录按钮的轻击。

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.sign_in_button:
                signIn();
                break;
            // ...
        }
    }
    
    private void signIn() {
        Intent signInIntent = mGoogleSignInClient.getSignInIntent();
        startActivityForResult(signInIntent, RC_SIGN_IN);
    }

    启动该意图会提示用户选择一个用于登录的Google帐户。如果您请求的范围超出profileemailopenid ,则还会提示用户授予对所请求资源的访问权限。

  2. 用户GoogleSignInAccount后,您可以在活动的onActivityResult方法中获取该用户的GoogleSignInAccount对象。

    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
    
        // Result returned from launching the Intent from GoogleSignInClient.getSignInIntent(...);
        if (requestCode == RC_SIGN_IN) {
            // The Task returned from this call is always completed, no need to attach
            // a listener.
            Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
            handleSignInResult(task);
        }
    }

    GoogleSignInAccount对象包含有关已登录用户的信息,例如用户名。

    private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
        try {
            GoogleSignInAccount account = completedTask.getResult(ApiException.class);
    
            // Signed in successfully, show authenticated UI.
            updateUI(account);
        } catch (ApiException e) {
            // The ApiException status code indicates the detailed failure reason.
            // Please refer to the GoogleSignInStatusCodes class reference for more information.
            Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
            updateUI(null);
        }
    }

    您还可以得到用户的电子邮件地址getEmail ,用户的谷歌标识(客户端使用)用getId和令牌与用户的ID getIdToken 。如果您需要将当前登录的用户传递到后端服务器,请将ID令牌发送到您的后端服务器,并在服务器上验证该令牌。