SVN ja Eclipse

Lue myös muut SVN vaihtoehdot.

Seuraavassa

• USERNAME = korvaa omalla käyttäjätunnuksellasi
• PROJNAME = korvaa projektinne käyttäjätunnuksella (joka voi olla jonkin jäsenen USERNAME)

0. Alkuvalmistelut

Ohjeet Eclipsen versiolle Neon 4.6 (kokeiltu 9.1.2017)

Seuraavista joko 0.1 tai 0.2. Valintaa voi olla vakea perustella, koska on kaksi kilpailevaa tiimiä. Vesa asensi vuodelle 2017 Subversiven.

Vuonna 2019 ei löytynyt subversiveä. subclipse löytyi:

• Help/Eclipse Marketplace...
• Etsitään svn
• valitaan asennettavaksi Subclipse 4.3.0

0.1 Subversive

Eclipselle löytyy lisäosien oletushakulistoista Subversive. Subversive on Eclipse tiimin tekemä.

• Subversive löytyy Help/Install New Software... -dialogista valitsemalla "Work with:" kohtaan "All Available..." ja kirjoittamalla "type filter..."-laatikkoon "Subversive", ilman lainausmerkkejä tietty. Se löytyy myös navigoimalla kategoriaan "Collaborate".
• riittää valita Subversiove SVN Team Provider
• Asennuksen aikana tai ensimmäisen käyttökerran yhteydessä Eclipse kyselee "Subversive Connectors" asennuksen valintoja. Helpoin ja toimivin tapa on valita "SVNKit Connectors" (ota uusin versio). JavaHL toimii joillakin, mutta ainakin OSX:ssä ja Linuxissa sen valitseminen voi vaatia lisäasennuksia. SVNKit toimii sekä edellämainituissa, että Windowseissa. Tätä valintaa voit vaihtaa kohdasta Preferences / Team / SVN / SVN Connector.
• Kun ensimmäistä kertaa käytetään ja asennataan noita lisäosia, niin mulle tuli virheitä, mutta ne eivät nähtävästi haitanneet, vaan subversive silti toimii.

Subversiven käyttö Eclipsessä ei eroa Subclipsestä. Jos löydät eroavaisuuksia, dokumentoi ne alle.

HUOM! 5.2.2015 koitettu asentaa näillä ohjeilla Windows 8.1:lle. Muuten kaikki ok, mutta Subversive Connectorsit eivät asentuneet minulla automaattisesti vaan ne piti kaivella erikseen, jotta sain toimimaan. Edellä mainitulla tavalla "Install New Softwaren" "Work with:" kohtaan URL: http://community.polarion.com/projects/subversive/download/eclipse/4.0/luna-site/ , niin voi käsin asentaa ne connectorit sieltä.

Täältä kautta poimittu tuo osoite: http://eclipse.org/subversive/installation-instructions.php -Antti Partti

0.2 Subclipse

Vaihtoehtoisesti voit asentaa Subclipse seuraavasti (ei testattu Marsille, ohjeen mukaan pitäisi toimia). Subclipse on Subversion tiimin tekemä.

0) Jos sinulla ei ole kohdassa 1) mainittua SVN:ää, niin 
   (ks: [http://subclipse.tigris.org/] ja varmista URL)
       Help/Install New Software/
         Add...
         Name: Subclipse
         URL: http://subclipse.tigris.org/update_1.8.x
       jne... (ota mahdolliset vapaaehtoiset lisäosat pois jos valittaa)
       // E3.6 saattooi tarvita: (ei tietoa E3.7???) Jos käytössä on 64-bittinen 
       // Windows, voi olla tarpeellista asentaa Slik SVN 64 bit 
       //   ed. http://www.sliksvn.com/en/download

       HUOM! Subclipse saattaa tarvita toimiakseen Mylyn lisäosan ja saattaa valittaa 
             sen puuttumista.
       Help/Install New Software/
         Add...
         Name: Mylyn
         URL: http://download.eclipse.org/mylyn/releases/latest  
       jne... (ota myös tässä mahdolliset vapaaehtoiset lisäosat pois, jos valittaa)

  1) Asennuksen jälkeen: Window/Preferences/Team/SVN/SVN interface: Pure Java

1. Uuden säilön (repository) luominen

Jos sinulla ei ole omaa projekti repositorya, tee alusta, muuten 1) ja jatka 10)-kohdasta,

  1) Window/Perspective/Open perspective/Other/SVN Repository Exploring
       Jos sinulla on jo projektin säilö tehtynä, jatka kohdasta 10)
  2) SVN Repository ikkunassa oikealla napilla: New/Repository Location
  3) URL: https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2024
  4) Anna USERNAME ja salasanasi
  5) Oikeata nappia sitten URL:in päällä
  6) New/New remote folder
  7) Folder name: PROJNAME  ja Next
  8) Kommentiksi tietoa projektista (esim. ryhmäläisten nimet ja tunnukset) ja Finish
  9) Oikeata nappia sitten URL:in päällä ja Refresh
 10) Poistetaan URL ettei vanhingossa käytetä sitä enää:
         Oikeata nappia sitten URL:in päällä Discard location
 11) SVN Repository ikkunassa oikealla napilla: New/Repository Location
 12) URL: https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2024/PROJNAME
 13) Oikeata nappia sitten syntyneen URLin päällä ja 
       New/New remote folder ja nimeksi tags

2. Projektin vieminen versionhallintaan

  1) Avaa tai luo projekti
  2) Hiiren oikealla projektin nimen päällä Team/Share project/SVN Next
  3) Valitse https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2024/PROJNAME Next
  4) Use specified folder name: trunk   Next 
  5) Anna hyvä kommentti ja Finish. 
  Voit katsoa projektia SVN:ssä tuolla SVN Repository -ikkunassa
     Paina Refresh tarvittaessa

3. Tiedoston lisääminen versiohallintaan

  1) Jos erikseen ei ole kielletty, niin muistaa Commitissa
     itse ehdottaa lisäyksiä.
  2) Jos tiedosto ei lisäänny automaattisesti esim. svn:ignore -ominaisuuden 
     takia, niin tiedoston nimen päällä oikeata nappia ja 
     Team/Add to Version Control

4. Työn hakeminen tyhjään kansioon

Tämä voidaan tehdä projektin kautta:

  1) Package Explorerissa New/Project/SVN/Checkout Projects from SVN  Next
  2) Valitse https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2024/PROJNAME Next
  3) Valitse trunk Next
  4) Ehdottaa yleensä oikeata nimea valmiiksi projektille jos Java-projekti Next
  5) Valiste sopiva hakemisto, ruksi pois tarvittaessa 
     Huom! Tämän hakemiston alle syntyy Projetin niminen hakemisto
     Finish

EDIT: Tässä pitää vielä muuttaa tuotu projekti java projektiksi. Ohjeet esim. tästä:
http://enarion.net/programming/eclipse-change-general-to-java-project/

tai SVN Repositoryn kautta:

  1) Siirry SVN Repository -ikkuna (ota refresh tarvittaessa)
  2) Mene trunk (tai muuten haluamasi hakemiston päälle)
  3) Hiiren oikealla ja Checkout...
  4) Next
  5) Valitse mieleinen hakemisto (muista että valisteman hakemiston alle
     syntyy projektin niminen hakemisto)
  6) OK       

5. Muutosten hakeminen nykyiseen hakemistoon

Mikäli olet hakemistossa johon työ on jo joskus haettu, niin:

  1) Hiiren oikeata nappia projektin nimen päällä
  2) Team/Update

6. Muutosten lähettäminen versiohallintaan

Kun olet muutellut tiedostoja niin:

  1) Hiiren oikeata nappia projektin nimen päällä
  2) Team/Commit...
  3) Anna muutoksia kuvaava kommentti
  4) Ruksi mahdolliset uudet tiedostot
  5) OK

7. Uuden tagin (esim. ht:n vaiheen) luominen

Seuraavassa esimerkissä tehdään vaihe1 niminen tag. Muuta sanaa "vaihe1" tarpeen mukaan.

  1) Hiiren oikeata nappia trunk-kansion päällä
  2) Team/ Branch/Tag...
  3) ToUrl: https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2024/PROJNAME/tags/vaihe1
  4) Hyvä kommentti ja OK