IntelliJ’n asennus

Kuten kurssimateriaalin luku 1.2 kertoo, kurssin virallinen ohjelmointiympäristö on IntelliJ IDEA (lyhyemmin vain IntelliJ) ja sen A+ Courses -lisäosa. Nuo työkalut on asennettu Aalto IT:n Linux-koneille.

Jos haluat käyttää IntelliJ’tä omalla koneellasi, sinun täytyy asentaa tuo ohjelmointiympäristö, mistä kerrotaan tällä sivulla. IntelliJ lisäosineen on tarjolla ilmaiseksi Windows-, macOS- ja Linux-käyttöjärjestelmille. Vanhat käyttöjärjestelmäversiot saattavat aiheuttaa ongelmia.

(Toinen mahdollisuus on käyttää IntelliJ’tä ja A+ Courses -lisäosaa Aallon Open OnDemand -ympäristön kautta, jolloin IntelliJ toimii selaimessa ilman asennusta. Siitä kerrotaan harmaassa laatikossa luvussa 1.2.)

Jotta voit käyttää IntelliJ IDEA -työkalustoa (lyhyemmin vain IntelliJ) ohjelmointiin omalla koneellasi, sinun täytyy asentaa se. IntelliJ lisäosineen on tarjolla ilmaiseksi Windows-, macOS- ja Linux-käyttöjärjestelmille. Vanhat käyttöjärjestelmäversiot saattavat aiheuttaa ongelmia.

Asennusohjeet löytyvät alta erikseen eri käyttöjärjestelmille:

• Windows

• macOS

• Linux

Versioilla on väliä!

Asentamiesi työkalujen tulee tukea Scala-kielen versiota 3.3.

Käytämme IntelliJ’n versiota Community Edition 2024.2.

Käytämme IntelliJ’n lisäosaa A+ Courses ja sen versiota 4.0.

Lisäksi tarvitset Java-työkaluston (JDK:n), jonka suositeltu versio on 17.

Saat käyttöösi tarvitut versiot noudattamalla tämän sivun ohjeita.

Windows

Vaihe 1/7: Asenna IntelliJ

Nouda IntelliJ IDEA Community -versio 2024.2. Siis Community Edition, ei maksullinen Ultimate Edition. Valitse Windows (exe) -asennusohjelma.

Kun olet noutanut asennusohjelman koneellesi, käynnistä se napsauttamalla kahdesti.

Oletusvastaukset asennusohjelman kysymyksiin kelpaavat, ellei sinulla ole erityistä syytä muokata niitä.

Jos jatkat saman tien seuraavaan vaiheeseen, voit lopuksi rastittaa Run IntelliJ -kohdan.

Vaihe 2/7: Käynnistä IntelliJ

Ellet jo käynnistänyt IntelliJ’tä edellisessä kohdassa, käynnistä se nyt esimerkiksi Start-valikon linkistä (tai idea64.exe-tiedostosta, joka löytyy bin-alikansiosta sen kansion sisältä, jonne IntelliJ’n asensit).

Ensimmäisellä käynnistyskerralla IntelliJ saattaa kysyä käyttötilastojen jaosta ja vanhojen asetusten palauttamisesta. Jos näin käy, voit valita Do not import settings ja painaa OK.

IntelliJ toivottaa sinut tervetulleeksi:

Vaihe 3/7: Asenna A+ Courses -lisäosa

Aallon kursseja varten on luotu lisäosa IntelliJ’hin. Tuo lisäosa, jonka nimi on A+ Courses, helpottaa merkittävästi tehtäväpakettien tuomista ohjelmointiympäristöön ja tehtävien palauttamista A+:aan suoraan IntelliJ’stä.

A+ Courses -lisäosan käyttö on erittäin suositeltavaa. Oppimateriaalissa oletetaan, että käytät sitä. (Ilmankin voi pärjätä, mutta se ei ole kätevää. Ks. vaihtoehtoiset ohjeet tämän sivun lopusta.)

Ota A+ Courses käyttöön näin:

1. Valitse IntelliJ’n tervetuloikkunan vasemmasta reunasta Plugins.

2. Esiin tulee luettelo lisäosista. Kirjoita yläreunan hakukenttään A+ Courses, niin kyseinen lisäosa ilmestyy luettelon kärkeen. Paina Install.

3. IntelliJ varoittaa, että olet asentamassa kolmannen osapuolen laatiman lisäosan. Paina Accept hyväksyäksesi.

4. Paina Restart IDE viimeistelläksesi asennuksen.

   • Mikäli tuota nappulaa ei ilmesty, sulje itse IntelliJ ja käynnistä uudelleen.

   • Saatat nähdä varoituksen keskeneräisestä "indeksoinnista", mikä ei ole vakavaa.

5. IntelliJ’n käynnistyttyä uudelleen olet taas Welcome-näkymässä.

Vaihe 4/7: Luo kurssiprojekti

IntelliJ ehdottaa, että luot tai valitset ns. projektin, jonne laatimasi ohjelmat tallennetaan. Valitse New Project.

Esiin ponnahtaa New Project -ikkuna, jonka vasemassa reunassa on luettelo erilaisia projektityyppejä. Valitse A+ Courses eli kurssiprojekti ja sitten kurssiksi O1 2024. Paina Next.

Vaihe 5/7: Kielivalinta ja JDK-ohjelmointityökalusto

Sinulla pitäisi nyt olla edessäsi uusi näkymä, jossa voit valita kielen sekä asentaa JDK:ksi kutsutun työkalupakin, jota tarvitset ohjelmoidessasi:

1. Valitse yläreunasta kieli, jota käytät kurssilla.

   • (Tuo kielivalinta vaikuttaa vain siihen, kummat kieliversiot eräistä kurssin alkupään tehtävistä palautat. Tätä suomenkielistä oppikirjaa lukevien on syytä valita Finnish. IntelliJ-ympäristö on joka tapauksessa englanniksi. Valintaa voi myös muuttaa myöhemmin.)

2. Samassa näkymässä on JDK-pudotusvalikko. Löytyykö tuosta valikosta versionumero 17?

   • Jos sattuu löytymään, valitse se.

   • Jos ei löydy, toimi alla olevien kuvien mukaisesti: Valitse pudotusvalikosta Download JDK. Valitse kentästä Version 17 ja kentästä Vendor esimerkiksi Amazon Corretto. Voit valita itse, mihin JDK ladataan; oletussijainti käy hyvin. Paina lopuksi Select, jolloin IntelliJ noutaa tuon työkalupakin.

3. Paina Next jatkaaksesi.

Vaihe 6/7: Valitse sijainti projektille

Syötä viimeisen näkymän kohtaan Project Name kurssiprojektillesi jokin kuvaava nimi (esim. o1, o1ohjelmat tai ScalainenKansio). Kirjaa Location -kohtaan sijainti kansiolle, johon haluat tuon projektin tiedostot. Ehdotettu oletussijainti kelpaa, jos et tiedä haluavasi muokata sitä. Paina Create.

Vaihe 7/7: Pääsyavain tehtävien palauttamiseen

Jotta IntelliJ voi palauttaa tehtäviä A+:n arvioitaviksi, on sille annettava lupa toimia nimissäsi A+:ssa. Lisää luvan antava "pääsyavain" (API Access Token) näin:

1. Avaa selaimessa oma profiilisivusi A+:ssa.

2. Kohdassa API Access Token / API-pääsyavain on pitkä merkkijono. Kopioi se leikepöydälle. (Pääsyavain vastaa salasanaa. Älä kerro tuota henkilökohtaista pääsykoodiasi muille.)

Palaa IntelliJ’hin ja etene seuraavasti.

1. Ikkunan oikean reunan A+ Courses -välilehdellä näet kentän, jossa lukee A+ Token. Liitä avaimesi siihen.

2. Paina Set.

3. A+ Courses -välilehden oheen ilmestyy nyt lisää välilehtiä: Assignments, Modules ja News. Tulet käyttämään niitä kurssilla usein.

macOS

Vaihe 1/7: Asenna IntelliJ

Nouda IntelliJ IDEA Community -versio 2024.2. Valitse Community Edition, ei maksullinen Ultimate Edition. Jos omistat M-sirullisen Apple-tietokoneen, valitse versioksi macOS Apple Silicon, muussa tapauksessa valitse macOS.

Itse asennus käy yksinkertaisesti purkamalla noutamasi paketti: Paketti aukeaa napauttamalla sitä hiirellä. Varsinaista asennusohjelmaa ei ole. Raahaa vain paketin sisältämä IntelliJ_IDEA_CE-niminen tiedosto sovelluskansion Applications alle.

Vaihe 2/7: Käynnistä IntelliJ

Käynnistä IntelliJ tiedostosta IntellJ_IDEA_CE.

Ensimmäisellä käynnistyskerralla IntelliJ saattaa kysyä käyttötilastojen jaosta ja vanhojen asetusten palauttamisesta. Jos näin käy, voit valita Do not import settings ja painaa OK.

IntelliJ toivottaa sinut tervetulleeksi:

Vaihe 3/7: Asenna A+ Courses -lisäosa

Aallon kursseja varten on luotu lisäosa IntelliJ’hin. Tuo lisäosa, jonka nimi on A+ Courses, helpottaa merkittävästi tehtäväpakettien tuomista ohjelmointiympäristöön ja tehtävien palauttamista A+:aan suoraan IntelliJ’stä.

A+ Courses -lisäosan käyttö on erittäin suositeltavaa. Oppimateriaalissa oletetaan, että käytät sitä. (Ilmankin voi pärjätä, mutta se ei ole kätevää. Ks. vaihtoehtoiset ohjeet tämän sivun lopusta.)

Ota A+ Courses käyttöön näin:

1. Valitse IntelliJ’n tervetuloikkunan vasemmasta reunasta Plugins.

2. Esiin tulee luettelo lisäosista. Kirjoita yläreunan hakukenttään A+ Courses, niin kyseinen lisäosa ilmestyy luettelon kärkeen. Paina Install.

3. IntelliJ varoittaa, että olet asentamassa kolmannen osapuolen laatiman lisäosan. Paina Accept hyväksyäksesi.

4. Paina Restart IDE viimeistelläksesi asennuksen.

   • Mikäli tuota nappulaa ei ilmesty, sulje itse IntelliJ ja käynnistä uudelleen.

   • Saatat nähdä varoituksen keskeneräisestä "indeksoinnista", mikä ei ole vakavaa.

5. IntelliJ’n käynnistyttyä uudelleen olet taas Welcome-näkymässä.

Vaihe 4/7: Luo kurssiprojekti

IntelliJ ehdottaa, että luot tai valitset ns. projektin, jonne laatimasi ohjelmat tallennetaan. Valitse New Project.

Esiin ponnahtaa New Project -ikkuna, jonka vasemassa reunassa on luettelo erilaisia projektityyppejä. Valitse A+ Courses eli kurssiprojekti ja sitten kurssiksi O1 2024. Paina Next.

Vaihe 5/7: Kielivalinta ja JDK-ohjelmointityökalusto

Sinulla pitäisi nyt olla edessäsi uusi näkymä, jossa voit valita kielen sekä asentaa JDK:ksi kutsutun työkalupakin, jota tarvitset ohjelmoidessasi:

1. Valitse yläreunasta kieli, jota käytät kurssilla.

   • (Tuo kielivalinta vaikuttaa vain siihen, kummat kieliversiot eräistä kurssin alkupään tehtävistä palautat. Tätä suomenkielistä oppikirjaa lukevien on syytä valita Finnish. IntelliJ-ympäristö on joka tapauksessa englanniksi. Valintaa voi myös muuttaa myöhemmin.)

2. Samassa näkymässä on JDK-pudotusvalikko. Löytyykö tuosta valikosta versionumero 17?

   • Jos sattuu löytymään, valitse se.

   • Jos ei löydy, toimi alla olevien kuvien mukaisesti: Valitse pudotusvalikosta Download JDK. Valitse kentästä Version 17 ja kentästä Vendor esimerkiksi Amazon Corretto. Voit valita itse, mihin JDK ladataan; oletussijainti käy hyvin. Paina lopuksi Select, jolloin IntelliJ noutaa tuon työkalupakin.

3. Paina Next jatkaaksesi.

Vaihe 6/7: Valitse sijainti projektille

Syötä viimeisen näkymän kohtaan Project Name kurssiprojektillesi jokin kuvaava nimi (esim. o1, o1ohjelmat tai ScalainenKansio). Kirjaa Location -kohtaan sijainti kansiolle, johon haluat tuon projektin tiedostot. Ehdotettu oletussijainti kelpaa, jos et tiedä haluavasi muokata sitä. Paina Create.

Lopuksi voit vielä kätevöittää IntelliJ’n myöhempää käyttöä kiinnittämällä sen macOS:n Dockiin, jolloin IntelliJ’n voi jatkossa käynnistää sieltä. Napsauta IntelliJ-kuvaketta Dockissa hiiren oikealla painikkeella ja valitse Options → Keep in Dock.

Vaihe 7/7: Pääsykoodi tehtävien palauttamiseen

Jotta IntelliJ voi palauttaa tehtäviä A+:n arvioitaviksi, on sille annettava lupa toimia nimissäsi A+:ssa. Lisää luvan antava "pääsyavain" (API Access Token) näin:

1. Avaa selaimessa oma profiilisivusi A+:ssa.

2. Kohdassa API Access Token / API-pääsyavain on pitkä merkkijono. Kopioi se leikepöydälle. (Pääsyavain vastaa salasanaa. Älä kerro tuota henkilökohtaista pääsykoodiasi muille.)

Palaa IntelliJ’hin ja etene seuraavasti.

1. Ikkunan oikean reunan A+ Courses -välilehdellä näet kentän, jossa lukee A+ Token. Liitä avaimesi siihen.

2. Paina Set.

3. A+ Courses -välilehden oheen ilmestyy nyt lisää välilehtiä: Assignments, Modules ja News. Tulet käyttämään niitä kurssilla usein.

Ubuntu (Debian Linux)

Vaihe 1/7: Asenna IntelliJ

Nouda IntelliJ IDEA Community -versio 2024.2. Valitse Community Edition, ei maksullinen Ultimate Edition.

Itse asennus käy yksinkertaisesti purkamalla noutamasi paketti. Paketti aukeaa napauttamalla sitä hiirellä. Pura paketin sisältö haluamaasi kansioon.

Vaihe 2/7: Käynnistä IntelliJ

Käynnistä IntelliJ tiedostosta idea.sh:

• Siirry komentorivi-ikkunassa (Terminal) kansioon, johon paketin purit.

• Käynnistä IntelliJ komennolla ./bin/idea.sh

Ensimmäisellä käynnistyskerralla IntelliJ saattaa kysyä käyttötilastojen jaosta ja vanhojen asetusten palauttamisesta. Jos näin käy, voit valita Do not import settings ja painaa OK.

IntelliJ toivottaa sinut tervetulleeksi:

Vaihe 3/7: Asenna A+ Courses -lisäosa

Aallon kursseja varten on luotu lisäosa IntelliJ’hin. Tuo lisäosa, jonka nimi on A+ Courses, helpottaa merkittävästi tehtäväpakettien tuomista ohjelmointiympäristöön ja tehtävien palauttamista A+:aan suoraan IntelliJ’stä.

A+ Courses -lisäosan käyttö on erittäin suositeltavaa. Oppimateriaalissa oletetaan, että käytät sitä. (Ilmankin voi pärjätä, mutta se ei ole kätevää. Ks. vaihtoehtoiset ohjeet tämän sivun lopusta.)

Ota A+ Courses käyttöön näin:

1. Valitse IntelliJ’n tervetuloikkunan vasemmasta reunasta Plugins.

2. Esiin tulee luettelo lisäosista. Kirjoita yläreunan hakukenttään A+ Courses, niin kyseinen lisäosa ilmestyy luettelon kärkeen. Paina Install.

3. IntelliJ varoittaa, että olet asentamassa kolmannen osapuolen laatiman lisäosan. Paina Accept hyväksyäksesi.

4. Paina Restart IDE viimeistelläksesi asennuksen.

   • Mikäli tuota nappulaa ei ilmesty, sulje itse IntelliJ ja käynnistä uudelleen.

   • Saatat nähdä varoituksen keskeneräisestä "indeksoinnista", mikä ei ole vakavaa.

5. IntelliJ’n käynnistyttyä uudelleen olet taas Welcome-näkymässä.

Vaihe 4/7: Luo kurssiprojekti

IntelliJ ehdottaa, että luot tai valitset ns. projektin, jonne laatimasi ohjelmat tallennetaan. Valitse New Project.

Esiin ponnahtaa New Project -ikkuna, jonka vasemassa reunassa on luettelo erilaisia projektityyppejä. Valitse A+ Courses eli kurssiprojekti ja sitten kurssiksi O1 2024. Paina Next.

Vaihe 5/7: Kielivalinta ja JDK-ohjelmointityökalusto

Sinulla pitäisi nyt olla edessäsi uusi näkymä, jossa voit valita kielen sekä asentaa JDK:ksi kutsutun työkalupakin, jota tarvitset ohjelmoidessasi:

1. Valitse yläreunasta kieli, jota käytät kurssilla.

   • (Tuo kielivalinta vaikuttaa vain siihen, kummat kieliversiot eräistä kurssin alkupään tehtävistä palautat. Tätä suomenkielistä oppikirjaa lukevien on syytä valita Finnish. IntelliJ-ympäristö on joka tapauksessa englanniksi. Valintaa voi myös muuttaa myöhemmin.)

2. Samassa näkymässä on JDK-pudotusvalikko. Löytyykö tuosta valikosta versionumero 17?

   • Jos sattuu löytymään, valitse se.

   • Jos ei löydy, toimi alla olevien kuvien mukaisesti: Valitse pudotusvalikosta Download JDK. Valitse kentästä Version 17 ja kentästä Vendor esimerkiksi Amazon Corretto. Voit valita itse, mihin JDK ladataan; oletussijainti käy hyvin. Paina lopuksi Select, jolloin IntelliJ noutaa tuon työkalupakin.

3. Paina Next jatkaaksesi.

Vaihe 6/7: Valitse sijainti projektille

Syötä viimeisen näkymän kohtaan Project Name kurssiprojektillesi jokin kuvaava nimi (esim. o1, o1ohjelmat tai ScalainenKansio). Kirjaa Location -kohtaan sijainti kansiolle, johon haluat tuon projektin tiedostot. Ehdotettu oletussijainti kelpaa, jos et tiedä haluavasi muokata sitä. Paina Create.

Vaihe 7/7: Pääsykoodi tehtävien palauttamiseen

Jotta IntelliJ voi palauttaa tehtäviä A+:n arvioitaviksi, on sille annettava lupa toimia nimissäsi A+:ssa. Lisää luvan antava "pääsyavain" (API Access Token) näin:

1. Avaa selaimessa oma profiilisivusi A+:ssa.

2. Kohdassa API Access Token / API-pääsyavain on pitkä merkkijono. Kopioi se leikepöydälle. (Pääsyavain vastaa salasanaa. Älä kerro tuota henkilökohtaista pääsykoodiasi muille.)

Palaa IntelliJ’hin ja etene seuraavasti.

1. Ikkunan oikean reunan A+ Courses -välilehdellä näet kentän, jossa lukee A+ Token. Liitä avaimesi siihen.

2. Paina Set.

3. A+ Courses -välilehden oheen ilmestyy nyt lisää välilehtiä: Assignments, Modules ja News. Tulet käyttämään niitä kurssilla usein.

Lisämateriaalia erikoistilanteisiin

Miksi IntelliJ pyytää A+:n pääsyavainta aina uudelleen (Aallon Linux-ympäristössä)?

IntelliJ pitää syöttämäsi pääsyavaimen (API Token) tallessa A+:aa käyttääkseen. Joskus tämä ei toimi, ja IntelliJ pyytää sinulta tuota avainta joka käyttökerralla uudestaan, mistä on pieni lisävaiva.

Jos sinulle käy näin Aallon Linux-ympäristössä, on todennäköisesti kyse siitä, että olet vaihtanut Aalto-tunnuksesi salasanan. IntelliJ hyödyntää Linuxin omaa salasanavarastoa. Tuo varaston käyttö ei kuitenkaan enää toimi, kun käyttäjän salasana vaihtuu.

Alla on kolme eri ratkaisua tähän ongelmaan. Kun teet niistä jonkin, joudut vielä syöttämään pääsyavaimen kertaalleen, mutta sitten sen pitäisi säilyä tallessa, vaikka suljet IntelliJ’n tai kirjaudut ulos tietokoneelta.

Vaihtoehto 1: Vaihda varaston salasana

Jos muistat vielä ensimmäisen Aalto-salasanasi, voit vaihtaa salasanavaraston pääsalasanan vastaamaan nykyistä Aalto-tunnuksesi salasanaa:

1. Avaa sovellusvalikko ja sieltä ohjelma Passwords and Keys.

2. Napsauta hiiren oikealla näppäimellä ikkunan vasemmasta reunasta Login ja valitse Change password.

3. Syötä vanha salasanasi ja paina Continue.

4. Syötä seuraavassa ikkunassa kahteen kertaan uusi Aalto-tunnukselle kirjautumiseen käyttämäsi salasana ja paina vielä lopuksi Continue.

Vaihtoehto 2: Alusta varasto uudelleen

Jos et muista aiempia salasanoja, voit luoda uuden login.keyring-tiedoston vanhan tilalle.

Anna nämä komennot Linuxin Terminal-ikkunassa poistaaksesi vanhan tiedoston:

• cd ~/.local/share/keyrings/

• cp login.keyring login.keyring.BACKUP

• rm login.keyring

Luo uusi login.keyring-tiedosto käyttäen salasanaa, jolla nykyään kirjaudut Aallon Linux-koneille:

1. Avaa sovellusvalikosta ohjelma Passwords and Keys.

2. Valitse File → New... → Password Keyring ja paina Continue.

3. Syötä tiedoston nimeksi login. Syötä aukeavassa salasanaikkunassa Aalto-salasanasi ja paina Continue.

Vaihtoehto 3: Varastoi pääsyavain toisin

Voit vaihtaa tapaa, jolla IntelliJ tallentaa salasanat:

1. Valitse IntelliJ’n valikosta File → Settings ja sitten sieltä Appearance & Behaviour → System Settings → Passwords.

2. Valitse asetuksen Save passwords kohdalla vaihtoehto In KeePass.

3. IntelliJ’n oletussijainti tiedostolle käynee. Paina Apply ja OK.

Mitä jos A+ Courses -lisäosa ei toimi koneellani tai en halua käyttää sitä?

Jos et käytä A+ Courses -lisäosaa, joudut näkemään ylimääräistä vaivaa kurssin tehtävien noutamisessa ja palauttamisessa sekä käyttäessäsi IntelliJ’n REPL-työkalua, jota hyödynnämme kurssilla paljon.

Suosittelemme vahvasti lisäosan käyttöä. Alla on kuitenkin vaihtoehtoisia ohjeita kurssin eri vaiheisiin.

Projektin pohjustus kurssin alussa (ilman A+ Courses -lisäosaa)

Asenna IntelliJ kuten ylempänä tällä sivulla neuvottiin, mutta ensimmäisellä käynnistyskerralla toimi toisin.

Ennen kuin luot projektin, asenna Welcome to IntelliJ IDEA -ruudussa Scala-lisäosa:

1. Valitse Configure → Plugins.

2. Jos Scalaa ei heti näy listassa, kirjoita hakukenttään Scala. Valitse Scala-lisäosa ja paina Install.

3. Scala-lisäosan asennuttua IntelliJ pitää käynnistää uudelleen. Paina Restart IDE.

Valitse New Project ja projektityypiksi vasemmanpuoleisesta listasta Scala ja aukeavasta listasta IDEA. Syötä seuraavan ikkunan kohtaan Project name jokin kuvaava nimi (esim. o1). IntelliJ ehdottaa sijainnin projektille; voit muokata sitä halutessasi.

Tuon lisäksi on valittava käytettävät Java- ja Scala-työkalustot (JDK ja Scala SDK):

1. Napsauta JDK-pudotusvalikkoa ja valitse Download JDK.

2. Valitse kentässä Vendor AdoptOpen JDK (HotSpot) ja kentässä Version 17. Voit valita itse, mihin JDK ladataan. Napsauta sitten Download, jolloin IntelliJ lataa JDK:n.

3. Paina Scala SDK -pudotusvalikon vierestä Create ja aukeavasta ikkunasta Download. Valitse versio 3.3 ja hyväksy OKlla.

4. Paina Finish. Uusi projekti aukeaa IntelliJ’ssä. IntelliJ näyttää päivän vinkin, jonka voit sulkea.

5. Valitse File → Project Structure... → Libraries, napsauta pientä plus-painiketta + ja valitse scala-sdk-3.3.3.

6. IntelliJ ilmoittaa, että tuo työkalusto lisätään luomaasi projektiin. Paina OK ja vahvista Yes.

Asetustiedostot IntelliJ’hin kurssin alussa (ilman A+ Courses -lisäosaa)

Ota ensin käyttöön kurssin projektikohtaiset asetukset näin:

1. Sulje IntelliJ.

2. Lataa projektiasetustiedosto o1_2024_project_settings.zip ja tallenna se johonkin kansioon.

3. Avaa lataamasi tiedosto. Pura paketin sisältä .idea-kansio projektikansioosi, niin että sen sisältö korvaa tulee projektikansiossa jo olevan .idea-alikansion sisältöä. (Ei siis tuon toisen .idea-kansion sisään. Älä myöskään poista vanhaa .idea-kansiota.)

   • Huomaa, että ellei käyttöjärjestelmässäsi ole päällä "Näytä piilotetut tiedostot" -tyyppinen asetus, niin pisteellä alkavat tiedostot ja kansiot kuten .idea eivät näy luetteloissa.

4. Purkaessa sinulta kysytään, haluatko korvata kansiossa jo olevia tiedostoja. Korvaa ne.

5. Käynnistä IntelliJ uudelleen.

Ota käyttöön kurssin vahvasti suosittelemat IntelliJ-yleisasetukset:

1. Lataa asetustiedosto ja tallenna se johonkin kansioon. Tarvitsemasi tiedosto riippuu käyttöjärjestelmästä:

   • Windows tai Linux: o1_2024_ij_settings.zip

   • MacOS: o1_2024_ij_mac_settings.zip

2. Valitse IntelliJ’ssä File → Manage IDE settings → Import settings.

3. Valitse aukeavassa ikkunassa juuri lataamasi asetustiedosto.

4. Varmista, että kaikki kohdat ovat valittuna ja paina OK.

5. Paina vielä lopuksi Restart.

Kurssimoduulien tuonti IntelliJ’hin (ilman A+ Courses -lisäosaa)

Kurssimateriaalin lukujen alusta löytyy linkit tehtävissä tarvittaviin koodimoduuleihin (esimerkkiohjelmiin ja ohjelmointitehtävien pohjustuksiin). Kun käytät A+ Coursesia, et tarvitse noita linkkejä, koska IntelliJ noutaa ja asentaa ne kätevästi, mutta saman voi tehdä käsityönäkin.

Seuraa linkkiä ja nouda moduulin zip-tiedosto koneellesi. Pura se aiemmin laatimaasi projektikansioon (esim. o1). Tiedostot ilmestyvät IntelliJ'ssä ikkunan vasemman reunan projektinäkymään, mutta se pitää vielä merkitä tuon projektin osamoduuliksi.

Avaa tuon uuden moduulin kansio IntelliJ’ssä. Napsauta hiiren oikealla painikkeella kansiossa olevaa .iml-päätteistä tiedostoa. Valitse Import '[Moduulin nimi]' Module.

Tehtävien palauttaminen (ilman A+ Courses -lisäosaa)

A+ Courses palauttaa ohjelmointitehtävät suoraan IntelliJ’stä, mutta voit vaihtoehtoisesti palauttaa ne web-lomakkeella. Nämä lomakkeet löytyvät kunkin tehtävän kohdalta oppimateriaalista.

Monissa selaimissa onnistuu tiedoston vetäminen ja pudottaminen suoraan IntelliJ’stä lomakkeen kenttään. Jos vetäminen ei onnistu, paina lomakkeen nappulaa etsiäksesi palautettavan tiedoston projektikansiosi sisältä.

Scala REPLin käynnistäminen tiettyyn moduuliin (ilman A+ Courses -lisäosaa)

Ilman A+ Courses -lisäosaa IntelliJ ei osaa automaattisesti käynnistää REPL-työkalua niin, että laatimasi koodi olisi helposti REPListä käytettävissä.

Ilman lisäosaa sinun on luotava uusi käynnistyskonfiguraatio, kun aloitat uuden moduulin parissa:

1. Valitse Run → Edit Configurations.

2. Paina pientä plus-symbolia + vasemmalla ylhäällä.

3. Valitse listasta Scala REPL.

4. Syötä ikkunan yläreunan Name -kenttään jokin kuvaava nimi, esimerkiksi "REPL [Moduulin nimi]".

5. Valitse Use classpath and SDK of module: -kentässä haluamasi moduuli.

6. Paina Apply ja OK.

7. Voit nyt käynnistää laatimasi REPL-konfiguraation esimerkiksi valitsemalla sen IntelliJ'n oikean yläreunan pudotusvalikosta ja painamalla sen viereistä -nappia.

A+ Courses -lisäosa osaa helpottaa REPLin käyttöä myös ottamalla automaattisesti käyttöön kurssilla usein tarvitsemiasi pakkauksia kuten pakkauksen o1. Ilman lisäosaa sinun on otettava nuokin pakkaukset REPLissä erikseen käyttöön aina tarpeen mukaan tähän tyyliin:

import o1.*import o1.goodstuff.*

Pakkauksista ja Scalan import-käskystä kertoo lisää luku 1.6.

Palaute

Voit lähettää korjaus- tai lisäysehdotuksia tai muuta palautetta tästä sivusta.

Tekijät

Tämän oppimateriaalin kehitystyössä on käytetty apuna tuhansilta opiskelijoilta kerättyä palautetta. Kiitos!

Materiaalin luvut tehtävineen ja viikkokoosteineen on laatinut Juha Sorva.

Liitesivut (sanasto, Scala-kooste, usein kysytyt kysymykset jne.) on kirjoittanut Juha Sorva sikäli kuin sivulla ei ole toisin mainittu.

Tehtävien automaattisen arvioinnin ovat toteuttaneet: (aakkosjärjestyksessä) Riku Autio, Nikolas Drosdek, Kaisa Ek, Joonatan Honkamaa, Antti Immonen, Jaakko Kantojärvi, Onni Komulainen, Niklas Kröger, Kalle Laitinen, Teemu Lehtinen, Mikael Lenander, Ilona Ma, Jaakko Nakaza, Strasdosky Otewa, Timi Seppälä, Teemu Sirkiä, Joel Toppinen, Anna Valldeoriola Cardó ja Aleksi Vartiainen.

Lukujen alkuja koristavat kuvat ja muut vastaavat kuvituskuvat on piirtänyt Christina Lassheikki.

Yksityiskohtaiset animaatiot Scala-ohjelmien suorituksen vaiheista suunnittelivat Juha Sorva ja Teemu Sirkiä. Teemu Sirkiä ja Riku Autio toteuttivat ne apunaan Teemun aiemmin rakentamat työkalut Jsvee ja Kelmu.

Muut diagrammit ja materiaaliin upotetut vuorovaikutteiset esitykset laati Juha Sorva.

O1Library-ohjelmakirjaston ovat kehittäneet Aleksi Lukkarinen, Juha Sorva ja Jaakko Nakaza. Useat sen keskeisistä osista tukeutuvat Aleksin SMCL-kirjastoon.

Tapa, jolla käytämme O1Libraryn työkaluja (kuten Pic) yksinkertaiseen graafiseen ohjelmointiin, on saanut vaikutteita tekijöiden Flatt, Felleisen, Findler ja Krishnamurthi oppikirjasta How to Design Programs sekä Stephen Blochin oppikirjasta Picturing Programs.

Oppimisalusta A+ luotiin alun perin Aallon LeTech-tutkimusryhmässä pitkälti opiskelijavoimin. Nykyään tätä avoimen lähdekoodin projektia kehittää Tietotekniikan laitoksen opetusteknologiatiimi ja tarjoaa palveluna laitoksen IT-tuki; sitä ovat kehittäneet kymmenet Aallon opiskelijat ja muut.

A+ Courses -lisäosa, joka tukee A+:aa ja O1-kurssia IntelliJ-ohjelmointiympäristössä, on toinen avoin projekti. Sen suunnitteluun ja toteutukseen on osallistunut useita opiskelijoita yhteistyössä O1-kurssin opettajien kanssa.

Kurssin tämänhetkinen henkilökunta löytyy luvusta 1.1.

Lisäkiitokset tähän lukuun

Tämän ohjesivun kirjoittivat alun perin Niklas Kröger ja Juha Sorva. Sivua ovat sittemmin päivittäneet Antti Immonen, Joel Toppinen ja muut.

Palautusta lähetetään...

×

Identtinen palautus

Tämä palautus on identtinen aikaisemman palautuksen kanssa. Oletko varma, että haluat lähettää palautuksen?

Peruuta Lähetä