2. Guide d'utilisation

🛑 Avertissement Important : Ce document couvre pour l'instant uniquement la version Android. La version iOS (iPhone) est à venir dans une future mise à jour !

Avant de commencer, si vous souhaitez comprendre le projet et les technologies utilisées d'un point de vue matériel et logiciel, lisez d'abord le fichier 👉 Introduction et Technologies.

Ce fichier (README.md) va vous expliquer, étape par étape, comment lancer l'application et comment la "compiler" (créer un fichier .apk installable).

Structure du Projet (Où se trouve le code ?)

Pour vous y retrouver facilement :

• Le code de l'application mobile (l'interface) : Tout se passe principalement dans le dossier principal. Le fichier de départ est App.tsx. C'est ici que l'écran de l'application est dessiné.
• Le code de la Banquette (électronique) : C'est le fichier Banquette_ATmega.ino situé dans ce même dossier. C'est le programme à envoyer dans la carte Arduino de la banquette.
• Dossier android/ : Contient tous les fichiers nécessaires pour construire l'application finale. Normalement, on ne touche pas souvent au contenu de ce dossier.

Comment Lancer l'Application (Mode Développement)

Si vous voulez modifier l'application ou juste la tester sur votre ordinateur / téléphone :

Étape 1 : Préparer les fichiers (À faire une seule fois)

Ouvrez votre terminal (l'invite de commande) dans le dossier du projet, et installez les dépendances (les outils cachés dont le projet a besoin) :

npm install

Étape 2 : Connecter un appareil

Vous avez le choix entre deux méthodes :

• Un vrai téléphone Android : Branchez-le en USB. Assurez-vous d'avoir activé le "Mode Développeur" et le "Débogage USB" dans les paramètres de votre téléphone.

Étape 3 : Démarrer l'application

Toujours dans le terminal, tapez ceci pour lancer la version Android sur votre appareil. L'application va s'installer toute seule et s'ouvrir sur le téléphone :

npm run android

(Laissez la fenêtre du terminal ouverte : elle contient le "Metro", une sorte de tour de contrôle qui met à jour l'application en direct si vous modifiez le fichier App.tsx).

📦 Comment Générer l'Application Finale (Créer le fichier .apk)

Cette étape s'appelle le "Build". C'est le moment de créer le fichier .apk que vous pourrez envoyer à vos amis ou installer n'importe où sans avoir besoin d'être branché à l'ordinateur.

Étape 1 : Se placer dans le dossier Android

Dans votre terminal (qui est dans le dossier AppBanquette), rentrez dans le dossier système d'Android :

cd android

Étape 2 : Créer l'APK (Release)

Lancez la commande magique qui va fabriquer l'application :

• Sous Windows :

  gradlew assembleRelease
  

• Sous Linux / Mac :

  ./gradlew assembleRelease
  

(Cette étape peut prendre quelques minutes, c'est normal. Le build est assez lourd).

Étape 3 : Récupérer votre application

Une fois que c'est terminé et réussi (le terminal affiche BUILD SUCCESSFUL), votre fichier .apk est prêt ! Vous le trouverez rangé bien au chaud ici : 📁 AppBanquette/android/app/build/outputs/apk/release/app-release.apk

C'est ce fichier app-release.apk qu'il faut copier sur votre téléphone Android pour l'installer définitivement !

🛠️ En cas de problème de build (Solution miracle)

Parfois, l'ordinateur s'emmêle les pinceaux avec des vieux fichiers. Si votre Build échoue bizarrement, essayez de tout "nettoyer" :

1. Placez-vous dans le dossier android : cd android
2. Lancez le nettoyage :
   • Windows : gradlew clean
   • Linux : ./gradlew clean
3. Refaites ensuite la commande assembleRelease de l'étape précédente.