Installer et utiliser MS Visual C plus plus 6.0 pour développer sur Game Boy Advance

Extrait du Newbies's Guide to GBA dev par -VerticalE- et traduit par -NiCoO-

[modifier] Installer et utiliser MS Visual C++ 6.0

Ok, maintenant que vous avez installé VC++ 6.0, démarrez le.Nous allons procéder à une compilation de test, cliquez donc sur "File" puis "New" (ou appuyez sur Ctrl+N). Ouvrez l'onglet "Projects" (s'il n'est pas déjà ouvert), et selectionnez "MakeFile". Sous "Project name:", écrivez "CPPTest". Dans "Location:", j'ai écris "C:\GBADEV\" comme repertoire par défaut, mais vous pouvez en utiliser un autre si vous le sentez différemment ;).Pour ma part j'aime avoir des repertoires propres et facilement retrouvables.

Souvenez vous que le projet s'appelant "CPPTest" créera un nouveau repertoire appelé "CPPTest" dans le dossier GBADEV.En d'autres termes, le fichier test que nous allons compiler, et tous les fichiers du projet se placeront dans le repertoire "C:\GBADEV\CPPTest\".Assurez vous que "Win32" est selectionné dans "Platforms:", et que "Create new workspace" est selectionné.Maintenant clickez sur "OK". Regardez le "Output:". Puisque les images ROM que nous allons faire ne sont pas des .exe mais des .bin, nous allons devoir les renommer.Assurez vous qu'il y ait écrit "CPPTest.bin", et cliquez sur "Next". Refaite la même manipulation et cliquez sur "Finish".

[modifier] La configuration

"New Project Information" va apparaître. La seule chose qu'il vous reste à faire et de fermer en cliquant sur "OK".Vous êtes maintenant paré à modifier un peu Visual C++ afin qu'il utilise le Kit de developpement GBA que vous avez au préalablement downloadé (si ce n'est pas encore fait passez faire un tour dans notre section outils ;) ).Dans le menu déroulant "Tools", selectionnez "Options". Ouvrez l'onglet "Directories".En dessous de "Show directories for:", il devrait y avoir écrit "Include files". Selectionnez "Executable files" à la place.Une nouvelle liste de dossiers va apparaître. Tout en bas, indiquez les repertoires du Kit de dev GBA.Pour ma part je l'ais installé sous C:\GBA, c'est donc ce repertoire que j'ai écrit comme étant mon repertoire.Pour le rep "\bin", le chemin correct sera "C:\GBA\bin".Souvenez-vous de ne pas ajouter un \ à la fin du chemin (comme "C:\GBA\bin\"), car ça ne fonctionnera pas. Clickez "ok".

Maintenant, nous allons utilisez les fichiers du projet CPPTest se trouvant dans le zip. Allez dans le repertoire ou vous les avaient dézippé, et localisez le rep "Files", puis "CPPTest". Le dossier doit contenir les fichiers suivant:

boot.s
 CPPTest.mak
 ctrbegin.o
 crtend.o
 Linkscript
 main.cpp

Copiez/collez tous ces fichiers dans le dossier CPPTest (mon chemin est C:\GBADEV\CPPTest).Maintenant il est temps de faire un petit récapitulatif des fichiers de notre projet.Dans Visual C++, regardez à gauche de la fenêtre centrale. Il y a en bas deux "onglets" nommé "ClassView" et "FileView".Clickez sur l'onglet "FileView". Remarquez le changement de fenêtre. Maintenant clikez sur le [+] à côté du icône du repertoire "CPPTest files", et vous verrez apparaïtre trois repertoires.C'est l'endroit ou vous allez placer vos fichiers afin d'y accéder plus aisément et les modifier.Pour ajouter le fichier, click gauche (pour les droitier ;) ) sur l'icône du repertoire "CPPTest files", et choisissez "Add Files to Project" dans le menu qui apparaît.Il devrait par défaut vous proposer d'inclure des fichiers C++ , donc le seul fichier que vous devriez voir est "main.cpp". Changez "Files of type" en "All files".Vous pouvez maintenant voir tous les fichiers dans le repertoire workspace (noté le nom "workspace directory").Maintenant laissé enfoncé la touche Ctrl, clickez sur "boot.s", "Linkscript", "CPPTest.mak" et "main.cpp".Les fichiers devraient maintenant être selectionné, appuyez sur OK. Les fichiers devraient maintenant apparaître dans la fenêtre de gauche (fenêtre workspace), dans les repertoires.Si vous regardez de plus près, vous noterez que "main.cpp" a disparu.En fait ça n'est pas le cas. Visual C++ a reconnu le fichier comme étant un fichier source et l'a déplacé dans le dossier approprié.Clickez sur le [+] en face du dossier "Sources Files" pour vous assurez qu'il est au bon endroit.Maintenant, avant d'aller plus loin, laissez-moi vous parler un peu de la fenêtre workspace, et de la nécessité d'inclure les fichiers ici.

La fenêtre "workspace" est très pratique, et c'est une des raisons pour lesquelles les développeurs l'utilisent ainsi que l' IDE plutôt que de tout écrire avec "Notepad" ou "Dos-Edit" (por cette raison, mais aussi car les IDE gèrent les messages d'erreurs - on en parlera plus tard).Pour inclure un fichier dans cette fenêtre, click droit et selectionnez "Add Files to Project", puis selectionnez vos fichiers.Les fichiers seront alors placés dans les bon repertoires afin d'être retrouvés plus facilement plus tard.Les fichiers que Visual C++ ne reconnait pas seront placé sous tous les dossiers.Une erreur que font souvent les Newbies (moi :D) est de penssr que ce sont les fichiers du workspace qui determinent ce qui sera compilé au final (dans notre cas le .bin - rom GBA).Ce n'est évidemment pas le cas .Les fichiers dans les repertoires ne sont qu'une manière d'y accéder plus facilement. Pour accéder à un fichier et son contenu il faut simplement double clicker dessus, une fenêtre contenant le code apparait alors dans la partie gauche de l'écran. Vous pouvez maintenant éditer simplement le code. Il est interessant de toujours fermer une fenêtre avant d'en ouvrir une nouvelle. Cet acte vous permet de sauvegarder les fichiers au fur et à mesure et, ainsi, de ne pas perdre votre travail en cas de crash windows :D.

[modifier] La compilation

Mais, qu'est ce qui est compilé alors ? Et bien le fichier appelé "CPPTest.mak" est là pour ça.Et c'est pourquoi nous allons l'utiliser dans ce but (ça veut rien dire ce que j'écris mais je me comprend hein), donc ouvrons-le et regardons s'il necessite d'être édité.Double clickons dessus, le source apparaît dans toute sa splendeur.Regardez la ligne "SRCDIR = G:\GBA\CPPTest". Laissez-moi vous expliquer pourquoi ce n'est pas le bon repertoire dans notre cas; nous avons installé le Kit dansle repertoire C:\GBA (comme je l'ai dit), et SRCDIR est le repertoire contenant les sources de la rom, pas du kit. Changez le en "C:\GBADEV\CPPTest", et encore une fois, faites attention de ne pas rajouter de "\" à la fin, sinon ça va pas marcher hein !!Notez également que la base est G: par default, n'oubliez pas de le changer. Tous les autres dossiers (les 5 en dessous de celui que nou venons de changer) pointent sur certaines choses dans le kit de développement nécessaire à la compilation du programme.Changez-les de manière à ce qu'il correspondent à votre configuration.Enfin, vous devez utiliser votre repertoire d'installation. Au final on à donc:

SRCDIR  = C:\GBADEV\CPPTest
 CMPDIR  = C:\GBA\bin
 LIBDIR  = C:\GBA\lib\gcc-lib\arm-agb-elf\3.0.2\interwork
 LIBDIR2 = C:\GBA\arm-agb-elf\lib\interwork
 INCDIR  = C:\GBA\lib\gcc-lib\arm-agb-elf\3.0.2\include
 INCDIR2 = C:\GBA\arm-agb-elf\include

Si vous êtes paresseux vous pouvez faire un copier/coller de ça, mais je vous conseille grandement de le faire manuellement afin d'apprendre par vous même. Il n'y à pas de raccourcis pour apprendre, mon ami ;) Maintenant que tout est fini, vous pouvez fermer la fenêtre. Remarquez qu'on vous demande de sauvegarder. Après l'avoir fait vous ne pourrez plus utiliser le "Undo" sur ce fichier !

Ok, nous sommes maintenant prêt à compiler notre premier programme.Si vous voulez regarder un peu le source de ce que nous allons compiler ouvrez simplement "main.cpp" dans le repertoire du "workspace". Tout ce code !!!! Oula, mais que cela peut-il bien produire ??? Un nouveau Mario ? Half-Life?Allez dans le menu déroulant "Build" et selectionné "Rebuild All". Le compilateur prend son temps, et compile le code source.Vous pouvez le voir en action en bas de la fenêtre, compilation et linkage de fichier :). Voila c'est fini, il devrait vous dire "CPPTest.bin - 0 error(s), 0 warning(s)" (Si vous ne voyez pas ça d'écrit il y a un problème - il ne reste plus qu'à vous brûler les cheveux ¬_¬). Le message signifie que le fichier .bin à été créé. Et oui, votre première rom GBA à été compilée avec succés. (Ok, vous n'avez pas écrit le code, mais vous avez tout de même fait quelque chose!), et maintenant vous pouvez y jouer avec votre émulateur préféré.La rom se trouve dans le repertoire CPPTest.

Bon code!