Connecter votre application à Firebase
Si ce n'est pas déjà fait, Ajoutez Firebase à votre projet Android.
Ajouter Firebase Authentication à votre application
Dans le fichier Gradle de votre module (au niveau de l'application) (généralement
<project>/<app-module>/build.gradle.ktsou<project>/<app-module>/build.gradle), Ajoutez la dépendance pour la bibliothèque Firebase Authentication pour Android. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions des bibliothèques.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.4.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") }En utilisant Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.
(Alternative) Ajouter des dépendances de la bibliothèque Firebase sans utiliser l'BoM
Si vous choisissez de ne pas utiliser Firebase BoM, vous devez spécifier chaque version de la bibliothèque Firebase dans sa ligne de dépendance.
Notez que si vous utilisez plusieurs bibliothèques Firebase dans votre application, nous vous recommandons vivement d'utiliser BoM pour gérer les versions de la bibliothèque, ce qui garantit que toutes les versions sont compatibles.
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:23.0.0") }Pour utiliser un fournisseur d'authentification, vous devez l'activer dans le Console Firebase. Accédez à la page "Méthode de connexion" dans la section Firebase Authentication pour activer la connexion par e-mail/mot de passe et tous les autres fournisseurs d'identité que vous souhaitez pour votre application.
(Facultatif) Prototyper et tester avec Firebase Local Emulator Suite
Avant d'aborder la façon dont votre application authentifie les utilisateurs, examinons un ensemble Vous pouvez utiliser les outils suivants pour prototyper et tester les fonctionnalités de Authentication: Firebase Local Emulator Suite Si vous hésitez entre les techniques d’authentification et fournisseurs, testant différents modèles de données avec des données publiques et privées à l'aide de Authentication et Firebase Security Rules, ou au prototypage de conceptions d'interface utilisateur de connexion, de pouvoir travailler localement sans déployer de services actifs peut être une excellente idée.
Un émulateur Authentication fait partie de Local Emulator Suite, ce qui permet à votre application d'interagir avec le contenu et la configuration de la base de données émulée, ainsi que, éventuellement, avec les ressources de votre projet émulées (fonctions, autres bases de données et règles de sécurité).
L'utilisation de l'émulateur Authentication ne nécessite que quelques étapes:
- Ajoutez une ligne de code à la configuration de test de votre application pour vous connecter à l'émulateur.
- À partir de la racine du répertoire local de votre projet, exécutez
firebase emulators:start. - Utiliser l'interface utilisateur Local Emulator Suite pour le prototypage interactif, ou la API REST de l'émulateur Authentication pour les tests non interactifs.
Pour en savoir plus, consultez le guide détaillé Connecter votre application à l'émulateur Authentication. Pour en savoir plus, consultez l'introduction de Local Emulator Suite.
Passons maintenant à l'authentification des utilisateurs.
Vérifier l'état d'authentification actuel
Déclarez une instance de
FirebaseAuth.Kotlin+KTX
private lateinit var auth: FirebaseAuth
Java
private FirebaseAuth mAuth;
Dans la méthode
onCreate(), initialisez l'instanceFirebaseAuth.Kotlin+KTX
// Initialize Firebase Auth auth = Firebase.auth
Java
// Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
Lors de l'initialisation de votre activité, vérifiez si l'utilisateur est actuellement connecté po.
Kotlin+KTX
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() } }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(); } }
Inscrire de nouveaux utilisateurs
Créez une méthode createAccount qui reçoit une adresse e-mail et un mot de passe, les valide, puis crée un utilisateur avec la méthode createUserWithEmailAndPassword.
Kotlin+KTX
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)
}
}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);
}
}
});Ajoutez un formulaire pour enregistrer les nouveaux utilisateurs avec leur adresse e-mail et leur mot de passe, et appeler ce nouveau lors de son envoi. Vous trouverez un exemple dans notre guide de démarrage rapide.
Se connecter à un compte existant
Créez une méthode signIn qui reçoit une adresse e-mail et un mot de passe, les valide, puis connecte un utilisateur à l'aide de la méthode signInWithEmailAndPassword.
Kotlin+KTX
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)
}
}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);
}
}
});Ajoutez un formulaire pour permettre aux utilisateurs de se connecter avec leur adresse e-mail et leur mot de passe, puis appelez cette nouvelle méthode lorsqu'il est envoyé. Vous trouverez un exemple dans notre exemple de démarrage rapide.
Accéder aux informations utilisateur
Si un utilisateur s'est connecté, vous pouvez obtenir ses données de compte à tout moment à l'aide de la méthode getCurrentUser.
Kotlin+KTX
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
}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();
}Étapes suivantes
Consultez les guides sur l'ajout d'autres services d'identité et d'authentification :