Skip to content

Installation

Jump to bottom
kmzx edited this page May 22, 2025 · 1 revision

title: Installation & lancement

:tools: Installation & lancement

Cette page vous guide pour installer et lancer l’application TransNav sur votre ordinateur.

Pas besoin d’IDE ou d’installation complexe : tout est prêt à l’usage grâce aux scripts fournis avec le projet.

✅ Prérequis

Configuration minimale

  • Un ordinateur sous Windows, Linux ou macOS
  • Une connexion Internet (uniquement pour le premier lancement si des composants doivent être installés)

ℹ️ Les scripts fournis se chargent automatiquement de vérifier la présence de Java 21, de JavaFX et de préparer le lancement du programme.

📦 Étape 1 — Télécharger l'exécutable

Rendez vous sur la page de Releases du projet et télécharger l'exécutable "TransNav-<numero_de_version>"

release.png{width="474" height="490"}

🧰 Étape 2 — Lancer le script adapté à votre système

Une fois dans le dossier du projet, vous trouverez deux scripts à la racine :

Système Fichier à lancer
Windows script.bat
Linux/macOS script.sh

Ces scripts vont :

  1. Vérifier que Java 21 et JavaFX sont installés (et les installer si besoin),
  2. Lancer l'application automatiquement à partir du fichier .jar déjà fourni dans le dépôt.

▶️ Sous Windows

Ouvrez l’explorateur de fichiers, allez dans le dossier du projet, puis double-cliquez sur script.bat.

Ou bien, exécutez-le manuellement depuis un terminal :

REM Le numéro de version peut changer
cd TransNav-3.0.0
script.bat

▶️ Sous Linux / macOS

Dans un terminal :

cd TransNav-3.0.0 # Le numéro de version pour changer
chmod +x script.sh   # (à faire une seule fois)
./script.sh

💡 Le script se charge de tout : aucune configuration manuelle n’est nécessaire.

🧪 Étape alternative — Compilation manuelle (optionnel)

Si vous préférez ne pas utiliser les scripts fournis, vous pouvez compiler et lancer manuellement l’application avec Maven.

  1. Assurez-vous d’avoir Java 21, JavaFX et Maven 3.8.5 installés.
  2. Clonez le projet depuis l'accueil, bouton "Code".
  3. Ouvrez un terminal dans le dossier racine du projet.
  4. Compilez le projet et exécutez les tests avec :
mvn verify

✅ Cette commande compile le projet, exécute les tests, et génère un fichier .jar exécutable dans le dossier target/.

▶️ Option A — Lancer le JAR compilé

Après compilation, vous trouverez un fichier comme celui-ci :

target/transnav-1.0.0-jar-with-dependencies.jar

Exécutez-le avec :

java -jar target/transnav-1.0.0-jar-with-dependencies.jar

📁 Le nom exact peut varier selon la version. Vérifiez dans le dossier target/.

▶️ Option B — Lancer directement avec Maven

Vous pouvez également démarrer l’application sans utiliser le fichier .jar :

mvn javafx:run

:desktop: Cela ouvre directement l’interface graphique de TransNav.

✅ Une fois l’application lancée, découvrez ses fonctionnalités dans la section suivante :
➡️ Fonctionnalités de l'application

Clone this wiki locally