Pierwsze kroki z Uwierzytelnianiem Firebase na Androidzie

Łączenie aplikacji z Firebase

Jeśli jeszcze tego nie zrobisz, dodaj Firebase do swojego projektu aplikacji na Androida.

Dodawanie Firebase Authentication do aplikacji

1. W pliku Gradle na poziomie modułu (aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależność od biblioteki Firebase Authentication na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji bibliotek.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.12.0"))
   
       // Add the dependency for the Firebase Authentication library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth")
   }

   Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

   (Alternatywa)  Dodawanie zależności od biblioteki Firebase bez użycia BoM

   Jeśli nie chcesz używać Firebase BoM, musisz określić wersję każdej biblioteki Firebase w wierszu zależności.

   Pamiętaj, że jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji.

   dependencies {
       // Add the dependency for the Firebase Authentication library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth:24.0.1")
   }

2. Aby korzystać z dostawcy uwierzytelniania, musisz go włączyć w Firebase konsoli. Otwórz stronę Metoda logowania w sekcji Firebase Authentication , aby włączyć logowanie za pomocą e-maila i hasła oraz innych dostawców tożsamości , których chcesz używać w aplikacji.

(Opcjonalnie) Prototypowanie i testowanie za pomocą Firebase Local Emulator Suite

Zanim omówimy, jak aplikacja uwierzytelnia użytkowników, przedstawimy zestaw narzędzi, których możesz używać do prototypowania i testowania Authentication funkcji: Firebase Local Emulator Suite. Jeśli zastanawiasz się nad technikami i dostawcami uwierzytelniania , testujesz różne modele danych z danymi publicznymi i prywatnymi za pomocą Authentication i Firebase Security Rules lub prototypujesz projekty interfejsu logowania, możliwość pracy lokalnej bez wdrażania usług na żywo może być dobrym pomysłem.

Emulator Authentication jest częścią pakietu Local Emulator Suite, który umożliwia aplikacji interakcję z emulowaną zawartością bazy danych i konfiguracją, a także opcjonalnie z emulowanymi zasobami projektu (funkcjami, innymi bazami danych i regułami bezpieczeństwa).

Korzystanie z emulatora Authentication wymaga wykonania kilku czynności:

1. Dodanie wiersza kodu do konfiguracji testowej aplikacji, aby połączyć się z emulatorem.
2. Uruchomienie polecenia firebase emulators:start w katalogu głównym projektu lokalnego.
3. Używanie interfejsu Local Emulator Suite do interaktywnego prototypowania lub interfejsu API REST Authentication emulatora do testowania nieinteraktywnego.

Szczegółowy przewodnik znajdziesz w artykule Łączenie aplikacji z emulatorem Authentication. Więcej informacji znajdziesz we Local Emulator Suite wprowadzeniu.

Teraz przejdźmy do uwierzytelniania użytkowników.

Sprawdzanie bieżącego stanu uwierzytelniania

1. Zadeklaruj instancję FirebaseAuth.

   Kotlin

   private lateinit var auth: FirebaseAuth
   EmailPasswordActivity.kt

   Java

   private FirebaseAuth mAuth;
   EmailPasswordActivity.java

2. W metodzie onCreate() zainicjuj instancję FirebaseAuth.

   Kotlin

   // Initialize Firebase Auth
   auth = Firebase.auth
   EmailPasswordActivity.kt

   Java

   // Initialize Firebase Auth
   mAuth = FirebaseAuth.getInstance();
   EmailPasswordActivity.java

3. Podczas inicjowania aktywności sprawdź, czy użytkownik jest obecnie zalogowany.

   Kotlin

   public override fun onStart() {
       super.onStart()
       // Check if user is signed in (non-null) and update UI accordingly.
       val currentUser = auth.currentUser
       if (currentUser != null) {
           reload()
       }
   }
   EmailPasswordActivity.kt

   Java

   @Override
   public void onStart() {
       super.onStart();
       // Check if user is signed in (non-null) and update UI accordingly.
       FirebaseUser currentUser = mAuth.getCurrentUser();
       if(currentUser != null){
           reload();
       }
   }
   EmailPasswordActivity.java

Rejestrowanie nowych użytkowników

Utwórz nową metodę createAccount, która przyjmuje adres e-mail i hasło, weryfikuje je, a następnie tworzy nowego użytkownika za pomocą metody createUserWithEmailAndPassword.

auth.createUserWithEmailAndPassword(email, password)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // Sign in success, update UI with the signed-in user's information
            Log.d(TAG, "createUserWithEmail:success")
            val user = auth.currentUser
            updateUI(user)
        } else {
            // If sign in fails, display a message to the user.
            Log.w(TAG, "createUserWithEmail:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
EmailPasswordActivity.kt

mAuth.createUserWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "createUserWithEmail:success");
                    FirebaseUser user = mAuth.getCurrentUser();
                    updateUI(user);
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "createUserWithEmail:failure", task.getException());
                    Toast.makeText(EmailPasswordActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
EmailPasswordActivity.java

Dodaj formularz do rejestrowania nowych użytkowników za pomocą adresu e-mail i hasła oraz wywołaj tę nową metodę po jego przesłaniu. Przykład znajdziesz w naszym przewodniku.

Logowanie istniejących użytkowników

Utwórz nową metodę signIn, która przyjmuje adres e-mail i hasło, weryfikuje je, a następnie loguje użytkownika za pomocą metody signInWithEmailAndPassword.

auth.signInWithEmailAndPassword(email, password)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // Sign in success, update UI with the signed-in user's information
            Log.d(TAG, "signInWithEmail:success")
            val user = auth.currentUser
            updateUI(user)
        } else {
            // If sign in fails, display a message to the user.
            Log.w(TAG, "signInWithEmail:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
EmailPasswordActivity.kt

mAuth.signInWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInWithEmail:success");
                    FirebaseUser user = mAuth.getCurrentUser();
                    updateUI(user);
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInWithEmail:failure", task.getException());
                    Toast.makeText(EmailPasswordActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
EmailPasswordActivity.java

Dodaj formularz do logowania użytkowników za pomocą adresu e-mail i hasła oraz wywołaj tę nową metodę po jego przesłaniu. Przykład znajdziesz w naszym przewodniku.

Uzyskiwanie dostępu do informacji o użytkownikach

Jeśli użytkownik zalogował się pomyślnie, możesz w dowolnym momencie uzyskać dostęp do jego danych na koncie za pomocą metody getCurrentUser.

val user = Firebase.auth.currentUser
user?.let {
    // Name, email address, and profile photo Url
    val name = it.displayName
    val email = it.email
    val photoUrl = it.photoUrl

    // Check if user's email is verified
    val emailVerified = it.isEmailVerified

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    val uid = it.uid
}
MainActivity.kt

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // Name, email address, and profile photo Url
    String name = user.getDisplayName();
    String email = user.getEmail();
    Uri photoUrl = user.getPhotoUrl();

    // Check if user's email is verified
    boolean emailVerified = user.isEmailVerified();

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    String uid = user.getUid();
}
MainActivity.java

Następne kroki

Zapoznaj się z przewodnikami dotyczącymi dodawania innych usług uwierzytelniania i tożsamości:

• Logowanie przez Google
• Logowanie przez Facebooka
• Uwierzytelnianie anonimowe