TortoiseSVN

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)

Tietyn projektin 1. vientiä varten on tehtävä peräkkäin kohdat 2.-5.

Normaali tapa aloittaa on luoda ensin Repository tyhjään hakemistoon ja sitten lisätä siihen tiedostoja ja Commitoida. Alla olevissa ohjeissa lähdetään siitä, että hakemistossa on jo tavaraa, joka halutaan viedä versionhallintaan uuteen repositoryyn.

1. TortoiseSVN

TortoiseSVN on SVN asiakasohjelma Windowsiin. Sen asentamalla Windowsin Explorerin (eli tiedostonhallinnan, älä sotke IE:hen) saa käyttöliittymäksi SVN:ään. Mikroluokissa asennus on jo tehty, kotikoneessa pitää asentaa.

1. Hae: http://tortoisesvn.tigris.org/
2. Asenna, valitse asentaessasi myös Command line Tools mukaan.
3. Ohjeita löydät esimerkiksi http://tortoisesvn.net/docs/nightly/TortoiseSVN_fi/

2. Uuden varaston (repository) luominen (mkdir)

Uuden SVN-varaston luominen (repository):

1. Explorer auki
2. Oikeaa nappia hakemiston päällä, jonka haluat versionhallintaan
3. TortoiseSVN ja Repo-browser
4. Suurenna vasen ikkuna riittävän isoksi, yleensä se aukeaa liian kapeana.
5. Mene rivin `` päälle Jos kysyy URLia, niin kirjoita ko. URL.
6. Oikeata nappia ja Create folder... (Jos kysyy tunnusta ja salasanaa, niin anna ne ja anna lupa tallentaa)
7. Aseta nimeksi USERNAME
8. Siirry syntyneen uuden hakemiston nimen päälle
9. Oikeata nappia ja Create folder...
10. Nimeksi trunk
11. Luo vielä tags-niminen hakemisto oman hakemistosi alle trunkin vierelle
12. Windows 7 -käyttäjien kannattaa laittaa Windowsin Indeksointi pois repositorystaan, voi aiheuttaa ongelmia!

3. Oman hakemiston muuttaminen versionhallintaan 1. kerran

1. Haet varaston takaisin, jotta saat hakemistosi svn:n alle (ks. kohta 4, Checkout, voit tehdä tämän olemassa olevan päälle niin tiedostot saavat merkinnän siitä että ovat svn:än alla, ole tarkkana hakemistojen nimien kanssa ettei synny turhaan uutta hakemistoa. Tulee valittamaan että hakemistossa on jo tavaraa, mutta kuittaa tämä tällä kertaa).
2. Tämän jälkeen tee Commit

4. Varaston hakeminen työkoneelle (checkout)

Vanhan varaston hakeminen johonkin paikkaan:

1. Explorer auki
2. Hiiren oikealla paikassa johon varasto haetaan (hakemistossa jossa ei vielä ole svn-yhteyttä, eli ei ole .svn-piilohakemistoa)
3. SVNChekout ja osoitteeksi:
   https://svn.cc.jyu.fi/srv/svn/ohj2ht/syksy2024/USERNAME
4. selaile varasto jonka haluat hakea (yleensä trunk) ja OK (jos valittaa epätyhjyydestä ja olet tekemässä 1. kertaa, niin ok).

Homma on onnistunut jos oman koneesi hakemistoon ilmestyi .svn -niminen piilohakemisto. Näkyy esim. komennolla

dir /a:h

Explorerissa näkyy jos piilotiedostot on laitettu näkyväksi:

Tools/Folder Options/View/Hidden files and folders/Show hidden files and folders

5. Tiedostojen lisääminen versionhallintaan (add)

Tiedostoja voidaan lisätä vain hakemistossa, johon on tehty Checkout (tai johon on luotu Repository)

1. Mene hakemiston tai tiedoston päälle, jonka haluat lisätä
2. Paina hiiren oikeaa ja TortoiseSVN ja Add ja valitse lisättävät tiedostot. Joskus TortoiseSVN ei tarjoa kansion tiedostoja lisättäväksi, vaan ainoastaan valitun kansion. Paina tällöin kuitenkin OK ja suorita tämä kohta uudelleen.

6. Muutosten vieminen takaisin versionhallintaan (commit)

Muutosten vieminen takaisin

1. Explorer auki
2. Hiiren oikealla paikassa josta halutaan viedä.
3. SVN Commit
4. Anna hyvä kommentti siitä mitä olet muuttanut

7. Työtiedostojen saattaminen ajantasalle jos joku muu on muuttanut (update)

Muutosten hakeminen työkoneeseen (kun checkout on jo tehty)

1. Explorer auki
2. Hiiren oikealla paikassa johon muutokset halutaan hakea
3. SVN Update

8. Harjoitustyön vaiheen luominen (copy)

Uuden tagin (esim. ht:n vaiheen) tekeminen

1. Explorer auki
2. varmista että muutokset on tehty ja viety svn:ään
3. Siirry sen hakemiston kohdalle, johon trunk on haettu
4. Hiiren oikeata nappia ja TortoiseSVN / Branch/Tag...
5. https://svn.cc.jyu.fi/srv/svn/ohj2ht/syksy2024/USERNAME/tags/vaiheN (N on vaiheen numero!)

9. Export eli version hakeminen pelkästään käytettäväksi (export)

Exportilla saa haettua version ilman että on vaaraa vahingossa sitä Commitilla sotkea:

1. Explorer auki

2. siirry tyhjään hakemistoon

3. hiiren oikeata nappia ja TortoiseSVN/Export
   

4. Anna version URL, esim:

   https://svn.cc.jyu.fi/srv/svn/ohj2ht/k2016/vesal/tags/vaihe8.1/

5. OK

10. Ongelmatapauksien korjaamisehdotuksia

10.1 Versionhallinta rikki ja versiointi poistettava

1. Siirry rikkinäisen hakemiston "juureen"
2. Hiiren oikea ja Tortoise SVN/Export
3. Valitse sama hakemisto
4. hyväksy ehdotettu "unversioning"

10.2 Ei löydy tmp-jotakin

1. Siirry .svn alihakemistoon
2. luo sinne tmp niminen tiedosto
3. mene pykälä ylöspäin
4. Hiiren oikea ja Tortoise SVN/CleanUp

11. Ignore -asetukset

On järkevää globaalisti estää tiettyjen tiedostojen ja hakemistojen meneminen versionhallintaan.

1. Ota muokattavaksi tiedosto (Windows 7 ja 8):

   C:\Users\kayttaja\AppData\Roaming\Subversion\config

2. etsi rivi global-ignores ja muuta se muotoon (pyyhi mahdollinen # pois):

   global-ignores = *.o *.lo *.la #*# .*.rej *.rej .*~ *~ .#* .DS_Store *.suo *.cachefile bin obj *.user TestResults *.ctbackup *.class

Voit ladata koneellesi asetustiedoston. Tallenna tiedosto hakemistoon (kohta 1).

12. Tiedostojen poistaminen versionhallinasta

1. Explorer (Tiedoston hallinta) auki
2. mene hakemistoon, joka on versionhallinnassa
3. Oikeaa nappia hakemiston päällä, jota haluat käsitellä
4. TortoiseSVN ja Repo-browser
5. Nyt ole tarkkana ettet tuhoa kenenkään muun tiedostoja
6. Mene poistettavan tiedoston/hakemiston päälle Repo-browser:illa
7. Oikea hiiren nappi ja Delete
8. Kommentoi miksi tuhosit!