Työkaluohjeet

Ohjelmointi 2 -opintojaksolla käytämme seuraavia työkaluja:

Java Development Kit (JDK) - ohjelmistokehityspaketti, joka sisältää muun muassa Java-kääntäjän sekä virtuaalikoneen Java-ohjelmien ajamista varten.
Git - versiohallintaohjelma (engl. Version Control Software, VCS), joka mahdollistaa koodin versioinnin ja yhteistyön koodaajien välillä.
IntelliJ IDEA - integroitu kehitysympäristö (engl. Integrated Development Environment, IDE), jolla voi kehittää ja debugata muun muassa Java-ohjelmia. (koodin muokkaus, kääntäminen, ajaminen, virheenjäljitys). Käytämme IntelliJ IDEAn ilmaista Community Edition -versiota.
ComTest - työkalu dokumentaatiotestien kirjoittamiselle ja ajamiselle.

Yllä olevat ohjelmat löytyvät valmiiksi asennettuna Agoran mikroluokissa (Alban puoleinen pääty, 1. ja 2. kerros). Jos sinulla on oma tietokone, suosittelemme, että asennat ohjelmat myös siihen. Erityisesti harjoitustyön tekeminen on helpompaa, kun kaikki tarvittavat ohjelmat on myös omalla tietokoneella.

tärkeää

Tämän sivun ohjeet vaativat komentorivin käyttöä. Voit tarvittaessa kerrata komentorivin perusteita seuraavista linkeistä:

Kurssilla virallisesti tuettuja käyttöjärjestelmiä ovat Windows, macOS ja Linux. Työkalujen asentaminen ChromeOS:ään saattaa olla mahdollista, mutta emme valitettavasti voi tarjota tukea kyseiseen käyttöjärjestelmään. Tästä syystä emme suosittele ChromeOS:n käyttöä.

Valitse käyttöjärjestelmäsi alta:

Alla olevat ohjeet on testattu seuraavilla käyttöjärjestelmillä:

Windows 11
Windows 10 (käyttöjärjestelmän version on oltava vähintään 1809)

Näet käyttöjärjestelmän version suorittamalla seuraava komento PowerShell-komentorivillä:

winver

Valitse käyttöjärjestelmäsi yllä olevista vaihtoehdoista.

Esivalmistelut

Varmista, että tietokoneesi on ajan tasalla (Windows Update:ssa ei uusia päivityksiä).

Varmista sen jälkeen, että tietokoneellasi on winget-pakkaushallintaohjelma asennettuna:

Avaa PowerShell-komentorivi (Haku-ikoni > Kirjoita PowerShell > Windows PowerShell).
Anna seuraava komento:
```
winget -v
```
Tuloksena pitäisi tulostua winget-työkalun versio. Jos sen sijaan saat virheen, jossa lukee 'winget' is not recognized as the name of a cmdlet, function, script file, or operable program, tarkoittaa tämä, että sinulla todennäköisesti ei ole winget-työkalua asennettuna. Jos käyttöjärjestelmän päivitys ei auta, kokeile seuraavia ratkaisuja:
- Tarkista, että käyttöjärjestelmäsi on ajan tasalla (katso yhteensopivat käyttöjärjestelmäversiot ylempänä).
- Kokeile ladata ja asentaa winget-käsin: Lataa asennusohjelma Asennuksen jälkeen sulje ja käynnistä PowerShell uudelleen.

Varmista ensin, että tietokoneesi on ajan tasalla.

Varmista sen jälkeen, että tietokoneellasi on Homebrew-pakkaushallintaohjelma asennettuna:

Avaa Pääte tai Termimal (Launchpad > Pääte/Terminal)
Anna seuraava komento:
```
brew --version
```

Jos saat virheen command not found: brew, sinun tulee asentaa Homebrew alla olevilla ohjeilla:

Homebrew-työkalun asennusohjeet (Avaa klikkaamalla)

Avaa Pääte tai Termimal (Launchpad > Pääte/Terminal)
Asenna ensin macOS:n kehitystyökalut suorittamalla alla oleva komento:
```
xcode-select --install
```
Saatat nyt saada seuraavanlaisen ilmoituksen: Komento "xcode-select" vaatii komentorivikehitystyökalut. Haluatko asentaa työkalut nyt? (Englanniksi: The 'xcode-select' command requires the command line developer tools. Would you like to install the tools now?)

Jos tällainen ilmoitus ilmestyy, valitse Asenna/Install ja odota työkalujen asentumista. Hyväksy tarvittaessa käyttöehdot. Kun asennus on valmis, saat Ohjelmisto asennettiin/The software was installed -dialogin. Klikkaa silloin Valmis.

Jos saat virheen, jossa lukee command line tools are already installed, sinulla on jo tarvittavat työkalut asennettuna ja voit jatkaa seuraavaan vaiheeseen.
Asenna Homebrew-ohjelmahallintatyökalu seuraavalla komennolla:
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Anna työkalun latautua rauhassa.

Kirjoita macOS-käyttäjäsi salasana, kun Password-kenttä ilmestyy. Huomaa, että salasanan kirjoittaminen ei tuota mitään näkyvää tulostetta komentoriville, ei edes *-merkkejä. Paina Enter-painiketta, kun olet kirjoittanut salasanan.

Ennen asennusta Homebrew vielä tulostaa varmistusdialogin, jonka lopussa lukee
```
Press RETURN/ENTER to continue or any other key to abort:
```
Paina siinä tapauksessa Enter-näppäintä ja odota ohjelman asentumista.

Kopioi ja suorita seuraava komento (huom: tämä on yksi iso komento)

BREW_PREFIX=$( [[ $(uname -m) == arm64 ]] && echo /opt/homebrew || echo /usr/local ) \
echo >> ~/.zprofile \
echo "eval \"\$(${BREW_PREFIX}/bin/brew shellenv)\"" >> ~/.zprofile \
eval "$(${BREW_PREFIX}/bin/brew shellenv)"

Testaa, että Homebrew toimii suorittamalla komento:
```
brew --version
```
Jos asennus suoritettiin onnistuneesti, näet seuraavanlaisen tulosteen:
```
Homebrew X.X.X
```
Versionumero X.X.X voi olla mikä tahansa; olennaista on, että tuloste ilmestyy näkyviin.

Valitse käyttöjärjestelmäsi yllä olevista vaihtoehdoista.

Git

Tarkista ensin, onko sinulla jo Git asennettuna.

Avaa PowerShell-komentorivi.
Kokeile, onko Git jo valmiiksi asennettu suorittamalla komento:
```
git --version
```

Jos näet git-työkalun version (esim. git version X.XX.XX, jossa X.XX.XX on työkalun tarkka versio), voit ohittaa Git-työkalun asennusohjeen kokonaan.

Jos saat tuloksena virheen, että komentoa ei löydy, jatka alla olevilla ohjeilla.

Git-työkalun asennusohjeet (Avaa klikkaamalla)

Avaa PowerShell-komentorivi.
Asenna Git for Windows suorittamalla alla oleva komento:
```
winget install -e --id=Git.Git --custom '/COMPONENTS="ext,ext\shellhere,ext\guihere"'
```
Odota komennon suorittamista loppuun ja anna tarvittaessa asennusoikeus. Jos näet komentorivillä kysymyksen, kuten:
```
Do you agree to all the source agreements terms?
[Y] Yes [N] No:
```
Paina komentorivillä y-näppäintä ja sen jälkeen Enter-näppäintä.

Tarkista lopuksi, että komentorivillä olevassa tulosteessa on teksti Successfully installed.
Sulje kaikki auki olevat komentorivit ja avaa uusi PowerShell-komentorivi
Testaa, että git-komento on asennettu suorittamalla komento:
```
git --version
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
git version X.XX.XX
```
Tekstin X.XX.XX tilalla näkyy git-työkalun tarkka versio.
Testaa, vielä, että Git Bash on asennettu. Mene Haku-ikoni > Kirjoita Git Bash > Valitse Git Bash.

Jos kaikki toimii, pitäisi avautua Git Bash -komentorivi:

Tarkista ensin, onko sinulla jo Git asennettuna.

Avaa Pääte.
Kokeile, onko Git jo valmiiksi asennettu suorittamalla komento:
```
git --version
```

Jos saat tuloksena virheen, että komentoa ei löydy, jatka alla olevilla ohjeilla.

Git-työkalun asennusohjeet (Avaa klikkaamalla)

Avaa Pääte.
Git-työkalun pitäisi olla jo valmiiksi asennettu jos teit Valmistelu-vaiheessa olevat asiat. Tarkista, että Git toimii suorittamalla seuraava komento:
```
git --version
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
git version X.XX.XX
```
Tekstin X.XX.XX tilalla näkyy git-työkalun tarkka versio.

Tarkista ensin, onko sinulla jo Git asennettuna.

Avaa jakelusi pääteohjelma.
Kokeile, onko Git jo valmiiksi asennettu suorittamalla komento:
```
git --version
```

Jos näet git-työkalun version (esim. git version X.XX.XX, jossa X.XX.XX on työkalun tarkka versio), voit ohittaa Git-työkalun asennusohjeen kokonaan.

Jos taas näet virheen, että komentoa ei löydy, jatka alla olevilla ohjeilla.

Git-työkalun asennusohjeet (Avaa klikkaamalla)

Avaa jakelusi pääteohjelma.
Asenna Git-pakkaus: git. Pakkauksen nimi on yleensä sama kaikissa yleisillä jakeluissa (Ubuntu, Debian, Fedora, Arch, jne.)
Asennuksen jälkeen sulje ja avaa pääte uudelleen
Testaa, että git-komento on asennettu suorittamalla komento:
```
git --version
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
git version X.XX.XX
```
Tekstin X.XX.XX tilalla näkyy git-työkalun tarkka versio.

Valitse käyttöjärjestelmäsi yllä olevista vaihtoehdoista.

IntelliJ IDEA

Avaa PowerShell-komentorivi.
Asenna IntelliJ IDEA Community Edition suorittamalla alla oleva komento:
```
winget install --interactive -e --id=JetBrains.IntelliJIDEA.Community
```
Ohjelman lataamisen jälkeen avautuu asennusohjelma. Etene asennusohjelmassa eteenpäin Next-painikkeella. Kohdassa Installation Options valitse seuraavat ruksit päälle:
- Add "Open Folder as Project"
- Create Associations: .java, .gradle, .kt Etene asennusohjelmassa ja anna ohjelman asentua.
Kun pääset asennusohjelman loppuun, valitse Run IntelliJ IDEA ja paina Finish. Testaa, että ohjelma toimii.

Ensimmäisellä kerralla käynnistys saattaa kestää, sillä järjestelmä tarkistaa sovelluksen. Hyväksy mahdolliset IDEAn käyttöehdot.
Jos sinulla on jo jokin muu kehitysympäristö asennettuna (JetBrains Rider tai Visual Studio Code), IDEA saattaa kysyä, haluatko tuoda (engl. import) asetuksia niistä. Voit halutessasi tuoda asetukset, voit tehdä asetukset myös myöhemmin ja painaa Skip Import.
Kun olet valmis ja pääset Welcome to IntelliJ IDEA -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Avaa Pääte.
Asenna IntelliJ IDEA suorittamalla alla oleva komento:
```
brew install --cask intellij-idea-ce
```
Anna asennuksen suoriutua loppuun asti. Sinulta saatetaan pyytää macOS-käyttäjän salasanaa Password:-kentässä. Kirjoita silloin salasana paikalle ja paina Enter.
Tarkista, että IntelliJ IDEA toimii. Avaa Launchpad ja käynnistä sieltä IntelliJ IDEA CE.

Ensimmäisellä kerralla käynnistys saattaa kestää, sillä järjestelmä tarkistaa sovelluksen. Järjestelmä saattaa myös kysyä, IntelliJ IDEA CE on internetsitä ladattu appi. Avataanko se?. Siinä tapauksessa voi valita Avaa.

Hyväksy mahdolliset IDEAn käyttöehdot.
Jos sinulla on muu kehitysympäristö asennettuja (JetBrains Rider tai Visual Studio Code), IntelliJ IDEA voi kysyä, haluatko tuoda (engl. import) asetuksia niistä.

Voit siinä tapauksessa painaa Skip Import. IDEAan asetetaan erilliset asetukset myöhemmin.
Kun olet valmis ja pääset Welcome to IntelliJ IDEA -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Avaa jakelusi pääteohjelma.
Asenna IntelliJ IDEA Community Edition. Asennustapa vaihtelee jakelun mukaan:
- Arch: Asenna intellij-idea-community-edition-pakkaus AUR:sta. Voit asentaa sen käsin tai käyttämällä yay-työkalua:
```
yay -S intellij-idea-community-edition
```
- Muut jakelut: Suosittelemme asentamaan IDEA-snapin käyttäen snap-pakkaustenhallintaa:
```
snap install intellij-idea-community --classic
```
  Vaihtoehtoisesti voit asentaa IntelliJ:n käsin seuraamalla virallisia asennusohjeita
Tarkista, että IntelliJ IDEA toimii. Käynnistä JetBrains IntelliJ IDEA (joko sovellusvalikosta tai idea-komennolla).

Hyväksy mahdolliset IDEAn käyttöehdot.
Jos sinulla on muu kehitysympäristö asennettuja (JetBrains Rider tai Visual Studio Code), IntelliJ IDEA voi kysyä, haluatko tuoda (engl. import) asetuksia niistä.

Voit siinä tapauksessa painaa Skip Import. IDEAan asetetaan erilliset asetukset myöhemmin.
Kun olet valmis ja pääset Welcome to IntelliJ IDEA -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Valitse käyttöjärjestelmäsi yllä olevista vaihtoehdoista.

Java Development Kit (JDK)

Avaa IntelliJ IDEA ja odota, kunnes pääset Welcome to IntelliJ IDEA -näkymään.

Klikkaa ikkunan keskellä tai ylädassa olevaa New Project -painiketta:

Avautuneesta ikkunasta klikkaa JDK-alasvetolaatikkoa ja valitse Download JDK... -painike:

Aseta avautuneessa ikkunassa asetukset seuraavasti:

Version: 25

Vendor: Oracle OpenJDK Älä muuta Location-kohdassa olevaa polkua!

Paina lopuksi Select-painiketta.

Jätä muut projektin asetukset sellaiseksi kuin ne ovat. Paina oikeassa alalaidassa olevaa Create-painiketta ja anna projektin latautua.

Tämä avaa IntelliJ IDEA -kehitysympäristön käyttöliittymän.

JDK:n lataamisessa voi mennä aikaa. Odota rauhassa, kunnes kaikki virheet ja punaiset tekstit häviää.

Kun projekti on latautunut eikä virheitä näy, kokeile ajaa projekti painamalla oikeassa ylälaidassa olevaa Play-painiketta:
Odota, kunnes ohjelma kääntyy. Jos kaikki toimii, ikkunan alapuolelle pitäisi ilmestyä konsoli-ikkuna, jossa näet seuraavan tekstin:
Hello and welcome!
i = 1
i = 2
i = 3
i = 4
i = 5
Voit nyt sulkea IntelliJ IDEA:n.

ComTest

Avaa IntelliJ IDEA ja odota, kunnes pääset Welcome to IntelliJ IDEA -näkymään.

Jos sinulle avautui jokin vanha projekti, klikkaa yläpalkista tai hampurilaisvalikosta File > Close project. Tämä vie sinut takaisin Welcome to IntelliJ IDEA -näkymään.

Klikkaa ikkunan vasemmassa alalaidassa oleva Configure (Ratas-ikoni) > Settings.

Valitse vasemmalla puolella olevista asetusnäkymistä Plugins

Valitse Marketplace-välilehti ja hae hakusanalla ComTest

Valitse Comtest Runner -pluginin kohdalta Install

Paina Save

Sulje IntelliJ IDEA

Mitä seuraavaksi?

Onneksi olkoon! Sinulla on seuraavaksi kaikki tarvittavat kurssityökalut. Voit jatkaa tästä varsinaisiin materiaaleihin.

Keyboard shortcuts

Ohjelmointi 2

Työkaluohjeet

Valitse

Esivalmistelut

Valitse

Git

Valitse

IntelliJ IDEA

Valitse

Java Development Kit (JDK)

ComTest

Mitä seuraavaksi?