Subversion JAVA Eclipse

Download Subversion JAVA Eclipse

Post on 15-Jul-2015

53 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

<p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Subversion (SVN) sous Eclipse (JAVA), avec Google Code1. Plan1. Plan 2. Introduction 2.1. Prsentation du tutorial 2.2. Intrt et fonctionnement de Subversion 2.3. Informations 3. Rcuprer un SVN grce Google Code 3.1. Google Project Hosting 3.2. Cration dun projet 3.3. Ajout des membres 3.4. Informations importantes 4. Installer et configurer Subclipse 4.1. Lien de tlchargement 4.2. Installation sous Eclipse 4.3. Configuration du SVN Google : Affichage 5. Utilisation de Subversion 5.1. Partage dun projet 5.2. Dtails sur le Project Explorer 5.3. Outils de partage 5.3.1. Synchronize with Repository 5.3.2. Commit 5.3.3. Update to HEAD / Update to Version 5.3.4. Create Patch / Apply Patch 5.3.5. Branch/Tag 5.3.6. Merge / Switch to another Branch/Tag/Revision 5.3.7. Show 5.3.8. Add to Version Control/Add to svn:ignore 5.3.9. Set Property 5.3.10. Autres outils 1 2 2 2 2 3-6 3 4 4-5 6 7-12 7 8-10 11-12 1313-15 15 16-19 17 17 17 17 18 18 18 19 19 19</p> <p>1</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>2. Introduction2.1.Prsentation du tutorialSubversion (SVN) est un systme de gestion de donnes, principalement utile pour du travail en commun. Ce tutorial va dtailler au travers dun exemple simple et dimages comment rcuprer un SVN par Google Code (cela ncessite un projet Open Source, attention), installer le plug-in Subclipse sous Java, et tester ses principales fonctions.</p> <p>2.2.Intrt et fonctionnement de SubversionLes avantages de lutilisation dun SVN sont nombreux, et vous tes invits parcourir Gestion de version avec Subversion, un livre Open Source traitant du sujet. En voici un bref aperu, tel quil va tre prsent dans ce tutorial : Donnes sauvegardes Online Les donnes seront sauvegardes et accessibles sur Internet, ce qui garantit leur accessibilit et leur prennit. Une perte dinformation de votre ct est immdiatement rpare. Conservation des versions Chaque version dun mme fichier est conserve sous SVN ; cela veut dire que vous pouvez tout moment revenir sur vos pas, et mme travailler simultanment sur des versions diffrentes de votre projet. Il est galement possible dafficher les diffrences entre chaque version. Partage des fichiers Chaque fois quun membre du projet change quelque chose, sa version modifie sera immdiatement et visiblement accessible pour tous les autres. Simplicit dutilisation Lutilisation de Subclipse permet de se passer totalement de lignes de commande, et dutiliser Subversion avec une interface intuitive et parfaitement intgre Eclipse.</p> <p>2.3.InformationsTutoriel ralis le 11/04/2011 avec : Windows XP Pro Eclipse IDE for Java Developers 1.3.2.20110301-1807 ( Eclipse Platform 3.6.2.M201102101200 ) Subclipse 1.6.17 JDKTM6</p> <p>2</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>3. Rcuprer un SVN grce Google Code3.1. Google Project HostingLentreprise Google encourage notablement les initiatives Open Source, et a mis Google Project Hosting en place sur sa plateforme Google Code, qui permet de crer automatiquement une plateforme de dveloppement collaboratif sous licence Open Source (incluant donc un SVN). Pour y accder, connectez-vous sur http://code.google.com/hosting/ et choisissez Sign in to create a project (entour en orange sur la capture) ; il vous faut en effet un compte Google (pour vous et tous les membres du projet), crable rapidement et gratuitement.</p> <p>1 Cration d'un compte Google</p> <p>Si vous avez dj un compte Google (par exemple un compte Gmail), choisissez Create a new project.</p> <p>2 Accder au formulaire de cration</p> <p>3</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>3.2.Cration dun projetSur la page suivante, remplissez les champs Project name (nom), Project summary (rsum) , Description et Project Label (tiquettes, utilises pour le rfrencement) comme vous le souhaitez (champs obligatoires), puis slectionnez Subversion dans le champ Version Control System . Le dernier champ, Source code License , est plus dlicat : vous devez choisir une licence open source pour votre projet, mieux vaut pour vous passer un peu de temps chercher celle qui vous convient.</p> <p>3 Dtails du projet</p> <p>Dans notre cas, nous avons choisi la licence MIT, qui est apparue comme une des moins contraignantes. La nouvelle version de la licence BSD pourrait aussi correspondre. Ensuite, cliquez sur Create Project .</p> <p>3.3. Ajout des membresVotre projet est dsormais cr, et vous vous trouvez sur sa page daccueil. Il est pour linstant assez vide, notre premier rflexe doit tre dinviter les autres membres du projet. Cliquez sur People dans le menu du haut, sous longlet Project Home .</p> <p>4 Accder l'invitation de membres</p> <p>4</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Cliquez sur la zone de texte contenant Enter new member email adresses , puis remplissez le champ et choisissez le rle du futur membre parmi les suivants : Owner , qui lui donnera les mmes droits que vous, Committer , empchant de modifier les paramtres du projet, Contributor , qui naccorde aucune permission particulire.</p> <p>Notez que votre projet est Open Source, cest--dire que nimporte qui pourra accder votre code, et ce sans que vous en soyez inform. Finalement, cliquez sur Add Member .</p> <p>5 Inviter un membre</p> <p>La personne invite recevra automatiquement un email, et peut dores et dj participer au projet (si elle est au moins committer ). Vous pouvez ensuite, en cliquant sur le nom du membre, prciser son travail et des notes le concernant (accessibles tous).</p> <p>6 Prciser son rle</p> <p>Nhsitez pas cliquer sur tous les liens pour vous familiariser avec les outils proposs par Google Code, le wiki comme linterface de tlchargement pourraient vous aider communiquer.</p> <p>5</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>3.4.Informations importantesIl est temps daccder ce dont vous allez avoir besoin lorsque vous configurerez Eclipse. Cliquez sur Source dans le menu.</p> <p>7 Rcuprer l'adresse du SVN</p> <p>On sintresse uniquement au lien qui apparat dans la premire ligne de code, commenant par https:// et finissant par trunk/ : gardez ce lien en mmoire, sans conserver le trunk/ . Ainsi, dans mon exemple, il sagit de :https://pt-ecm-simulation-plateforme-trading.googlecode.com/svn/ .</p> <p>Lorsquon vous demandera sous Eclipse ladresse de votre SVN, cest ce lien quil faudra donner.</p> <p>8 Vous n'aurez pas vous soucier de lignes de commande avec Subclipse</p> <p>Ensuite, il nous faut encore votre identifiant et mot de passe pour la connexion scurise : votre identifiant est ladresse lie votre compte Google, et le mot de passe est accessible en cliquant sur le lien googlecode.com password . Il ne sagit pas de votre mot de passe de compte Google.</p> <p>9 La partie bleute affiche normalement votre identifiant</p> <p>L encore, il sagit de ce mot de passe que lon vous demandera sous Eclipse. Vous pouvez en gnrer un nouveau tout moment en cliquant sur Regenerate et en confirmant.</p> <p>6</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>4. Installer et configurer Subclipse4.1. Lien de tlchargementSubclipse nest pas le seul client SVN propos par Eclipse, il existe aussi Subversive. Si ce dernier nest pas dcrit ici, cest simplement parce quil sest avr dinstallation moins aise. Rendez-vous sur http://subclipse.tigris.org/, puis choisissez Download and Install dans le menu de gauche, sous Project pages .</p> <p>10 Accs au lien de tlchargement</p> <p>Ce qui nous intresse est dans Current Release . Cherchez la version qui correspond votre version dEclipse (normalement, la dernire). Quelle que soit la version que vous choisissez, intressez-vous au lien indiqu par Eclipse update site URL : copiez-le ou gardez-le disposition.</p> <p>11 Choix de la version tlcharge</p> <p>En loccurrence, on se servira du lien de la 1.6.x , compatible avec notre version dEclipse.</p> <p>7</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>4.2.Installation sous EclipseLancez Eclipse, puis dans le menu du haut, cliquez sur Help , puis Install new Software .</p> <p>12 Initialiser lajout de Subclipse</p> <p>A droite de Work with , cliquez sur Add, puis dans la fentre qui apparat rentrez un texte qui vous permettra de reconnatre Subclipse dans le champ Name , et le lien rcupr prcdemment dans Location . Confirmez en cliquant sur OK .</p> <p>13 Renseignement du lien vers Subclipse</p> <p>Puis, en-dessous de linventaire qui saffiche, choisissez Select All , puis cliquez sur Next&gt; . En ralit, on naura pas besoin de tout, mais cest plus simple comme a.</p> <p>14 Choix des parties installes</p> <p>8</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Aprs un petit temps de chargement, une liste de ce que vous allez installer saffiche ; en effet, vous disposez dj dune partie des fichiers ncessaires, et les doublons ne seront pas tlchargs. Cliquez simplement sur Next &gt; .</p> <p>15 Liste des fichiers qui seront tlchargs</p> <p>La partie suivante concerne les licences de distribution des fichiers concerns. Prenez le temps de tout lire, ou bien choisissez directement I accept the terms of the license agreements avant de cliquer sur Finish.</p> <p>16 Texte des licences accepter.</p> <p>9</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Le tlchargement et linstallation vont alors commencer automatiquement. Selon les prcautions prises par votre ordinateur, vous pourrez avoir confirmer linstallation de certains fichiers.</p> <p>17 Quelques minutes d'attente sont ncessaires</p> <p>A la fin du tlchargement, Eclipse vous propose de redmarrer le logiciel pour prendre en compte les changements effectus, dattendre ou dessayer dappliquer directement les changements. Il vaut mieux redmarrer immdiatement, en cliquant sur Restart now .</p> <p>18 Cliquez sur Apply Changes Now vos risques et prils</p> <p>LorsquEclipse se relance, une bote de dialogue vous propose denvoyer des informations anonymes lquipe de Subclipse. Choisissez comme bon vous semble pour terminer linstallation.</p> <p>19 Envoi d'informations anonymes l'quipe de dveloppement de Subclipse</p> <p>10</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>4.3.Configuration du SVN Google : affichageDans un premier temps, nous allons afficher ce que contient le SVN mis en place plutt. Il ny a rien pour linstant, mais vous le remplirez bien vite. Ces informations tant Open Source, vous naurez pas rentrer de code dauthentification pour y accder. Dans le menu du haut, cliquez sur Window , puis mettez Open Perspective en surbrillance, et cliquez sur Other .</p> <p>20 Afficher le contenu de votre SVN</p> <p>Choisissez SVN Repository Exploring dans le menu droulant, puis cliquez sur OK .</p> <p>21 Ne confondez pas avec la perspective contenant &lt; et &gt;</p> <p>11</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Une fentre devrait souvrir votre gauche, encore vide. Cliquez droit lintrieur, et mettez en surbrillance New , puis cliquez sur Repository Location (il est possible de le faire depuis le menu gnral galement).</p> <p>22 Cration d'un lien avec le SVN Google</p> <p>Dans la fentre qui souvre, remplissez le champ URL avec ladresse que vous avez rcupre en 3.4., sur votre projet Google, puis cliquez sur Finish .</p> <p>23 Votre URL devrait avoir une forme similaire la notre</p> <p>Aprs une courte attente, vous devriez voir safficher une liste droulante dans la fentre auparavant vide. Cette liste est pour linstant vide, car vous navez encore rien envoy Google.</p> <p>24 Le contenu du SVN s'affichera dans cette fentre</p> <p>Puisque tout le reste fonctionne, nous allons maintenant voir comment utiliser Subversion.</p> <p>12</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>5. Utilisation de Subversion5.1.Partage dun projetEn haut droite de votre cran, cliquez sur Resource ou sur la double flche noire puis Resource , pour faire apparatre le Project Explorer contenant vos projets Java ouverts.</p> <p>25 On peut aussi aller dans Window &gt; Open perspective </p> <p>Normalement, le Projet Explorer saffiche sur votre gauche. Cliquez droit sur le projet que vous voulez exporter, puis mettez Team en surbrillance, et cliquez sur Share Project .</p> <p>26 Lier votre projet au SVN</p> <p>Dans la fentre qui souvre, choisissez SVN , puis cliquez sur Next .</p> <p>13</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>27 Ce tutoriel ne s'intresse pas au CVS, dont SVN hrite</p> <p>Ensuite, choisissez Use existing repository location , puis cliquez sur ladresse en-dessous, celle de votre SVN, et sur Next .</p> <p>28 Vous n'avez pas besoin de redonner l'adresse de votre SVN</p> <p>Il vous reste choisir le nom du dossier dans lequel sera stock votre projet, puis cliquez sur Next .</p> <p>29 C'est sous le nom que vous choisissez qu'il apparatra sur Internet</p> <p>On vous propose de rentrer un commentaire de votre action (visible pour vos collaborateurs). Commentez toutes vos actions, cest un outil prcieux en travail de groupe pour comprendre les modifications de chacun. Ensuite, cliquez sur Finish .</p> <p>30 Assurez-vous que vos associs comprennent ce dont vous parlez</p> <p>Enfin, on vous demande de rentrer vos identifiants. Mettez dans Username le nom de votre compte Google, et dans Password celui de Google Code (voir section 3.4). Pensez cocher la case Save Password si vous avez lintention de travailler rgulirement sur le projet. Validez.</p> <p>31 Votre compte Google est probablement votre adresse Gmail</p> <p>14</p> <p>Subversion (SVN) sous Eclipse (JAVA) avec Google Code11 avril 2011</p> <p>Eclipse vous propose ensuite douvrir une interface conue spcialement pour le partage de projets. Cette fentre vous sera trs utile par la suite, mais puisque vous nen aurez pas lutilit pour le moment, refusez.</p> <p>5.2. Dtails sur le Project Explorer Cette section est dtache de la suite logique du tutoriel, car il est ici meilleur de montrer un exemple que de le crer au fur et mesure. Vous aurez remarqu le changement dicnes dans votre Project Explorer (la fentre en haut gauche), voici quoi ressemble celle dun projet dj dbut :</p> <p>32 L'affichage diffre quelque peu de l'habituel</p> <p>Licne indique que Subversion ne sait pas sil y a des diffrences entre votre version et celle du SVN. Comme vous pouvez le voir, la modification dun seul fichier ajoute licne la ramification entire, pour plus de clart. Cela peut arriver aprs un Commit ou toute autre modification : dans ce cas, faites un Synchronize with Repository . Licne indique que le fichier est reli au SVN, et jour. Pour cette icne comme pour la prcdente, un petit texte est affich ct des fichiers. Ce sont respectivement : o o o Le numro de la version en cours, chaque changement cre une nouvelle version. La date de cration de la dernire version Lutilisateur responsable de celle-ci.</p> <p>Le fichier Serveur.java na aucune icne particulire : il nest pas partag avec les autres, et Subversion ne sen soucie pas. Il sagit...</p>