Начало работы с аутентификацией Firebase на Android

Подключите свое приложение к Firebase

Если вы еще этого не сделали, добавьте Firebase в свой Android-проект .

Добавьте Firebase Authentication в свое приложение

  1. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимость для библиотеки Firebase Authentication для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки. 

    dependencies {     // Import the BoM for the Firebase platform     implementation(platform("com.google.firebase:firebase-bom:34.1.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") }

    Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

    (Альтернатива) Добавьте зависимости библиотеки Firebase без использования BoM

    Если вы решите не использовать Firebase BoM , вам необходимо указать каждую версию библиотеки Firebase в строке ее зависимостей.

    Обратите внимание: если вы используете в своем приложении несколько библиотек Firebase, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.

    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. Чтобы использовать поставщика аутентификации, необходимо включить его в консоли Firebase . Перейдите на страницу «Способ входа» в разделе Firebase Authentication чтобы включить вход по электронной почте/паролю и любые другие поставщики идентификации, необходимые для вашего приложения.

(Необязательно) Создание прототипа и тестирование с помощью Firebase Local Emulator Suite

Прежде чем говорить о том, как ваше приложение аутентифицирует пользователей, давайте рассмотрим набор инструментов, которые можно использовать для создания прототипа и тестирования функциональности Authentication : Firebase Local Emulator Suite . Если вы выбираете между методами и поставщиками аутентификации, пробуете различные модели данных с публичными и приватными данными, используя правила Authentication и Firebase Security Rules , или разрабатываете прототипы интерфейсов входа, возможность работать локально, не развертывая готовые сервисы, может быть отличным решением.

Эмулятор Authentication является частью Local Emulator Suite , который позволяет вашему приложению взаимодействовать с эмулируемым содержимым базы данных и конфигурацией, а также, при необходимости, с эмулируемыми ресурсами проекта (функциями, другими базами данных и правилами безопасности).

Использование эмулятора Authentication включает всего несколько шагов:

  1. Добавление строки кода в тестовую конфигурацию вашего приложения для подключения к эмулятору.
  2. Из корня локального каталога проекта запустите firebase emulators:start .
  3. Использование пользовательского интерфейса Local Emulator Suite для интерактивного прототипирования или REST API эмулятора Authentication для неинтерактивного тестирования.

Подробное руководство доступно на странице «Подключение приложения к эмулятору Authentication . Подробнее см. во введении к Local Emulator Suite .

Теперь давайте продолжим рассматривать аутентификацию пользователей.

Проверить текущее состояние авторизации

  1. Объявите экземпляр FirebaseAuth .

    Kotlin 

    private lateinit var auth: FirebaseAuth
    EmailPasswordActivity.kt

    Java 

    private FirebaseAuth mAuth;
    EmailPasswordActivity.java

  2. В методе onCreate() инициализируйте экземпляр FirebaseAuth .

    Kotlin 

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

    Java 

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

  3. При инициализации Activity проверьте, вошел ли пользователь в систему.

    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

Регистрация новых пользователей

Создайте новый метод createAccount , который принимает адрес электронной почты и пароль, проверяет их, а затем создает нового пользователя с помощью метода createUserWithEmailAndPassword .

Kotlin 

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

Java 

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

Добавьте форму для регистрации новых пользователей с указанием адреса электронной почты и пароля и вызовите этот новый метод при отправке формы. Пример можно посмотреть в нашем кратком руководстве .

Войти существующих пользователей

Создайте новый метод signIn , который принимает адрес электронной почты и пароль, проверяет их, а затем регистрирует пользователя с помощью метода signInWithEmailAndPassword .

Kotlin 

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

Java 

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

Добавьте форму для входа пользователей с указанием адреса электронной почты и пароля и вызовите этот новый метод при отправке формы. Пример можно найти в нашем кратком руководстве .

Доступ к информации о пользователе

Если пользователь успешно вошел в систему, вы можете получить данные его учетной записи в любой момент с помощью метода getCurrentUser .

Kotlin 

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

Java 

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

Следующие шаги

Ознакомьтесь с руководствами по добавлению других служб идентификации и аутентификации: