1. Prérequis et setup de l’environnement

Bienvenue dans la documentation du projet AppBanquette !

Ce document a été spécialement rédigé pour être compréhensible par tous : que vous soyez le créateur du projet, un professeur évaluant le travail (même sans profil technique en Java ou en mobile), ou le futur étudiant qui reprendra ce projet l'année prochaine.

Qu'est-ce que ce projet ?

AppBanquette est une application mobile liée à un système matériel (une "banquette" équipée d'électronique). Elle permet de contrôler ou de lire des informations depuis la banquette directement sur un smartphone (actuellement Android) en utilisant une connexion sans fil via le protocole Bluetooth.

Le projet est divisé en deux grandes parties :

L'application mobile (Smartphone)
Le système embarqué (La carte électronique dans la banquette)

Les technologies utilisées (Expliquées simplement)

1. Côté Application Mobile 📱

React Native (v0.85) : C'est le cœur de l’application. Normalement, pour faire une application Android, on fait du Java/Kotlin, et pour un iPhone, du Swift. React Native est un outil génial conçu par Meta (Facebook) qui permet d'utiliser un seul code (en JavaScript/TypeScript) pour créer à la fois la version Android ET la version iOS (iPhone).
TypeScript : C'est le langage utilisé pour coder l'application. C'est du code simple (comme on en trouve sur le Web) mais "sécurisé" par un système qui empêche de faire des erreurs de frappe ou des bugs bêtes.
Bluetooth Classic (react-native-bluetooth-classic) : C'est le pont entre le téléphone et la banquette. Il permet d'envoyer et recevoir les données Bluetooth.
AsyncStorage : Utilisé pour sauvegarder des données directement dans la mémoire du téléphone (comme les réglages de l'utilisateur), pour qu'elles restent enregistrées même quand on ferme l'appli.
Node.js : C'est le moteur indispensable sur l'ordinateur de développement. Il sert à installer les paquets (librairies) et à faire tourner le serveur qui relie l'ordinateur au téléphone pendant le codage.

2. Côté Matériel (Banquette) 🔌

Microcontrôleur ATmega : C'est le "cerveau" électronique de la banquette. Le code se trouve dans le fichier Banquette_ATmega.ino. C'est du C++ très simplifié, spécifique à l'univers de l'électronique open-source Arduino.

💻 Comment installer l'environnement de développement ?

Pour continuer ce projet (ajouter des boutons, changer les couleurs, compiler), il faut préparer son ordinateur.

Important : L'application nécessite Node.js version 22.11 ou supérieure.

Sous Windows

Installer Node.js :
- Allez sur le site nodejs.org et téléchargez l'installateur Windows. Installez-le en cliquant sur "Suivant" à chaque étape.
Installer Java (JDK 17) : (Indispensable pour compiler vers Android)
- Installez Adoptium Temurin 17 (OpenJDK).
- Lors de l'installation, assurez-vous de cocher l'option "Set JAVA_HOME environment variable" (Définir la variable d'environnement).
Installer Visual Studio Code (VS Code) :
- C'est notre outil principal pour écrire et gérer le code de toute l'application. Téléchargez-le sur code.visualstudio.com et installez-le.
- Note : Nous n'utilisons pas d'émulateurs lourds type Android Studio. On navigue dans le code via VS Code, on compile et on teste l'application directement sur un vrai téléphone avec les commandes comme npx react-native run-android. (Il faut simplement avoir les outils en ligne de commande du SDK Android installés).
Installer l'IDE Arduino (Pour le code matériel) :
- Téléchargez l'application Arduino IDE et installez-la normalement. Vous pourrez ouvrir le fichier Banquette_ATmega.ino avec.

🐧 Sous Linux (Ex: Ubuntu / Debian)

Ouvrez un terminal et tapez ces commandes :

Installer Node.js :

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Installer Java (JDK 17) :

sudo apt update
sudo apt install openjdk-17-jdk -y

Installer Visual Studio Code (VS Code) :
- Installez-le simplement via la commande Snap : sudo snap install code --classic
- Note : Tout comme sur Windows, nous codons uniquement sur VS Code et testons directement sur nos téléphones sans utiliser d'émulateur. Vous n'aurez besoin que du SDK Android de base (en ligne de commande) pour que la compilation npx react-native run-android fonctionne.

Installer Arduino IDE :

sudo snap install arduino
# (Ou téléchargez l'AppImage sur le site officiel)

👉 Prochaine étape : Allez voir le fichier Guide d'utilisation pour savoir comment lancer l'application et la compiler (fabriquer l'APK) !