Trang này được dịch bởi Cloud Translation API.

Dễ dàng thêm tính năng đăng nhập vào ứng dụng Android bằng FirebaseUI

FirebaseUI là một thư viện được xây dựng dựa trên SDK Xác thực Firebase, cung cấp các luồng giao diện người dùng thả xuống để sử dụng trong ứng dụng của bạn. FirebaseUI mang lại những lợi ích sau:

Nhiều nhà cung cấp – quy trình đăng nhập bằng email/mật khẩu, đường liên kết email, xác thực qua điện thoại, Đăng nhập bằng Google, Đăng nhập bằng Facebook, Đăng nhập bằng Twitter và Đăng nhập bằng GitHub.
Quản lý tài khoản – các luồng để xử lý các nhiệm vụ quản lý tài khoản, chẳng hạn như tạo tài khoản và đặt lại mật khẩu.
Liên kết tài khoản – các luồng để liên kết an toàn tài khoản người dùng trên các nhà cung cấp danh tính.
Nâng cấp người dùng ẩn danh – các quy trình để nâng cấp người dùng ẩn danh một cách an toàn.
Giao diện tuỳ chỉnh – tuỳ chỉnh giao diện của FirebaseUI cho phù hợp với ứng dụng của bạn. Ngoài ra, vì FirebaseUI là nguồn mở, nên bạn có thể phân nhánh dự án và tuỳ chỉnh dự án đó theo đúng nhu cầu của mình.
Trình quản lý thông tin xác thực – tích hợp tự động với Trình quản lý thông tin xác thực để đăng nhập nhanh trên nhiều thiết bị.

Trước khi bắt đầu

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Android.

Thêm các phần phụ thuộc cho FirebaseUI vào tệp build.gradle(.kts) ở cấp ứng dụng. Nếu bạn muốn hỗ trợ đăng nhập bằng Facebook hoặc Twitter, hãy thêm cả SDK Facebook và Twitter:

    dependencies {
        // ...

        implementation("com.firebaseui:firebase-ui-auth:9.0.0")

        // Required only if Facebook login support is required
        // Find the latest Facebook SDK releases here: https://goo.gl/Ce5L94
        implementation("com.facebook.android:facebook-android-sdk:8.x")
    }

SDK xác thực FirebaseUI có các phần phụ thuộc bắc cầu trên SDK Firebase và SDK Dịch vụ Google Play.

Trong bảng điều khiển Firebase, hãy mở phần Xác thực rồi bật các phương thức đăng nhập mà bạn muốn hỗ trợ. Một số phương thức đăng nhập yêu cầu thêm thông tin, thường có trong bảng điều khiển dành cho nhà phát triển của dịch vụ.
Nếu bạn đã bật tính năng Đăng nhập bằng Google:
1. Khi được nhắc trong bảng điều khiển, hãy tải tệp cấu hình Firebase đã cập nhật xuống (google-services.json). Tệp này hiện chứa thông tin ứng dụng OAuth cần thiết để đăng nhập bằng Google.
2. Di chuyển tệp cấu hình đã cập nhật này vào dự án Android Studio, thay thế tệp cấu hình tương ứng đã lỗi thời. (Xem phần Thêm Firebase vào dự án Android.)
3. Nếu bạn chưa chỉ định vân tay SHA của ứng dụng, hãy thực hiện việc này trên trang Cài đặt của bảng điều khiển Firebase. Hãy xem phần Xác thực ứng dụng của bạn để biết thông tin chi tiết về cách lấy vân tay SHA của ứng dụng.

Nếu bạn hỗ trợ đăng nhập bằng Facebook hoặc Twitter, hãy thêm tài nguyên chuỗi vào strings.xml để chỉ định thông tin nhận dạng mà mỗi nhà cung cấp yêu cầu:


<resources>
  <!-- Facebook application ID and custom URL scheme (app ID prefixed by 'fb'). -->
  <string name="facebook_application_id" translatable="false">YOUR_APP_ID</string>
  <string name="facebook_login_protocol_scheme" translatable="false">fbYOUR_APP_ID</string>
</resources>

Đăng nhập

Tạo một ActivityResultLauncher để đăng ký lệnh gọi lại cho hợp đồng kết quả Hoạt động FirebaseUI:

Kotlin

// See: https://developer.android.com/training/basics/intents/result
private val signInLauncher = registerForActivityResult(
    FirebaseAuthUIActivityResultContract(),
) { res ->
    this.onSignInResult(res)
}FirebaseUIActivity.kt

Java

// See: https://developer.android.com/training/basics/intents/result
private final ActivityResultLauncher<Intent> signInLauncher = registerForActivityResult(
        new FirebaseAuthUIActivityResultContract(),
        new ActivityResultCallback<FirebaseAuthUIAuthenticationResult>() {
            @Override
            public void onActivityResult(FirebaseAuthUIAuthenticationResult result) {
                onSignInResult(result);
            }
        }
);FirebaseUIActivity.java

Để bắt đầu quy trình đăng nhập FirebaseUI, hãy tạo ý định đăng nhập bằng các phương thức đăng nhập mà bạn muốn:

Kotlin

// Choose authentication providers
val providers = arrayListOf(
    AuthUI.IdpConfig.EmailBuilder().build(),
    AuthUI.IdpConfig.PhoneBuilder().build(),
    AuthUI.IdpConfig.GoogleBuilder().build(),
    AuthUI.IdpConfig.FacebookBuilder().build(),
    AuthUI.IdpConfig.TwitterBuilder().build(),
)

// Create and launch sign-in intent
val signInIntent = AuthUI.getInstance()
    .createSignInIntentBuilder()
    .setAvailableProviders(providers)
    .build()
signInLauncher.launch(signInIntent)FirebaseUIActivity.kt

Java

// Choose authentication providers
List<AuthUI.IdpConfig> providers = Arrays.asList(
        new AuthUI.IdpConfig.EmailBuilder().build(),
        new AuthUI.IdpConfig.PhoneBuilder().build(),
        new AuthUI.IdpConfig.GoogleBuilder().build(),
        new AuthUI.IdpConfig.FacebookBuilder().build(),
        new AuthUI.IdpConfig.TwitterBuilder().build());

// Create and launch sign-in intent
Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .build();
signInLauncher.launch(signInIntent);FirebaseUIActivity.java

Khi quy trình đăng nhập hoàn tất, bạn sẽ nhận được kết quả trong onSignInResult:

Kotlin

private fun onSignInResult(result: FirebaseAuthUIAuthenticationResult) {
    val response = result.idpResponse
    if (result.resultCode == RESULT_OK) {
        // Successfully signed in
        val user = FirebaseAuth.getInstance().currentUser
        // ...
    } else {
        // Sign in failed. If response is null the user canceled the
        // sign-in flow using the back button. Otherwise check
        // response.getError().getErrorCode() and handle the error.
        // ...
    }
}FirebaseUIActivity.kt

Java

private void onSignInResult(FirebaseAuthUIAuthenticationResult result) {
    IdpResponse response = result.getIdpResponse();
    if (result.getResultCode() == RESULT_OK) {
        // Successfully signed in
        FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
        // ...
    } else {
        // Sign in failed. If response is null the user canceled the
        // sign-in flow using the back button. Otherwise check
        // response.getError().getErrorCode() and handle the error.
        // ...
    }
}FirebaseUIActivity.java

Thiết lập phương thức đăng nhập

Xác thực đường liên kết trong email

Trong bảng điều khiển Firebase, hãy mở mục Xác thực. Trên thẻ Phương thức đăng nhập, hãy bật trình cung cấp Email/Mật khẩu. Xin lưu ý rằng bạn phải bật tính năng đăng nhập bằng email/mật khẩu để sử dụng tính năng đăng nhập bằng đường liên kết trong email.
Trong cùng mục, hãy bật phương thức đăng nhập Đường liên kết qua email (đăng nhập không cần mật khẩu) rồi nhấp vào Lưu.
Bạn cũng sẽ phải bật Liên kết động của Firebase để sử dụng tính năng đăng nhập bằng đường liên kết email. Trong bảng điều khiển Firebase, hãy nhấp vào Đường liên kết động trong mục Tương tác trên thanh điều hướng. Nhấp vào Bắt đầu rồi thêm một miền. Miền bạn chọn ở đây sẽ được phản ánh trong các đường liên kết email được gửi đến người dùng.

Bạn có thể bật tính năng đăng nhập bằng đường liên kết email trong FirebaseUI bằng cách gọi enableEmailLinkSignIn trên một thực thể EmailBuilder. Bạn cũng cần cung cấp một đối tượng ActionCodeSettings hợp lệ với setHandleCodeInApp được đặt thành true. Ngoài ra, bạn cần đưa URL mà bạn truyền vào setUrl vào danh sách trắng. Bạn có thể thực hiện việc này trong bảng điều khiển Firebase, trong phần Xác thực -> Phương thức đăng nhập -> Miền được uỷ quyền.

Kotlin

val actionCodeSettings = ActionCodeSettings.newBuilder()
    .setAndroidPackageName( // yourPackageName=
        "...", // installIfNotAvailable=
        true, // minimumVersion=
        null,
    )
    .setHandleCodeInApp(true) // This must be set to true
    .setUrl("https://google.com") // This URL needs to be whitelisted
    .build()

val providers = listOf(
    EmailBuilder()
        .enableEmailLinkSignIn()
        .setActionCodeSettings(actionCodeSettings)
        .build(),
)
val signInIntent = AuthUI.getInstance()
    .createSignInIntentBuilder()
    .setAvailableProviders(providers)
    .build()
signInLauncher.launch(signInIntent)FirebaseUIActivity.kt

Java

ActionCodeSettings actionCodeSettings = ActionCodeSettings.newBuilder()
        .setAndroidPackageName(
                /* yourPackageName= */ "...",
                /* installIfNotAvailable= */ true,
                /* minimumVersion= */ null)
        .setHandleCodeInApp(true) // This must be set to true
        .setUrl("https://google.com") // This URL needs to be whitelisted
        .build();

List<AuthUI.IdpConfig> providers = Arrays.asList(
        new AuthUI.IdpConfig.EmailBuilder()
                .enableEmailLinkSignIn()
                .setActionCodeSettings(actionCodeSettings)
                .build()
);
Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .build();
signInLauncher.launch(signInIntent);FirebaseUIActivity.java

Nếu bạn muốn tìm thấy đường liên kết trong một hoạt động cụ thể, vui lòng làm theo các bước được nêu tại đây. Nếu không, đường liên kết sẽ chuyển hướng đến hoạt động của trình chạy.

Sau khi phát hiện đường liên kết sâu, bạn cần gọi xác minh để chúng tôi có thể xử lý đường liên kết đó cho bạn. Nếu có thể, bạn cần chuyển dữ liệu đó cho chúng tôi thông qua setEmailLink.

Kotlin

if (AuthUI.canHandleIntent(intent)) {
    val extras = intent.extras ?: return
    val link = extras.getString("email_link_sign_in")
    if (link != null) {
        val signInIntent = AuthUI.getInstance()
            .createSignInIntentBuilder()
            .setEmailLink(link)
            .setAvailableProviders(providers)
            .build()
        signInLauncher.launch(signInIntent)
    }
}FirebaseUIActivity.kt

Java

if (AuthUI.canHandleIntent(getIntent())) {
    if (getIntent().getExtras() == null) {
        return;
    }
    String link = getIntent().getExtras().getString("email_link_sign_in");
    if (link != null) {
        Intent signInIntent = AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setEmailLink(link)
                .setAvailableProviders(providers)
                .build();
        signInLauncher.launch(signInIntent);
    }
}FirebaseUIActivity.java

Không bắt buộc Hỗ trợ đăng nhập bằng đường liên kết trong email trên nhiều thiết bị, tức là bạn có thể dùng đường liên kết được gửi qua ứng dụng Android để đăng nhập trên trang web hoặc ứng dụng Apple. Theo mặc định, tính năng hỗ trợ nhiều thiết bị sẽ được bật. Bạn có thể tắt tính năng này bằng cách gọi setForceSameDevice trên thực thể EmailBuilder.

Hãy xem FirebaseUI-Web và FirebaseUI-iOS để biết thêm thông tin.

Đăng xuất

FirebaseUI cung cấp các phương thức thuận tiện để đăng xuất khỏi tính năng Xác thực Firebase cũng như tất cả các nhà cung cấp danh tính xã hội:

Kotlin

AuthUI.getInstance()
    .signOut(this)
    .addOnCompleteListener {
        // ...
    }FirebaseUIActivity.kt

Java

AuthUI.getInstance()
        .signOut(this)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            public void onComplete(@NonNull Task<Void> task) {
                // ...
            }
        });FirebaseUIActivity.java

Bạn cũng có thể xoá hoàn toàn tài khoản của người dùng:

Kotlin

AuthUI.getInstance()
    .delete(this)
    .addOnCompleteListener {
        // ...
    }FirebaseUIActivity.kt

Java

AuthUI.getInstance()
        .delete(this)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                // ...
            }
        });FirebaseUIActivity.java

Tùy chỉnh

Theo mặc định, FirebaseUI sử dụng AppCompat để tạo giao diện, nghĩa là giao diện này sẽ tự nhiên sử dụng bảng phối màu của ứng dụng. Nếu cần tuỳ chỉnh thêm, bạn có thể truyền giao diện và biểu trưng đến trình tạo Intent đăng nhập:

Kotlin

val signInIntent = AuthUI.getInstance()
    .createSignInIntentBuilder()
    .setAvailableProviders(providers)
    .setLogo(R.drawable.my_great_logo) // Set logo drawable
    .setTheme(R.style.MySuperAppTheme) // Set theme
    .build()
signInLauncher.launch(signInIntent)FirebaseUIActivity.kt

Java

Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setLogo(R.drawable.my_great_logo)      // Set logo drawable
        .setTheme(R.style.MySuperAppTheme)      // Set theme
        .build();
signInLauncher.launch(signInIntent);FirebaseUIActivity.java

Bạn cũng có thể đặt chính sách quyền riêng tư và điều khoản dịch vụ tuỳ chỉnh:

Kotlin

val signInIntent = AuthUI.getInstance()
    .createSignInIntentBuilder()
    .setAvailableProviders(providers)
    .setTosAndPrivacyPolicyUrls(
        "https://example.com/terms.html",
        "https://example.com/privacy.html",
    )
    .build()
signInLauncher.launch(signInIntent)FirebaseUIActivity.kt

Java

Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setTosAndPrivacyPolicyUrls(
                "https://example.com/terms.html",
                "https://example.com/privacy.html")
        .build();
signInLauncher.launch(signInIntent);FirebaseUIActivity.java

Các bước tiếp theo

Để biết thêm thông tin về cách sử dụng và tuỳ chỉnh FirebaseUI, hãy xem tệp README trên GitHub.
Nếu bạn phát hiện vấn đề trong FirebaseUI và muốn báo cáo vấn đề đó, hãy sử dụng công cụ theo dõi lỗi GitHub.

Dễ dàng thêm tính năng đăng nhập vào ứng dụng Android bằng FirebaseUI Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Trước khi bắt đầu

Đăng nhập

Kotlin

Java

Kotlin

Java

Kotlin

Java

Thiết lập phương thức đăng nhập

Xác thực đường liên kết trong email

Kotlin

Java

Kotlin

Java

Đăng xuất

Kotlin

Java

Kotlin

Java

Tùy chỉnh

Kotlin

Java

Kotlin

Java

Các bước tiếp theo

Dễ dàng thêm tính năng đăng nhập vào ứng dụng Android bằng FirebaseUI