Installation d'un PC de développement pour AmapJ
Installation de Java
Vous devez installer Java 8 (il n'est pas possible d'utiliser une version supérieure ou inférieure)
Installation de Eclipse
Vous devez d'abord visiter la page Eclipse Download pour télécharger la dernière version d'Eclipse
Vous devez télécharger la version "Eclipse IDE for Java EE Developers"
Créer un répertoire c:\dev-amapj
Dezipper l'archive que vous avez téléchargé dans ce répertoire, vous obtenez alors c:\dev-amapj\eclipse\
Installation de Tomcat
Vous devez d'abord visiter la page Tomcat Download pour télécharger la dernière version de Tomcat 9
Vous devez télécharger la version "Binary Distributions", Core zip
Vous dezippez le contenu de l'archive dans c:\dev-amapj, vous obtenez alors C:\dev-amapj\apache-tomcat-9.x.x
Telechargement des sources
Vous devez ensuite visiter la page Amapj Download pour télécharger les sources de AmapJ
Vous devez alors obtenir un fichier amapj-src-Vxxx.zip
Poser le fichier dans C:\dev-amapj\ (sans le dezipper)
Configuration Eclipse / Tomcat
Lancer Eclipse en double clickant sur C:\dev-amapj\eclipse\eclipse.exe
Quand Eclipse vous le demande, indiquer pour workspace C:\dev-amapj\workspace
Faites ensuite File / New ... / Other , puis choisir dans le liste "Server/Server"
Faites ensuite Next
Choississez Apache / Tomcat v9.0 Server, puis faire Next
Faites ensuite Next
Faites Browse, et indiquez comme chemin C:\dev-amapj\apache-tomcat-9.x.x
Faites ensuite Next , puis Finish
Toujours dans Eclipse, aller ensuite dans le menu Windows / Preference
Aller ensuite dans General / Workspace
Au niveau de text file encoding, choississez Other UTF-8, puis faire OK
Mise en place de AspectJ
Vous devez ensuite installer le plug in AspectJ
Dans Eclipse, faites Help / Install new software
Dans le champ "Work with", mettez "http://download.eclipse.org/tools/ajdt/410/dev/update"
Faites entrée
selectionner les trois items
AspectJ Developpement Tools
AspectJ Developpement Tools Source
Other AspectJ Tools
Faites ensuite Next / I Agree / Next / Finish
Faites ensuite OK à la demande de redémarrage de Eclipse
Création du projet Eclipse
Faites ensuite File / New / Dynamic Web Project
Saisir un nom de projet : amapj
Faites ensuite Finish
Faites ensuite clic droit sur le projet amapj, puis sélectionner "Configure", puis "convert to AspectJ project"
Sélectionner le projet amapj, puis depuis le menu en haut, faites ensuite File / Import
Sélectionner ensuite General / Archive File , puis faire next
Faites Browse, et indiquez comme chemin C:\dev-amapj\amapj-src-Vxxx.zip
La case into folder est normalement automatiquement renseignée à amapj
Faites ensuite Finish
A la question Overwrite,faites Yes to all
A noter : si vous avez installé le logiciel dans un répertoire différent de c:/dev-amapj, alors il faut éditer le fichier amapj/WebContent/META-INF/context.xml, et remplacer la chaîne de caractère C:/dev-amapj/ par la bonne valeur.
Faites ensuite Project / Clean pour forcer la compilation du projet
Démarrage de l'application
Dans Eclipse, sélectionner le projet amapj, faires clic droit Run As / Run On Server
Faites ensuite Finish
Vous devez alors obtnir le résultat suivant :
Vous pouvez alors commencer la visite guidée de l'application en suivant ces instructions : Visite guidée de AmapJ
Comprendre le code de AmapJ
Pour avoir plus d'informations sur le fonctionnement interne de AmapJ , certains détails sont présentés ici : Fonctionnement du code de AmapJ