Versionhallinta

Tässä vaiheessa on hyvä hetki aloittaa versionhallinta. Käytämme Git-versionhallintaa, joka on laajasti käytetty työkalu ohjelmistokehityksessä. Tämän osan jälkeen teet jokaisesta tutoriaalin tehtävästä oman Git-commitin, joka kuvaa tehtävän aikana tehtyjä muutoksia.

Gitin käyttämiseen on monenlaisia käyttöliittymiä – myös IDEAssa on omansa. Käytämme tässä kuitenkin komentoriviä, koska se on suhteellisen yleinen tapa käyttää Gitiä kaikissa ympäristöissä samalla tavalla.

Aloitetaan versionhallinta luomalla Git-varasto projektille. Avaa komentorivi ja siirry projektisi juurikansioon. Juurikansio on se kansio, jossa on src-kansio ja pom.xml-tiedosto. Alusta sen jälkeen Git-varasto komennolla git init:

Saat ilmoituksen, että tyhjä Git-varasto on luotu. Projektin polku polku/omaan/todo/projektiin on tietenkin erilainen omalla koneellasi.

Ennen kuin teemme ensimmäisen commitin, meidän on kerrottava Gitille, mitä tiedostoja tulisi lisätä mukaan. Aivan alkuun riittää, että lisätään kaikki kansiossa olevat tiedostot mukaan käyttäen git add . -komentoa:

Tämä lisää kaikki nykyisessä kansiossa ja sen alikansioissa olevat tiedostot tulevaan commitiin. Huomaa, että komento ei itsessään tulosta mitään.

Varmistetaan vielä, mitä tiedostoja lähtee committiin mukaan käyttäen git status -komentoa:

Saat listan tiedostoista, joita Git seuraa ja tulee lisäämään seuraavaan commitiin. Tarkastellaan lyhyesti sisältö. Alkuun on aiemmista vaiheista tutut pom.xml, .java-lähdekoodit ja .fxml-näkymätiedosto. Puolestaan .idea-kansio sisältää IntelliJ IDEA:n kannalta oleellisia asetuksia.

Lisäksi mukana on .gitignore-tiedosto. Tämä tiedosto tuli valmiiksi projektipohjan mukana. Tiedosto kertoo Git-työkalulle, mitä tiedostoja ei haluta koskaan lisätä mukaan commitiin. Näin varmistetaan, että esimerkiksi käännetyt .class-tiedostot tai IDEAn omat asetustiedostot eivät päädy versionhallintaan. .gitignore-tiedostoa voi ja kannattaa muokata tarpeen mukaan, jos halutaan jättää pois muita tiedostoja versionhallinnasta.

Nyt voimme tehdä ensimmäisen commitin, joka tallentaa kansiossa olevan koodin tilan Gitiin ikään kuin "ruutukaappauksena". Commitin yhteydessä kirjoitetaan kuvaava viesti, joka kertoo, mitä muutoksia on tehty. Yleensä ensimmäiselle commitille kirjoitetaan viesti, kuten "Initial commit" tai "Projektin aloitus". Luo uusi commit komennolla git commit:

Komento listaa onnistumisen merkiksi kaikki tiedostot, joista tallennettiin senhetkinen tila Gitiin.

Tästä eteenpäin jokaisen tehtävän yhteydessä tee uusi commit, jossa kuvaat tehtävän aikana tekemiäsi muutoksia. Voit halutessasi tehdä useammankin commitin, jos haluat.