Tämän käyttöohjeen tarkoitus on käydä yksityiskohtaisesti ruudunkaappauskuvia hyödyntämällä läpi Eclipsen asentaminen sekä Subversive-pluginin asentaminen Eclipseen ja pluginin käyttö versionhallintaan. Ohjeessa oletetaan, että koneeseen on jo asennettu JDK.
Lataa esimerkiksi Eclipse IDE for Java Developers (85 MB) osoitteesta http://www.eclipse.org/downloads/ omalle käyttöjärjestelmällesi.
Jos latasit paketin joltakin peililtä, voi olla hyvä tarkastaa ladatun paketin eheys MD5- tai SHA1-tarkistesumman avulla. Tarkistesummat löytyvät More... linkin takaa aukeavalta sivulta, oikeasta reunasta, kohdan Checksums-alta josta voi tallentaa haluamansa tarkistesumman tiedostona samaan hakemistoon Eclipse-paketin kanssa.
Esimerkiksi GNU/Linux-järjestelmässä paketin eheyden voi tarkistaa seuraavasti komentoriviltä:
Windowsiin pitää käsittääkseni hakea esimerkiksi verkosta jokin ilmainen ohjelma vaikkapa MD5-summien tarkastamista varten, koska tällaista ohjelmaa ei siellä ole valmiina.
Pura lataamasi Eclipse-paketti. Esimerkiksi GNU/Linux-järjestelmässä:
Siirry syntyneeseen eclipse hakemistoon, ja käynnistä eclipse:
Jos eclipse valittaa, ettei se löydä JRE:tä tai JDK:ta, kuten yllä olevassa kuvassa, voit lisätä polun PATH-muuttujaan tai voit antaa tämän polun ohjelmalle esimerkiksi komentoriviparametrina seuraavasti:
Kun Eclipse on käynnistynyt, valitse Help-valikosta löytyvä Software Updates...-kohta.
Ja klikkaa Update-nappulaa päivittääksesi Eclipsen olemassaolevat komponentit (tämä ei varmaankaan ole välttämätöntä, mutta olemassaolevien komponenttien päivittäminen ennen uusien asentamista tuntuu vain hyvältä idealta).
Jos päivityksiä löytyy, ne voi asentaa ja käynnistää IDE:n uudelleen kun asennukset ovat valmiit. Eclipsen käynnistyttyä uudelleen valitse jälleen Help-valikosta löytyvä Software Updates...-kohta. Valitse Available Software-välilehti:
ja klikkaa Add Site...-nappulaa. Lisää osoite http://download.eclipse.org/technology/subversive/0.7/update-site/
Klikkaa Add Site...-nappulaa uudestaan ja lisää tällä kertaa osoite http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/
Valitse asennettavat paketit. Alla olevassa kuvassa on esimerkki GNU/Linux-järjestelmän tapauksessa valituista paketeista:
Valittuasi haluamasi paketit, klikkaa Finish-nappulaa aloittaaksesi asennuksen.
Asennus käynnistyy ja riippuen valittujen pakettien koosta ja lukumäärästä voi kestää jonkin aikaa.
Ainakin minulla subversiven pakettien lataus on välillä ollut todella hidasta ja joskus asennus on tununut jumiintuvan pitkäksi ajaksi. Tällöin asennuksen keskeyttäminen ja aloittaminen hetken päästä uudestaan on saattanut auttaa.
Asennuksen valmistutta käynnistä IDE uudelleen:
Eclipsen käynnistyttyä uudelleen näkyvissä pitäisi olla Subversive-tervetulosivu, jolta voi halutessaan lukea ohjeita:
Subversiven käytön harjoittelemiseksi luomme ensin oman paikallisen repositoryn kuten alla olevassa
kuvassa on näytetty (tämä edellyttää, että järjestelmässäsi on asennettuna subversion.
Ellei ole, voit asentaa sen GNU/Linux järjestelmissä paketinhallinnan kautta tyyliin
apt-get install subversion tai emerge subversion tai ladata ja asentaa sen osoitteesta
http://subversion.tigris.org/):
Kopioi tämän repositoryn polku ja luo Eclipseen esimerkiksi uusi tyhjä Java-projekti, lisää siihen vaikkapa Main-luokka. Klikkaa projektia Package Explorerissa hiiren oikealla näppäimellä ja valitse ponnahdusvalikosta Team ja Share Project:
Valitse SVN repository-pluginiksi ja klikkaa Next:
Täyty repositoryn tiedot: laita URL:iksi svnadminilla luomasi repositoryn sijainti kuten alla olevassa kuvassa. Laita myös ruksi Save password-kohtaan. Huomaa file-osuus URL:in alussa!
Kirjoita kommitille kommentti ja klikkaa OK:
Nyt projekti on versionhallinnassa. Voit tarkistaa, että kaikki on ajan tasalla klikkaamalla projektia oikealla hiiren näpäimellä, ja valitsemalla Team ja Synchronize with Repository. Jos ja kun eclipse kysyy haluatko vaihtaa perspektiiviä, vastaa kyllä.
Synchronize-ikkunassa näkyy, että projektissa ei ole muutoksia:
Palaa takaisin Java-perspektiiviin:
Jotta voisimme testata useamman kehittäjän vuorovaikutusta itse, luomme jonnekkin tilapäishakemistoon uuden version projektista kuten alla olevassa kuvassa on näytetty:
Kirjaimet A tiedostonimien edessä tarkoittavat, että nämä tiedostot ovat uusia ja ne lisätään projektiimme. Voimme nyt mennä src-hakemistoon ja muokata tekstieditorilla Main.java-tiedostoa:
Muokataan tiedostoa:
Tallennetaan muutokset ja kysytään subversionilta tilannetta. M tarkoittaa, että tiedostoa on muokattu.
svn diff näyttää muutokset. - rivin edessä tarkoittaa vanhaa, poistuvaa riviä, ja + uutta riviä:
Kommitoidaan muutokset:
Palataan Eclipseen ja synkronoidaan repositoryn kanssa:
Näemme, että sisäänpäin on tulossa muutoksia Main.java-tiedostoon. Kaksoisklikkaamalla tiedostoa aukeaa diff-näkymä, jossa näkyy vasemmalla paikallinen (lokaali) tiedosto ja oikealla ulkoinen tiedosto.
Ulospäin menevissä muutoksissa ei ole mitään, koska emme ole tehneet muutoksia Eclipsessä:
Tehdään update:
Hyväksytään muutokset:
Lisätään Eclipsessä projektiin uusi luokka Henkilo. Lisätään tämän jälkeen syntynyt uusi Henkilo.java-tiedosto versionhallinnan alle kuten allaolevassa kuvassa:
Varmistetaan vielä versionhallintaan lisättävät resurssit:
Synkronoidaan repositoryn kanssa ja kommitoidaan ulosmenevissä muutoksissa näkyvä Henkilo.java:
Annetaan kommitointi-kommentti:
Mennä komentoriville käyttämään toista versiotamme ja tehdään siellä update ulkoisten muutoksien lukemiseksi ja muokataan lisättyä Henkilo.java-tiedostoa:
Lisätään muutamia attribuutteja, tallennetaan tiedosto ja suljetaan tekstieditori:
Kommitoidaan muutokset:
Konfliktin aikaansaamiseksi mennään ja muokataan samaa Henkilo.java-tiedostoa ilman updaten tekemistä myös Eclipsessä lisäämällä hetu-attribuutti:
Synkronoidaan repositoryn kanssa, ja huomataan, että konflikti-näkymässä (punainen kaksipäinen nuoli), on jotakin:
Konfliktit on merkitty punaisella. Ratkaistaan konfliktit manuaalisesti:
Kommitoidaan muutokset ja annetaan kommentti:
Tehdään komentorivillä update uusimpien muutosten saamiseksi:
Avaa SVN Repository Exploring-perspektiivi:
Klikkaa hiiren oikealla painikkeella ja lisää uusi repository:
Kirjautumalla code.google.com:iin Gmail-tunnuksellasi ja salasanallasi saat näkyviin käyttäjänimesi ja salasanasi repositoryyn pääsemiseksi. Automaattisesti generoitu salasana löytyy linkin takaa, jossa sen voi myös generoida uudelleen:
Täytä pyydetyt tiedot (URL, käyttäjänimi ja salasana. Valitse Save password-kohta.
Valmista:
