Để tích hợp tính năng Đăng nhập bằng Google vào ứng dụng Android, hãy định cấu hình tính năng Đăng nhập bằng Google và thêm một nút vào bố cục của ứng dụng để bắt đầu quy trình đăng nhập.
Trước khi bắt đầu
Định cấu hình dự án Google API Console và thiết lập dự án Android Studio.
Định cấu hình tính năng Đăng nhập bằng Google và đối tượng GoogleSignInClient
Trong phương thức
onCreate
của hoạt động đăng nhập, hãy định cấu hình tính năng Đăng nhập bằng Google để yêu cầu dữ liệu người dùng mà ứng dụng của bạn yêu cầu. Ví dụ: để định cấu hình tính năng Đăng nhập bằng Google nhằm yêu cầu mã nhận dạng và thông tin hồ sơ cơ bản của người dùng, hãy tạo một đối tượngGoogleSignInOptions
bằng tham sốDEFAULT_SIGN_IN
. Để yêu cầu địa chỉ email của người dùng, hãy tạo đối tượngGoogleSignInOptions
bằng lựa chọnrequestEmail
.// 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();
Nếu bạn cần yêu cầu thêm các phạm vi để truy cập vào API của Google, hãy chỉ định các phạm vi đó bằng
requestScopes
. Để mang lại trải nghiệm tốt nhất cho người dùng, khi đăng nhập, bạn chỉ nên yêu cầu những phạm vi tối thiểu cần thiết để ứng dụng hoạt động. Chỉ yêu cầu các phạm vi bổ sung khi bạn cần, để người dùng thấy màn hình đồng ý trong bối cảnh của một hành động mà họ đã thực hiện. Xem phần Yêu cầu các phạm vi bổ sung.Sau đó, cũng trong phương thức
onCreate
của hoạt động đăng nhập, hãy tạo một đối tượngGoogleSignInClient
bằng các lựa chọn bạn đã chỉ định.// Build a GoogleSignInClient with the options specified by gso. mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
Kiểm tra xem người dùng đã đăng nhập có tồn tại hay không
Trong phương thức onStart
của hoạt động, hãy kiểm tra xem người dùng đã đăng nhập vào ứng dụng của bạn bằng Google hay chưa.
// 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);
Nếu GoogleSignIn.getLastSignedInAccount
trả về một đối tượng GoogleSignInAccount
(thay vì null
), thì người dùng đã đăng nhập vào ứng dụng của bạn bằng Google.
Cập nhật giao diện người dùng cho phù hợp, tức là ẩn nút đăng nhập, chạy hoạt động chính hoặc bất cứ điều gì phù hợp với ứng dụng của bạn.
Nếu GoogleSignIn.getLastSignedInAccount
trả về null
, tức là người dùng chưa đăng nhập vào ứng dụng của bạn bằng Google. Cập nhật giao diện người dùng để hiển thị nút Đăng nhập bằng Google.
Thêm nút Đăng nhập bằng Google vào ứng dụng của bạn
Thêm
SignInButton
vào bố cục của ứng dụng:<com.google.android.gms.common.SignInButton android:id="@+id/sign_in_button" android:layout_width="wrap_content" android:layout_height="wrap_content" />
Không bắt buộc: Nếu đang sử dụng đồ hoạ nút đăng nhập mặc định thay vì cung cấp các thành phần nút đăng nhập của riêng mình, bạn có thể tuỳ chỉnh kích thước của nút bằng phương thức
setSize
.// Set the dimensions of the sign-in button. SignInButton signInButton = findViewById(R.id.sign_in_button); signInButton.setSize(SignInButton.SIZE_STANDARD);
Trong hoạt động Android (ví dụ: trong phương thức
onCreate
), hãy đăng kýOnClickListener
của nút để đăng nhập khi người dùng nhấp vào:findViewById(R.id.sign_in_button).setOnClickListener(this);
Bắt đầu quy trình đăng nhập
Trong phương thức
onClick
của hoạt động, hãy xử lý các thao tác nhấn vào nút đăng nhập bằng cách tạo một ý định đăng nhập bằng phương thứcgetSignInIntent
và bắt đầu ý định bằngstartActivityForResult
.@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); }
Việc bắt đầu ý định sẽ nhắc người dùng chọn một Tài khoản Google để đăng nhập. Nếu bạn đã yêu cầu các phạm vi ngoài
profile
,email
vàopenid
, thì người dùng cũng sẽ được nhắc cấp quyền truy cập vào các tài nguyên được yêu cầu.Sau khi người dùng đăng nhập, bạn có thể nhận được một đối tượng
GoogleSignInAccount
cho người dùng trong phương thứconActivityResult
của hoạt động.@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); } }
Đối tượng
GoogleSignInAccount
chứa thông tin về người dùng đã đăng nhập, chẳng hạn như tên của người dùng đó.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); } }
Bạn cũng có thể lấy địa chỉ email của người dùng bằng
getEmail
, mã nhận dạng Google của người dùng (để sử dụng phía máy khách) bằnggetId
và mã thông báo nhận dạng cho người dùng bằnggetIdToken
. Nếu cần truyền người dùng hiện đã đăng nhập đến một máy chủ phụ trợ, hãy gửi mã thông báo nhận dạng đến máy chủ phụ trợ và xác thực mã thông báo đó trên máy chủ.