Créer des projets dans Netbeans et Eclipse pour travailler sur le code source de BDF

Le code source du logiciel BDF est disponible sur le dépôt Framagit à l’adresse suivante : framagit.org/fichotheque/bdf/

Vous pouvez cloner le dépôt avec la commande suivante :

git clone https://framagit.org/fichotheque/bdf.git

Pour notre démonstration, nous imaginerons que vous l’avez cloné dans /home/my/dev/bdf/. Il ne reste plus qu’à ouvrir le code dans votre IDE préféré (Un IDE Integrated Development Environment est un logiciel spécialisé pour faciliter la programmation de projets). Le problème, c’est que pour des raisons historiques, le code source du logiciel ne suit pas des conventions récentes (type Maven ou autre) : le code source est ventilé dans 28 répertoires différents.

Pour ne pas avoir à intégrer ces 28 répertoires « à la main », le dépôt propose deux modèles qu’il suffit de configurer pour faire un import dans Netbeans ou Eclipse.

Procédure d’importation dans Netbeans

Dans le dépôt, le modèle d’import se trouve dans ide/netbeans/BDF/. Les étapes à réaliser sont les suivantes :

• Ouvrir ide/netbeans/BDF/project.properties et remplacer toutes les occurrences de /home/user/bdf/ par le chemin local de votre dépôt (/home/my/dev/bdf/ dans notre exemple),

• Compresser dans un fichier zip le répertoire ide/netbeans/BDF/,

• Dans Netbeans, lancer la commande File -> Import Project -> From ZIP... et sélectionner le fichier zip créé à l’étape précédente.

Un projet appelé BDF est créé dans Netbeans avec les répertoires contenant toutes les sources.

Pour information, le logiciel BDF est actuellement codé avec l’aide de Netbeans avec un projet pour chaque répertoire de sources du dépôt. C’est évidemment beaucoup plus long à configurer mais cela permet de respecter les dépendances entre chaque répertoire (quand toutes les sources sont dans un même projet, la question des dépendances ne se pose pas).

Procédure d’importation dans Eclipse

Dans le dépôt, le modèle d’import se trouve dans ide/eclipse/BDF/. Les étapes à réaliser sont les suivantes :

• Ouvrir ide/eclipse/BDF/project.xml, remplacer l’occurrence de /home/user/bdf/ (qui se trouve vers la fin de votre fichier) par le chemin local de votre dépôt (/home/my/dev/bdf/ dans notre exemple) et renommer le fichier ide/eclipse/BDF/.project

• Procéder de même avec ide/eclipse/BDF/classpath.xml : remplacer toutes les occurrences de /home/user/bdf/ et renommer le fichier ide/eclipse/BDF/.classpath

• Dans Eclipse, lancer la commande File -> Import... et choisir la proposition General -> Existing Projects into Workspace. À l’étape suivante, pointer sur votre dépôt local (/home/my/dev/bdf/) dans le premier champ « Select Root directory » et cocher l’option « Copy projects into workspace ».

Après, un projet BDF est créé dans Eclipse avec les répertoires contenant toutes les sources.