Serge NOEL
304 lines
16 KiB
Plaintext
304 lines
16 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="fr">
|
|
<!--Updated Hervé BLOREC <bzh56420@yahoo.fr> on 2016-07-08 -->
|
|
<head>
|
|
<title>JMRI: Building with Eclipse</title>
|
|
<meta name="author" content="Bob Jacobsen">
|
|
<meta name="keywords" content="JMRI technical code Eclipse">
|
|
<!--#include virtual="/help/fr/parts/Style.shtml" -->
|
|
</head>
|
|
|
|
<body>
|
|
<!--#include virtual="/help/fr/parts/Header_fr.shtml" -->
|
|
<div id="mBody">
|
|
<!--#include virtual="Sidebar.shtml" -->
|
|
<div id="mainContent">
|
|
<!-- Page Body -->
|
|
|
|
<h1>JMRI: Construction avec Eclipse</h1>
|
|
|
|
<p>Eclipse (disponible à <a href="http://www.eclipse.org"> www.eclipse.org </a>) fait une excellente plate-forme pour
|
|
travailler avec JMRI.</p>
|
|
|
|
<p>Eclipse est un environnement complexe. Si vous êtes déjà familier
|
|
avec les IDEs comme Microsoft Visual Studio, il ne sera pas trop difficile de s'y habituer,
|
|
mais il vaut vraiment la peine d'acheter un manuel (par exemple
|
|
<a href="http://www.amazon.com/exec/obidos/tg/detail/-/0321305027/qid=1124158635">
|
|
Le guide du développeur Java pour Eclipse </a>).
|
|
</p>
|
|
|
|
<p>Les développeurs JMRI utilisent Git pour le contrôle de la source. Le contrôle de la source utilisant Git
|
|
est inclus comme un élément lors du téléchargement Eclipse "Luna".Pour plus d'information ou une methode alternative pour
|
|
obtenir la source JMRI, voir <a href="getgitcode.shtml">JMRI: Obtention du Code</a>.</p>
|
|
|
|
<p>Ces instructions ont été développées et testées avec "Eclipse IDE
|
|
for Java Developers" "Luna Service Release 1a (4.4.1)".</p>
|
|
<p>Noter également que, au moment de la rédaction de ce document d'aide que
|
|
JMRI nécessite JAVA version 8. Vous devez confirmer que JRE 8 est le
|
|
Java Runtime Environment par défaut. Eclipse recommande l'installation
|
|
de la parution Luna pour Java 8, mais il existe des solutions de contournement décrites en ligne. </p>
|
|
|
|
<a name="getgit"></a>
|
|
<h2>Obtention de la Source JMRI en utilisant Git</h2>
|
|
|
|
Pour obtenir le code source depuis GitHub en utilisant Git, vous devez faire
|
|
ce qui suit:
|
|
|
|
<ol>
|
|
<li>Aller à <a href="https://github.com/">GitHub.com</a> et créer
|
|
un compte.
|
|
<li>Ensuite ouvrir Eclipse</li>
|
|
<li>Depuis la barre de menu principale sélectionnez "File" puis "Import..."</li>
|
|
<li>Cliquez sur "Git" puis Project from Git" puis le bouton "Next".</li>
|
|
<li>Maintenant sélectionnez le référentiel source en cliquant sur "Clone URI".
|
|
L'écran Source Git Repository doit apparaître.</li>
|
|
</ol>
|
|
|
|
<a href="images/EclipseSourceGitRepository.png">
|
|
<img src="images/EclipseSourceGitRepository.png" width="350" height="312" alt="Eclipse Git pane"></a>
|
|
|
|
<ol>
|
|
|
|
<li>Sélectionnez les branches que vous voulez installer. Si vous n'êtes pas sûr
|
|
des branches dont vous avez besoin, sélectionnez juste la branche "master"0. Cette branche
|
|
contient le tout dernier code pour JMRI.</li>
|
|
<li>Cliquez le bouton "Next" et l'écran Local Destination
|
|
doit apparaître.</li>
|
|
<li> Appuyez sur le bouton "Next" si la destination locale vous
|
|
convient.</li>
|
|
</ol>
|
|
|
|
<p>Après que le téléchargement est terminé l'Eclipse Package Explorer
|
|
devrait ressembler à ceci: </p>
|
|
<a href="images/EclipsePackageExplorer.png">
|
|
<img src="images/EclipsePackageExplorer.png" width="350" height="312" alt="Eclipse Package Explorer pane"></a>
|
|
<p>Quand le téléchargement est terminé, Eclipse rapportera une erreur:
|
|
Projet "jmri" est manquant dossier source nécessaire: "java/tmp".
|
|
Ceci peut être corrigé en exécutant une construction Ant comme décrit plus bas
|
|
|
|
<h2>Construire et exécuter JMRI en utilisant Ant</h2>
|
|
|
|
Nous recommandons que avant d'essayer et de construire et d'exécuter l'un des
|
|
applications au sein d'Eclipse que vous exécutiez le build.xml de Ant au sein
|
|
d'Eclipse. Ce sera de créer les répertoires nécessaires, charger quelques ressources
|
|
icônes, et créer des fichiers Java nécessaires à l'aide de JavaCC. Pour exécuter
|
|
le build.xml de Ant vous devez faire ce qui suit:
|
|
|
|
<ol>
|
|
<li>Ant nécessite un JDK (Java Development Kit) afin d'exécuter
|
|
le fichier fourni "build.xml". Le téléchargement d'Eclipse n'inclut pas un JDK,
|
|
vous devez télécharger et installer un JDK, puis configurer Ant
|
|
pour utiliser le JDK.
|
|
<li>Voici un lien pour le site Oracle site qui vous fournira
|
|
un JDK:
|
|
<p>
|
|
<a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">http://www.oracle.com/technetwork/java/javase/
|
|
downloads/index.html</a>
|
|
</p>
|
|
</li>
|
|
<li>Sélectionnez le fichier build.xml à l'aide de Package Explorer, puis
|
|
cliquez-droit et un menu devrait apparaître. </li>
|
|
<li> Maintenant, sélectionnez "Run As" puis "2 Ant Build".</li>
|
|
<li>Assurez-vous que sous l'onglet Menu JRE vous avez sélectionné
|
|
un JDK et non un JRE.</li>
|
|
<li>Maintenant, appuyez sur le bouton "Exécuter", ce qui devrait commencer le "Ant build" .
|
|
</ol>
|
|
|
|
<p>Si la construction de Ant échoue, il est plus probable parce que vous ayez besoin d'un JDK (Java
|
|
Development Kit) plutôt que d'un JRE (Java Runtime Environment) qui est
|
|
la valeur par défaut. Pour modifier le JRE, sélectionnez "Run as" "2 Ant Build"
|
|
et une nouvelle fenêtre devrait apparaître. Sélectionnez l'onglet "JRE". Le changement de JRE,
|
|
sélectionnez le bouton radio "Separate JRE:" , puis appuyez sur le bouton "JRE installés"
|
|
Si vous ne voyez pas un JDK, vous devez en ajouter un.( depuis le site ci-dessus )</p>
|
|
|
|
|
|
<p>Si la construction de Ant réussit,vous pouvez maintenant lancer une des applications JMRI
|
|
de ant, et créer un fichier jmri.jar si vous le souhaitez. Utilisez la
|
|
fonction "2 Ant Build" et dans la fenêtre, sélectionnez l'onglet "Targets", et utiliser la
|
|
case appropriée pour générer ce que vous voulez.</p>
|
|
|
|
<h2>Construire et exécuter JMRI en utilisant Eclipse</h2>
|
|
|
|
<p>Après avoir terminé la construction de Ant comme décrit ci-dessus, vous devez
|
|
actualiser le répertoire jmri. Faites un clic droit sur le nom du répertoire jmri et
|
|
sélectionnez "Refresh". L'opération de régénération doit déclencher
|
|
une construction de l'espace de travail et la construction devrait se terminer sans erreur..
|
|
<p>Pour exécuter une application faire comme suit:</p>
|
|
|
|
<ol>
|
|
|
|
<li>Vous devez vérifier que le niveau de conformité du compilateur est réglé
|
|
sur Java 1.8. sélectionné dans la barre principale de comande "Window->Preferences"
|
|
puis sélectionnez "Java-> Compiler"
|
|
<li>Depuis le menu "Run", séelectionnez "Run Configurations..." Nous allons utiliser
|
|
la fenêtre qui s'ouvre pour Configurer les programme (s) à exécuter. (Si le
|
|
menu Exécuter n'a pas d' entrée "Run Configurations ...", assurez-vous
|
|
que vous avez sélectionné le répertoire java dans le volet de navigation ci-dessus-les menus
|
|
Eclipsesont sensibles au contexte) )</li>
|
|
|
|
<li>Sur le côté gauche, mise en évidence de "l'application Java", puis appuyez
|
|
sur l'icône "New" au-dessus. L'icône ressemble à un document avec un signe plus
|
|
sur la partie supérieure droite..</li>
|
|
|
|
<li>Vous devriez maintenant avoir un nouvel onglet "Main" en surbrillance. Au-dessus ceci,
|
|
remplacer "New_configuration" par "DecoderPro". Ci-dessous, entrez "jmri"
|
|
(minuscules importante) pour "Project" et "apps.DecoderPro.DecoderPro" for "Main class:".</li>
|
|
|
|
<li>Sélectionnez l'onglet "Arguments", et sous les arguments VM entrer ( Vous
|
|
devriez probablement couper et coller ): <br><pre>
|
|
-Xms10m
|
|
-Xmx300m
|
|
-Djava.security.policy=lib/security.policy
|
|
-Dapple.laf.useScreenMenuBar=true
|
|
</pre> Si vous utilisez un système Windows 32 bits ajouter le chemin de la bibliothèque:
|
|
<pre>-Djava.library.path=.;lib;lib/windows/x86
|
|
</pre> Notez que si vous utilisez un système Windows 64 bits modifier le chemin de la bibliothèque
|
|
pour: <pre>-Djava.library.path=.;lib;lib/windows/x64
|
|
</pre>
|
|
</li>
|
|
|
|
<li>En option, sélectionnez l'onglet "Common", la section"Display in favorites menu",
|
|
cochez les cases à côté de "Run" et "Debug"</li>
|
|
|
|
<li>Si vous souhaitez créer des objectifs pour rendre facile l'exécution de PanelPro et AllTests, répétez les
|
|
étapes ci-dessus
|
|
pour créer un nouveau "Java Application"
|
|
sauf spécification "apps.PanelPro.PanelPro" et
|
|
"apps.tests.AllTest" respectivement..</li>
|
|
|
|
<li>Cliquez sur "Apply" puis "Close" (Vous pouvez cliquer sur "Run" à ce stade, mais
|
|
nous avons un peu plus à faire</li>
|
|
|
|
<li>Vous devriez maintenant être de retour à votre vue du navigateur habituel Eclipse,
|
|
où la plupart des travaux de développement se font. Pour voir notamment
|
|
java, développez le dossier "java" à gauche, puis
|
|
le dossier "src", naviguer vers le fichier que vous souhaitez.
|
|
|
|
<li>Pour exécuter DecoderPro, sélectionnez la rubrique "Run History" dans le menu "Run" . Une fois que vous avez fait
|
|
cela une fois, il vous suffit de cliquer sur l'icône "Run" dans la barre d'outils pour relancer le dernier programme.
|
|
|
|
</ol>
|
|
|
|
<a name="javacc"></a>
|
|
<h2>Installation de JavaCC Plugin ( Comme alternative à exécuter Ant Build
|
|
procédé ci-dessus )</h2>
|
|
|
|
Au lieu d'utliser la consruction ant porur pour remplir le répertoire "tmp", vous pouvez,
|
|
installer le plugin JavaCC. Voici les étapres:
|
|
<ol>
|
|
<li>Téléchargez le plugin Eclipse JavaCC suivant les instructions trouvées ici:
|
|
<a href="http://eclipse-javacc.sourceforge.net">http://eclipse-javacc.sourceforge.net</a></li>
|
|
<li>Après redémarrage d'Eclipse, clic,droit sur le répertoire java
|
|
dans Project Explorer ou Navigator et sélectionnez JavaCC Options:</li>
|
|
<li>Sur l'onglet JavaCC Options, entrez le répertoire de sortie a être
|
|
java/tmp/jmri/jmris/srcp/parser</li>
|
|
<li>Sur la page options JavaCC, entrez le répertoire de sortie a être
|
|
java/tmp/jmri/jmris/srcp/parser</li>
|
|
<li>Confirmez que le" Java Build Path" inclut le répertoire tmp
|
|
( voir Propriétés Projet )</li>
|
|
</ol>
|
|
|
|
<a name="push"></a>
|
|
<h2>Pousser des changements dans votre branche GitHub</h2>
|
|
|
|
La pratique standard pour obtenir que vos changements soient inclus dans Le code du référentiel princial JMRI
|
|
est de les proposer périodiquement dans votre répertoire local
|
|
puis lorsque vous êtes prêt à publier, proposez" toute une série de changements surle
|
|
répertoire vous appartenant à GitHub et finalement
|
|
demandez que quelqu'un mettent vos changements dans le référentiel principal JMRI
|
|
Voir:
|
|
<a href="GitFAQ.shtml">JMRI: Git FAQ</a> "Paramétrage d'un environnement Git
|
|
pour les Développeurs JMRI" pour plus d'information.
|
|
|
|
<p>Il est également une bonne pratique de "tirer" tous les changements récents
|
|
du principal référentiel JMRI avant d'effectuer vos propositions. Après un
|
|
"pull" de votre espace de travail et, éventuellement, votre dépôt GitHub
|
|
à distance sera en synchronisation avec le principal référentiel JMRI. Pour effectuer
|
|
un «pull», sélectionnez votre projet, le "Team" puis "Pull" dans le menu. </p>
|
|
|
|
<p>Si vous voulez voir quels fichiers vont être modifiés avant
|
|
le "Pull" vous pouvez usitiliser la fonctionnalité "Team Synchronizing". Pour le faire
|
|
clic-droit sur votre projet, le "Team Synchronizing" puis "Synchronise Wokspace"</p>
|
|
|
|
<p>Poussée vers votre branche GitHub:
|
|
<ul>
|
|
<li>Premièrement, soumettez votre changement sur le répertoire sur votre
|
|
ordinateur.</li>
|
|
|
|
<li>Pour soumettre un jeu de changement, clic-droit sur le projet auquel
|
|
vous voulez soumettre; et sélectionner "Team" suivi par "Commit". Entrez un
|
|
message de soumission et sélectionnés le fichier ou vous voulez soumettre.</li>
|
|
|
|
<li>Ensuite "push" un jeu de changement depuis votre répertoire local que vos
|
|
voulez soumissionner, et sélectionnez "Team" suivit par "Commit". Entrer un
|
|
messages et sélectionner les fichiers que vouis voulez soumisionner.</li>
|
|
<li>Ensuite, "push" un jeu de changements depuis votre répertoire local vers
|
|
votre répertoire sir GitHub ( vous faites ceci pour que les autres puissent y accéder et
|
|
récupérer pour l'inclusion dans JMRI)
|
|
<br>
|
|
Avant que vous puissiez poussez vos changement vers GitHub pour lz première fois,
|
|
vous devez créer votre <a href="gitdeveloper.shtml#repo">propre répertoire Git Hub</a>
|
|
( que vous avez fait ci-dessus ) et "fork" le référentiel JMRI.
|
|
Connectez-vous à votre compte à <a href="https://github.com/">GitHub.com</a> et naviquez ensuite dans le
|
|
répertoire JMRI <a href="https://github.com/JMRI/JMRI">https://github.com/JMRI/JMRI</a>
|
|
Dans le coin supérieure Droit de la page, vous trouverez un bouton
|
|
libelé "Fork". Appuyez sur ce bouton pour créer votre propre répertoire source JMRI
|
|
<br>
|
|
Pour pousser dans votre Répertoire gITμhB, sélectionnez encore "Team et ensuite
|
|
"Remote" pius "Configure puish ro Upstream". Dans la fenêtre 'Cobfigure Puss",
|
|
cliquezsur "Push URIs" et ensuite le bouton "Add". dans la fenêtre "New URI, entrez
|
|
l'URL de votre Répertoire GitHub ainsi que votre nom d'utilisateur et mot de passe.
|
|
Après appuyez sur "Finish" la fenêtre "Configure Push" devrait ressembler à l'image
|
|
ci-dessous:<br>
|
|
<a href="images/EclipseConfigurePush.png">
|
|
<img src="images/EclipseConfigurePush.png" width="350" height="322" alt="Eclipse Error pane"></a>
|
|
<br>Presser soit le bouton "Save and Push" ou "Save". Plus tard quand
|
|
vous voudrez pousser de nouveau changements dans votr répertoire sur GitHub,
|
|
vous pourrez simplement les soummisionner comme décrit ci-dessus, et ensuite utliser
|
|
l'icône Push sur la fenêtre de Synchronisation0</li>
|
|
|
|
<li>Finalement, soumettre un "Pull Request" à un référentiel principal de code JMRI sur
|
|
le site web Git HuB
|
|
<br>
|
|
Pour faire ceci, démarrer par vous identifier sur <a href="http://github.com">GitHub
|
|
web site</a>, sélecion de votre répertoire et cliquer le <a href="gitdeveloper.shtml#pull"> bouton
|
|
Pull Request</a>. Pour plus d'infon voir les <a href="gitdeveloper.shtml#pull">instructions
|
|
développées,</a>
|
|
</li>
|
|
</ul>
|
|
|
|
<a name="errors"></a>
|
|
<h2>Erreurs de Compilation et Avertissements</h2>
|
|
<p>
|
|
La configuration par défaut du Compilateur Eclipse génère de nombreux avertissements inutiles.
|
|
Vous pouvez ajuster les avertissements pour les faire correspondre aux captures d'écran
|
|
ci-dessous en allant à Window-> Preferences et sélectionnez "Java-> Complier-> Errors/Warnings" </p>
|
|
|
|
<p>
|
|
<a href="images/ErrorsWarningsCodeStyle.png"><img src="images/ErrorsWarningsCodeStyle.png" width="413" height="342" alt="Eclipse
|
|
Error pane"></a>
|
|
</p>
|
|
<p>
|
|
<a href="images/ErrorsWarningsPotential.png"><img src="images/ErrorsWarningsPotential.png" width="424" height="500" alt="Eclipse
|
|
Error pane"></a>
|
|
</p>
|
|
<p>
|
|
<a href="images/ErrorsWarningsName.png"><img src="images/ErrorsWarningsName.png" width="413" height="360" alt="Eclipse Error
|
|
pane"></a>
|
|
</p>
|
|
<p>
|
|
<a href="images/ErrorsWarningsUnnecessary.png"><img src="images/ErrorsWarningsUnnecessary.png" width="413" height="502"
|
|
alt="Eclipse Error pane"></a>
|
|
</p>
|
|
<p>
|
|
<a href="images/ErrorsWarningsAnnotations.png"><img src="images/ErrorsWarningsAnnotations.png" width="423" height="500"
|
|
alt="Eclipse Error pane"></a>
|
|
</p>
|
|
|
|
<!--#include virtual="/help/fr/parts/Footer_fr.shtml" -->
|
|
</div><!-- closes #mainContent-->
|
|
</div><!-- closes #mBody-->
|
|
<script src="/js/help.js"></script>
|
|
</body>
|
|
</html>
|