Utiliser Eclipse comme IDE

[Dr.Vince]

Utiliser Eclipse comme IDE

Auteur : Dr.Vince

Introduction

Je vais vous expliquer à travers ce tutorial comment installer et configurer Eclipse pour développer sur NDS.
Je vais également vous présenter quelques fonctionnalités d'Eclipse pour ceux qui ne connaissent pas ce fabuleux IDE.

Présentons un peu Eclipse.
Eclipse est à l'origine un IDE pour développer en JAVA. Celui-ci est entièrement gratuit et open-source.
Son fonctionnement est assez simple et le nombre de plugins disponibles pour celui-ci est assez impressionnant.
Il vous permettra en plus de développer en JAVA, de faire du PHP, du HTML, du COBOL, de l'UML et bien sûr du C/C++.
Il est également possible d'intégrer un plugin CVS qui fonctionne à merveille.

Note: ce tuto s'adresse à ceux qui utilisent le template PAlib ou libnds et donc le makefile qui y est inclus.
Il existe un plugin, que je n'ai pas testé, permettant de gérer le makefile automatiquement depuis Eclipse. Vous le trouverez sur http://www.gbadev.org

1 Télécharger les différents logiciels


1.1 Pré-requis

Vous devez avoir installez devkitpro sur votre machine c'est à dire : devkitARM, msys et libnds.


1.2 Se procurer les différents logiciels

• La dernière JRE (Java Runtime Environment): pour pouvoir utiliser Eclipse
  
  -> http://java.sun.com/javase/downloads/index.jsp
  
  
• La dernière version d'ECLIPSE : pour pouvoir développer avec !!
  
  -> http://www.eclipse.org/downloads/index.php
  
  Note : prendre uniquement la Platform Runtime Binary, car celle-ci est bien plus légère.
  Pour être sûr, votre fichier doit s'appeler : eclipse-platform-x.x-win32.zip
  
  
• La dernière version de CDT (C/C++ Development Tools) : un module d’eclipse pour pouvoir faire du C/C++.
  
  -> http://www.eclipse.org/cdt/downloads.php
  
  Note: prendre uniquement la version Runtime (CDT Runtime Feature).
  Pour être sûr, votre fichier doit s'appeler : org.eclipse.cdt-x.x.x-win32.x86.zip

2 Installation


2.1 Installation de la JRE

• Double-cliquez sur l’exécutable téléchargé et suivre la procédure d’installation.

2.2 Installation d’Eclipse

• Décompressez l’archive téléchargée, à l’endroit désirée.
  Note: Eclipse ne possède pas de procédure d’installation. Il s’exécute à l’endroit où vous l’avez mis.
  
• Lancez Eclipse
  
• Vous devriez avoir cette écran qui s'affiche :
  
  
  
  
• Indiquez le répertoire où vous allez stocker vos projets NDS.
  Cliquez sur la case à cocher si vous voulez qu'Eclipse ne vous pose pas la question à chaque fois.
  
• Fermez la fenêtre Welcome et laissez Eclipse ouvert.
  

2.3 Installation du CDT

• Décompressez l’archive téléchargée dans n’importe quel dossier.
  
• Allez dans Eclipse et faites menu Help --> Software Updates --> Find and Install...
  
  
  
  
• Sélectionnez Search for new features to install puis faites Next
  
  
  
  
• Ensuite cliquez sur New Local Site
  
• Sélectionnez le répertoire où vous avez décompressé le CDT (..\org.eclipse.cdt-x.x.x-win32.x86\eclipse), faite OK, puis encore OK.
  
• Un nouvel item est apparut dans la liste Sites to include in search.
  
  
  
  
• Cliquez sur Finish.
  
• Une nouvelle fenêtre est apparue.
• Sélectionnez le CDT et cliquez sur Next.
  
  
  
  
• Accepter les termes de la license puis cliquez sur Next puis Finish.
  
• Cliquez Yes pour redémarrer Eclipse.
  

[Dr.Vince]

3 Configuration

3.1 Créer un projet

• Faites menu File -> New -> Project...
  
  
  
  
• Sélectionnez Standard Make C Project puis faites Next
  
  
  
  
• Entrez le nom de votre projet (qui sera également le nom du répertoire dans lequel il sera stocké.
  Le projet est créé dans l'emplacement par défaut indiqué lors de la première ouverture d'Eclipse, mais si vous le souahitez vous pouvez modifier celui-ci.
• Cliquez sur Finish.
  
• Une fenêtre s'ouvre vous demandant si vous voulez associer ce type de projet à la perspective C/C++ d'Eclipse.
  
  
  
  
• Cochez la case Remember this decision.
• Cliquez sur Yes.
  
• Votre projet vient d'apparaître sur la droite et votre environnement de travail vient de changer.
  
• Copier le contenu de votre template ndslib ou PAlib dans celui-ci.
  

3.2 Configuration de la compilation d'Eclipse

• Sélectionnez votre projet, clic droit dessus, puis sélectionnez Properties
• Sélectionnez C/C++ Make Project dans le menu de droite :
  
  
  
  
• cochez Stop on first build error.
• L'option Build on resource save(Auto Build) permet de compiler le projet à chaque fois que vous sauvegardez un fichier.
  A vous de voir si vous voulez que cette option soit active.
  Note: Pour les habitués d'Eclipse, cette option correspond à l'option Build Automatically du menu projet qui ne fonctionne pas avec CDT.
• Vous pouvez sélectionnez une répertoire pour générer votre build.
• Pour les utilisateurs du template PAlib, remplacez les all par des build.
• cliquez sur Apply.

3.3 Configuration des Targets

• Sélectionnez la vue Make Targets.
• Cliquez sur Hide Empty Folders.
  
  
  
  
• Sélectionnez votre projet.
• Clic droit et sélectionnez Add Make Target.
  
  
  
  
• Nous allons créer la target pour compiler notre projet :
  
  
  
  
• Dans Target Name vous pouvez mettre ce que vous voulez.
• Dans Make Target mettez all si vous utilisez le template libnds. Pour le template PAlib mettez build.
• Nous allons créer la target pour nettoyer notre projet. Remplissez comme sur l'écran suivant :
  
  
  
  
• Dans Target Name vous pouvez mettre ce que vous voulez.
• Dans Make Target mettez clean.
• Vous pouvez également créer une target supplémentaire de rebuild en mettant clean all ou clean build suivant votre cas. Ce qui peut être pratique.
  

3.4 Configuration de l'indexer C/C++

• Sélectionnez votre projet, clic droit dessus, puis sélectionnez Properties
• Sélectionnez C/C++ Indexer dans le menu de droite :
  
  
  
  
• Il s'agit de l'option d'indexation du code qui permet d'utiliser la complétion (expliquée plus loin dans ce tuto).
  Sélectionnez le niveau d'indexation que vous désiré, sachant que ça peut être long pour un gros projet.
  Essayez avec Full C/C++ Indexer, vous pourrez toujours changer plus tard. (Note: voir conclusion)

3.5 Configuration des Include Paths C/C++

• Sélectionnez votre projet, clic droit dessus, puis sélectionnez Properties
• Sélectionnez C/C++ Include Paths & Symbols dans le menu de droite :
  
  
  
  
  Sur cet écran nous allons pouvoir indiquer le chemin des fichiers include de votre projet. Ceci permettra la complétion et une navigation rapide dans votre code.
• Sélection votre projet.
• Cliquez sur Add Folder/File pour inclure un répertoire de votre projet.
• Cliquez sur Add External include Path pour inclure un répertoire externe.
  C'est ce que nous allons faire avec libnds et PAlib suivant celui que vous utilisez.
• Si vous utilisez libnds alors sélectionnez le répertoire C:\devkitpro\devkitARM\arm-eabi\include.
• Si vous utilisez PAlib alors sélectionnez le répertoire C:\devkitPro\PAlib\include\nds.
  
• Cliquez sur OK.

3.6 Configuration d'un émulateur
Il est possible de tester directement voter projet depuis Eclipse en lançant un émulateur.
Voici la marche à suivre :

• Dans le menu Run, sélectionnez External Tools puis External Tools...
  
  
  
  
• Sélectionnez Program] puis cliquez sur le bouton New comme indiqué.
• Vous obtenez alors la fenêtre suivante :
  
  
  
  
• Dans Name mettez ce que vous voulez, le nom de votre projet par exemple.
• Dans Location mettez le chemin de votre émulateur.
• Pour Working Directory, cliquez sur Browse Workspace et sélectionnez l'emplacement où est généré votre .nds
• Dans Arguments mettez le nom de votre fichier .nds
• Cliquez sur Apply puis Close.
• Il est possible de créer une configuration générique pour tous vos projets.
  Il suffit pour cela d'utiliser la variable ${project_loc} dans Location, suivi d'un répertoire si par exemple vous généré tout le temps dans un répertoire build.
  Et dans Arguments mettez ${project_name}.nds à condition que voter makefile génère un .nds avec le nom de votre projet.

3.7 Derniers réglages

Vous pouvez voir que votre devant le nom de votre projet, se trouve une incône triangulaire avec un point d'exclamation.
Il s'agit d'un warning.
Pour le faire disparaître, voilà ce qu'il faut faire :

• Sélectionnez votre projet, puis clic droit et Properties.
• Sélectionnez C/C++ Make Project.
• Sélectionnez l'onglet Discovery Options.
  
  
  
  
• Décochez Enable generate scanner info command.

[Dr.Vince]

4 Utilisation d’Eclipse

4.1 Navigation dans le code

Eclipse offre plusieurs moyen de naviguer facilement à travers le code.
En voici quelques exemples :

4.1.1 Explorateur C/C++

Il est possible de naviguer rapidement via l'explorateur de fichier C/C++ situé par défaut à gauche.
Dépliez complètement un fichier C :




Vous pouvez alors accéder directement à la fonction qui vous intéresses par exemple.

Pour vous y retrouvez plus facilement dans l'explorateur vous pouvez cliquez sur cette icône
Alors le fichier source actif dans l'éditeur sera sélectionné dans l'explorateur.

4.1.2 Vue Outline

La vue Outline liste le contenu du fichier actif dans l'éditeur :




4.1.3 Accès direct

Positionnez vous sur le nom d'une fonction qui est définit dans un autre fichier source par exemple.
Si vous faites F3 (ou Crtl + Clic gauche), alors Eclipse affiche la définition de votre fonction.
Si vous faites Crtl + F3, alors Eclipse affiche le code de votre fonction.


4.2 Complétion

Si vous avez effectuez correctement la configuration décrite en 3.4 et 3.5 alors Eclipse vous permettra d'utiliser la complétion.
Tapez les premières lettres du nom d'une fonction par exemple, puis faites Ctrl + Espace.
Eclipse vous propose alors les mots correspondants, vous n'avez plus qu'à choisir le nom de la fonction.




4.3 Refactoring

Le refactoring permet de changer le nom d'une fonction et de propager ce changement dans tout votre code.
Mettez vous sur le nom d'une fonction par exemple, puis faites clic droit, puis Refactor, puis Rename...




Vous pouvez alors indiquer le nouveau nom de la méthode, sur quoi vous appliquez le refactor et obtenir une preview des changements qu'Eclipse va effectué.





4.4 Compilation

Si vous avez suivi l'étape 3.3 il vous suffit de double-cliquez sur les targets adéquates.




Sinon passez par le menu Project.

Le raccourcis Ctrl + B permet de compiler.


4.5 Exécution de la ROM

Si vous avez suivi l'étape 3.6 il vous suffit de cliquez dans la barre d'outils en haut :



Une fenêtre s'ouvre.
Sélectionnez votre programme et cliquez sur Run.

Par la suite votre programme apparaîtra directement en cliquant sur l'icône.


Conclusion

Le tool CDT pour Eclipse étant assez récent, il n'est pas tout à fait encore au point.
Certaines fonctionnalités qui marchait bien peuvent fonctionner moins bien lors d'une mise à jour de celui-ci et inversement.
Mais globalement ce tool est à présent assez stable et fonctionnel pour être utilisé.


Note du paragraphe 3.4 : La version utilisée pour ce tuto est la 3.1. L'indexation déconne un peu.
Je n'ai réussi à obtenir des résultats probant qu'avec une indexation Full.
De plus l'inclusion dans le path de PAlib et de libnds ne fonctionne pas et fait buggé Eclipse.
A priori ça pose pas de problème étant donné qu'un utilisateur de PAlib n'utilise pas directement la libnds.

Merci de me signaler toute erreur présent dans ce tuto pour que je puisse les corriger.
Toute remarque/suggestion est également la bienvenu.

Merci également d'avoir lu ce tuto jusqu'au bout.
Bon code !!

[cocole]

Superbe tuto !

Et pour ceux qui se demandent ce que c'est un IDE :
IDE : en français EDI : environnement de développement intégré.
Hiddeux, non ?

[Bobby Sixkilla]

T'es en forme olympique!!! Merci.

PS : Evite les triple post à l'avenir...

[Dr.Vince]

Envoyé par Bobby Sixkilla

PS : Evite les triple post à l'avenir...

c'est à cause de la limitation des 20 images par post....

[Charly]

Comment tu assures Vince !!!!!!!!!!

Super tuto et surtout super utile!!!!!!
Merci beauuuucoup

[Narf!]

merci bcp pour ce superbe tuto.
sans dec' c'est du tres beau boulot.
j'ai tout compris du premier coup c'est peut dire.

[Bodom-Child]

Excellent tuto Dr Vince, tu cartonnes!!!

[Dr.Vince]

merci à tous ça fait plaisir

car je vais pas mentir mais ça m'a pris quelques heures pour faire ce tuto tout de même, et ma seule hantise était qu'il ne serve pas

[Pitt]

Envoyé par Dr.Vince

merci à tous ça fait plaisir

car je vais pas mentir mais ça m'a pris quelques heures pour faire ce tuto tout de même, et ma seule hantise était qu'il ne serve pas

Bah alors là, ta hantise est complètement bannie
Tes

Envoyé par Dr.Vince

quelques heures

n'ont pas été perdue...

Super tuto, merci !

[Poppu]

Superbe tutorial, merci à toi!!!!

[Tembargo]

Super tuto mon ami

Voilou j'ai mis mon ptit Temby! Towers et PA Card Games dans eclipse en 5min. Sankyu
Suis bientot de retour pour le dev.. Ne désespère pas

[mastertop101]

Wahh !! merci!! à chaque fois que j'avais besoin d'une fonction, j'allais voir la Documentation..
(ça rime ^_^)

[KerneL]

Très bon tout ça Vince! Moi qui avait configuré Eclipse à moitié pour le C/C++ voilà de quoi compléter le tout. Je vais pouvoir être efficace sur PCG maintenant, hourra .

[OXyGN]

Un grand merci pour ce tuto. Du début à la fin. Une référence pour la communauté.

Plus qu'à développer maintenant

ps: j'ai juste un peu lutté avec les makefile, mais c'est réglé

[mastertop101]

Salut,
en appuyant sur CTRL + B (ou en cliquant sur Project>Build All)
ça compile pas.. j'utilise palib (ça doit venir de là..) le target make fonctionne mais je préferrerait appuyer sur Ctrl B

Merci

[Dr.Vince]

regarde si tu as configuré correctement Eclipse, comme expliqué en "3.2 Configuration de la compilation d'Eclipse"

[mastertop101]

Ça a l'air correct de ce côté là...

[Toomagic]

Un tuto comme celui-ci c'est précieux. Allez hop dans les favoris.
Merci beaucoup .

[Dr.Vince]

tu pourrais me mettre une capture de ta config du 3.2, ainsi qu'une capture de la config de ta target qui fonctionne ???

[mastertop101]

en fait, jai décidé d'activer le build automatique (après sauvegarde), j'y voyais des inconvenients au debut mais je me rend compte que cest tres bien

[Mitternacht]

Bon...

**** Build of configuration Debug for project hellohoo ****

make all 
Building file: ../PAlibTemplate/source/main.c
Invoking: Cygwin C Compiler
gcc -I"C:\devkitPro\libnds\include\nds" -I"C:\devkitPro\devkitARM\arm-eabi\include" -O0 -g3 -Wall -c -fmessage-length=0 -MMD -MP -MF"PAlibTemplate/source/main.d" -MT"PAlibTemplate/source/main.d" -o"PAlibTemplate/source/main.o" "../PAlibTemplate/source/main.c"
/bin/sh.exe: gcc: command not found
make: *** [PAlibTemplate/source/main.o] Error 127

La compilation c'est pas pour moi faut croire

[Dr.Vince]

hum....... comment se fait-il que tu utilises Cygwin et pas msys ??

car c'est msys normalement dans le package devkitpro

[Mitternacht]

Bonjour et merci de ton aide,

**** Build of configuration Debug for project hellohoo ****

make build 
make: *** No rule to make target `build'.  Stop.

Un progrès ou pas ? '

Edit : J'utilise la template de PALib