https://github.com/eric-gilles/fluttertp3
https://github.com/eric-gilles/fluttertp3
dart flutter
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/eric-gilles/fluttertp3
- Owner: eric-gilles
- Created: 2025-01-06T06:58:49.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-01-08T00:11:13.000Z (5 months ago)
- Last Synced: 2025-01-16T09:58:49.222Z (5 months ago)
- Topics: dart, flutter
- Language: Dart
- Homepage:
- Size: 36 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TP3 Flutter - UE HAI912I
## TP3 - Flutter Firebase
Ce projet contient une application de quiz développé en Flutter avec `Firebase` pour l'authentification et le stockage des données.
Cet application a été réalisées dans le cadre du TP3 Flutter du cours HAI912I - Développement mobile avancé, IOT et embarqué à l'Université de Montpellier.
## Auteur
- **[Eric Gilles](https://github.com/eric-gilles)**
## Application
### Application de Quiz Firebase - [Quiz App Final](https://github.com/eric-gilles/FlutterTP3/tree/main/quiz_app_final)
Cette application est une évolution de l'application de quiz [quiz_app_v3](https://github.com/eric-gilles/FlutterTP2/tree/main/quiz_app_v3).
qui utilise Firebase pour l'authentification et le stockage des données.
L'application permet à l'utilisateur de s'authentifier avec son compte Google ou avec un email et un mot de passe, de jouer à un quiz et de créer ses propres quiz, une fois authentifié.
Elle possède les fonctionnalités suivantes :
- Authentification avec Google ou email/mot de passe via FirebaseAuth
- Création de quiz pour les utilisateurs authentifiés
- Stockage des quiz, des questions dans Firebase
- Affichage de la liste des quiz
- Affichage des questions
- Choix de la réponse (oui ou non)
- Affichage de la progression
- Calcul et affichage du score
- Possibilité de recommencer le quiz
- Lancement de son en fonction du résultat de la question
## Accès en ligne
Également disponible en ligne via le lien [Appetize](https://appetize.io/) suivant :
- [Quiz App Final - Appetize](https://appetize.io/app/b_gk2difjgjvrkddsrbg77i5lvii)
## Prérequis
- Flutter SDK: [Installation Guide](https://flutter.dev/docs/get-started/install)
- Dart SDK
- Cli FireBase: [Installation Guide](https://firebase.google.com/docs/cli?hl=fr&authuser=0#install_the_firebase_cli)
## Installation
1. Clonez le dépôt :
```bash
git clone https://github.com/eric-gilles/FlutterTP3
```
2. Accédez au répertoire de l'application :
```bash
cd FlutterTP3/quiz_app_final
```
3. Créer un nouveau projet Firebase sur la [console Firebase](https://console.firebase.google.com/project/) du nom de votre choix.
4. Activer l'authentification Google (il faudra sélectionnez votre adresse émail en tant que Adresse e-mail d'assistance) et l'authentification par email/mot de passe dans la console Firebase.
Pour ajouter Google en méthode d'authentification, il faudra aussi lancer la commande suivante :
```bash
keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore
```
Et copier la ligne de SHA-1 et le coller dans la console Firebase dans les paramètres de votre projet sous `Empreintes de certificat SHA`.
5. Activer la base de données Firestore dans la console Firebase et modfier les règles comme suivant :
```c
rules_version = '1';
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
allow read, write: if
request.time < timestamp.date(2025, 9, 30);
}
}
}
```
Ajouter des données dans la base de données Firestore ou utiliser l'application dans la section `` pour peupler la base de données, il faudra ajouter des collections et des documents.
1. Créer une collection `categories`.
2. Créer un premier document avec un id généré automatiquement et le champ `name` avec la valeur `Astronomie` en String par exemple, pour définir le nom de votre quiz.
3. Ajouter une sous-collection `questions` à ce document avec des documents de questions qui ont la forme suivante :
- ID : auto-généré
- questionText : String (la question)
- isCorrect : bool (true si la réponse est correcte, false sinon)
- questionImage : String (le chemin de l'image de la question)
Remarque: Des images sont stockées dans le répertoire `assets/images/` du projet.
6. Activer la cli Firebase dans n'importe quel répertoire :
```bash
dart pub global activate flutterfire_cli
```
7. Ajouter au PATH :
```bash
export PATH="$PATH":"$HOME/.pub-cache/bin"
```
8. Connectez-vous à Firebase :
```bash
firebase login
```
9. Initialiser Firebase dans le projet (`nom_de_votre_projet_firebase` correspond au nom de votre projet sur la [console Firebase](https://console.firebase.google.com/project/)) :
```bash
flutterfire configure --project=nom_de_votre_projet_firebase
```
Choisir la plateforme Android en appuyant sur la touche `Entrée` quand vous êtes invité à choisir la plateforme.
Entrez le nom du package de l'application (ici: `com.example.quiz_app_final`) quand vous êtes invité à le faire.
Le fichier `google-services.json` sera automatiquement ajouté au projet sous `quiz_app_final/android/app/`.
Ainsi que le fichier `firebase_options.dart` sous `quiz_app_final/lib/`.
10. Installez les dépendances :
```bash
flutter pub get
```
## Exécution en ligne de commande
Pour exécuter l'application de carte de profil ou l'application de quiz, utilisez la commande suivante dans le répertoire du projet correspondant :
```bash
flutter run -t lib/main.dart
```
## Exécution avec Android Studio
1. Ouvrez le projet de l'application `quiz_app_final` avec Android Studio.
2. Sélectionnez un émulateur ou un appareil physique pour exécuter l'application.
3. Exécutez l'application en cliquant sur le bouton "Run" ou en utilisant le raccourci clavier `Shift + F10`.