Ohjelmointi 1 -kurssin työkalut

Harjoitustehtävien ja harjoitustyön tekemiseen käytämme seuraavia työkaluja:

.NET - ohjelmistoviitekehys (engl. framework) sekä ajonaikainen ympäristö (engl. runtime) C kielelle. .NET mahdollistaa C ohjelmien kääntämisen ja ajamisen. Se tarjoaa myös valmista koodia yleisempiin käyttötarkoituksiin (esim. tekstin tulostaminen näytölle, käyttöliittymien tekeminen).
Git - versiohallintaohjelma (engl. Version Control Software, VCS), joka mahdollistaa koodin versioinnin ja yhteistyön koodaajien välillä. Vähän kuin Google Docsin muokkaushistoria, mutta koodaamiseen tarkoitettu.
JetBrains Rider - integroitu kehitysympäristö (engl. Integrated Development Environment, IDE). IDE sisältää oleellisimmat toiminnot ohjelmien tekemiseen (koodin muokkaus, kääntäminen, ajaminen). Rider on erityisesti .NET ja C ohjelmille tarkoitettu IDE.
Tekstieditori - jokin kevyt tekstieditori, jolla tekstipohjaisia tiedostoja (esim. koodi) voi muokata avaamatta IDE-ohjelmistoa. Suosittelemme esimerkiksi Visual Studio Code tai Notepad++. Microsoft Word tai Google Docs ei ole opintojaksolle soveltuva tekstieditori.
JyPeli - pelimoottori (engl. game engine), joka on Jyväskylän yliopistossa kehitetty C kirjasto pelien tekemiseen.
ComTest - yksikkötestigeneraattori (engl. unit test generator), joka on aputyökalu, jonka avulla kirjoitetulle koodille voi kirjoittaa testejä helposti luettavalla merkintätavalla.

Tässä dokumentissa käydään läpi yllä olevien työkalujen ja ohjelmien asentamista.

Yllä olevat ohjelmat ovat valmiiksi asennettuna Agoran mikroluokissa. Suosittelemme, että asennat ohjelmat lisäksi niille tietokoneille, joilla aiot suorittaa opintojakson. Erityisesti harjoitustyön tekeminen pääteohjausten ulkopuolella on helpompaa, kun kaikki tarvittavat ohjelmat on myös omalla tietokoneella.

Ennen asentamista

Käyttöjärjestelmä ja vaatimukset

Tällä sivulla olevat ohjeet riippuvat käyttöjärjestelmästä. Valitse käyttöjärjestelmä alta.

Valitsit Microsfot Windows -käyttöjärjestelmän. Alla olevat ohjeet on testattu seuraavilla käyttöjärjestelmillä:

Windows 11
Windows 10

Valitsit Linux-käyttöjärjestelmän. Alla olevat ohjeet on testattu seuraavilla käyttöjärjestelmillä:

Arch Linux (6.16.1-arch1-1)
Linux Mint 22.1 (Linux 6.8.0-51-generic)
Linux Ubuntu 24.04.3 LTS
Debian 13

Valitse käyttöjärjestelmäsi yllä olevilla painikkeilla.

Huomaa, että muilla käyttöjärjestelmillä voi esiintyä pieniä poikkeuksia. Mikäli ohjeet eivät toimi, ilmoita siitä opettajille: ohj1-opet@tim.jyu.fi. Vastaavasti, jos saat ohjeet toimimaan käyttöjärjestelmällä, jotka eivät ole yllä mainitussa listassa, kerro käyttöjärjestelmäsi, niin päivitämme listan.

Pikakurssi komentorivin käyttöön

Tämän sivun asennusohjeet vaativat komentorivin avaamista ja käyttöä.

Opintojaksolla komentorivin käyttöä käsitellään tarkemmin opintojakson aikana; jos luet nämä ohjeet aivan opintojakson alussa, komentorivi saattaa kuulostaa vielä hämärältä asialta.

Jos et ikinä ennen käyttänyt komentoriviä, katso pikainen johdatus komentorivin käyttöön alta.

Pikainen johdatus komentorivin käyttöön (Avaa klikkaamalla)

Mikä on komentorivi?

Komentorivi (engl. command line) tai pääte (engl. terminal) on (tämän ohjeen puitteissa) tietokoneohjelma, jolla tietokonetta voi ohjata tekstillä. Esimerkiksi, kun Windowsissa jonkun kansion sisällön katsominen onnistuu graafisesti avaamalla Resurssinhallinta (tai macOS:lla vastaavasti Finder), sama asia onnistuu komentorivillä kirjoittamalla komento (engl. command), joka tulostaa näkyviin kansion sisällön.

Komentorivillä työskentely on yleistä ohjelmoinnin yhteydessä. Syitä on monia, eikä niitä tässä käsitellä. Tämän ohjeen kannalta olennainen syy on, että yleisten ohjelmien asentaminen onnistuu nykyään jopa helpommin komentorivillä kuin "käsin" etismällä sopiva asennusohjelma verkosta.

Miten avaan komentoriviin omalla tietokoneellani?

Toimintatapa vaihtelee eri käyttöjärjestelmillä. Samalla käyttöjärjestelmällä voi olla myös useita komentoriviohjelmia. Alla olevilla ohjeilla saata ainakin kaikki tarvittavat työkalut asennettua.

Paina Käynnistä-painikkeen vieressä olevaa Haku-ikonia
Kirjoita hakupalkkiin PowerShell
Valitse löytyvistä tuloksista Windows PowerShell

Tämä avaa PowerShell-komentorivin, joka on eräs Windowsilla oleva komentorivipääte.

Miten käytän komentoriviä?

Kun näet tällä sivulla alla olevan tapaisen laatikon:

ls

Tulee sinun kirjoittaa laatikossa oleva komento ja suorittaa se komentorivillä. Toimi seuraavasti:

Klikkaa komentorivi aktiiviseksi ikkunaksi ellei se ole jo.
Kirjoita laatikossa oleva komento komentoriviin näppäimistöllä.
Tarkista, että kirjoitit komennon täysin oikein. Huomaa, että kirjainkoolla, välilyönneillä ja muilla merkeillä on merkitystä komennon kannalta!
Kun olet varmistanut, että kirjoitit komennon oikein, paina Enter-näppäintä.

Riippuen komennosta komentoriviin voi ilmestyä tuloste, virhe tai ei mitään. Jotkin ohjelmat eivät tulosta mitään tekstiä onnistumisen merkiksi. Kun komennon suoritus on valmis, komentorivin uudelle riville ilmestyy uusi komentokehote.

Kokeile kirjoittaa ja suorittaa yllä oleva esimerkkikomento. Komento listaa hakemistossa olevien tiedostojen ja kansioiden nimiä (ls on lyhenne sanalle "list").

Kun tällä sivulla näet laatikon, jossa on useita rivejä, kuten

echo "Kissa"

ls

Toimi seuraavasti:

Tee yllä mainitut vaiheet 1-4 vain ensimmäisellä rivillä olevalle komennolle (eli tässä echo "Kissa")
Tee yllä mainitut vaiheet 1-4 vain toisella rivillä olevalle komennolle (eli ls)
Jatka rivien suorittamista kunnes olet suorittanut kaikki laatikossa olevat rivit

Toisin sanoen, tällä sivulla jokainen yksittäinen komento on aseteltu omalle rivilleen. Tarkoitus on, että suoritat jokaisen rivin yksi kerrallaan siinä järjestyksessä, jossa ne on laatikossa kirjoitettu.

Kokeile kirjoittaa ja suorittaa yllä olevassa laatikossa olevat komennot. Kirjoita ja suorita ensin komento echo "Kissa" ja sen jälkeen komento ls. Muista, että tietokone suorittaa komennon vasta, kun painat Enter-painiketta.

Voinko kopioida komentoja kirjoittamisen sijaan?

Kyllä voit. Tällä ohjesivulla komentojen kopiointi onnistuu klikkaamalla kopioitavasta komennosta kerran ja painamalla Ctrl+C (Windows, Linux) tai Command+C (macOS).

Komennon liittäminen komentoriville riippuu käyttöjärjestelmästä:

Windows: Valitse PowerShell-komentorivi aktiiviseksi ja paina Ctrl+V (tai klikkaa hiiren oikea painike)
macOS: Valitse Pääte aktiiviseksi ja paina Command+V
Linux: Valitse komentorivi aktiiviseksi ja paina Ctrl+Shift+V TAI Shift+Insert. Tarkista pääteohjelmasi ohjeista oikea näppäinoikotie

varoitus

Älä ikinä kopioi ja liitä komentoriville mitään komentoja, joihin et luota etkä tiedä, mitä ne oikeasti tekevät. Komentorivien komennot ovat usein peruuttamattomia: jos vahingossa poistat jonkun tiedoston, poisto on usein lopullinen eikä sitä voi peruuttaa. Esimerkiksi tekoälyn ehdottamiin komentoihin tulee suhtautua aina varauksella. Tällä sivulla mainitut komennot on testattu toimivaksi ja turvalliseksi vastuuopettajan toimesta.

Asennusohjeet tekstinä

Valmistelu

Varmista, että tietokoneesi on ajan tasalla (Windows Update:ssa ei uusia päivityksiä) tai että näytönohjaimen ajurit ovat asennettu.
Avaa PowerShell-komentorivi (Haku-ikoni → Kirjoita PowerShell → Windows PowerShell).
Kokeile, että winget-komento on asennettu ja toimii. Suorita 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. Kokeile siinä tapauksessa seuraavat ratkaisut:
- Tarkista, että käyttöjärjestelmäsi on ajan tasalla
- Kokeile ladata ja asentaa winget-käsin: Lataa asennusohjelma Asennuksen jälkeen sulje ja käynnistä PowerShell uudelleen.

Avaa Pääte tai Termimal (Launchpad → Pääte/Terminal)
Asenna ensin macOS:n kehitystyökalut suorittamalla alla oleva komento:
```
xcode-select --install
```
Komennon suorittamisen jälkeen saatat 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 sellainen 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.
Suorita seuraavat komennot (huom: 1 komento per rivi, 4 komentoa yhteensä):
```
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)"
```
Nämä komennot tekevät seuraavat asiat:
- Komento 1 tarkistaa, onko tietokone Apple Silicon tai Intel -pohjainen.
- Komento 2 lisää tyhjän rivin komentoriviasetuksiin
- Komento 3 muokkaa komentorivin asetuksia niin, että jatkossa Homebrew ladataan aina avatessa uusi Pääte
- Komento 4 lataa Homebrewin nykyiseen komentoriviin
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.

Alla olevat ohjeet olettavat, että sinulla on kokemusta ohjelmien asentamisesta sinun käyttämälläsi Linux-jakelulla. Linux-ohjeet toimivat täten ohjenuorana; käytä tarvittaessa omaa harkintaa.

Tarkista, että sinulla on tarvittavat grafiikkakirjastot asennettuna. JyPeli ainakin tarvitsee GLFW-kirjaston, joka löytyy eri jakeluista valmiina pakkauksena:
- Ubuntu, Debian, openSUSE: libglfw3
- Arch, Fedora: glfw
Vaikka osa työkaluista löytyy jakelujen pakkaustehallinnasta, jotkin graafiset ohjelmat (erityisesti Rider ja VS Code) eivät ole yleensä julkaistu jakelukohtaisissa repoissa. Suosittelemme käyttämään jakelusta riippumatonta pakkaustenhallintaa, kuten Snap tai Flatpak. Tällä sivulla olevat ohjeet käyttävät ensisijaisesti Snapia tai jakelukohtaisia pakkauksia, jos niitä on.
Kun olet asentanut tarvittavat esipakkaukset, käynnistä uusi tyhjä pääte.

.NET

Avaa PowerShell-komentorivi ellei se ole jo
Suorita alla oleva komento
```
winget install -e --id=Microsoft.DotNet.SDK.%%dotnet_major_version%%
```
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ä .NET on asennettu suorittamalla komento:
```
dotnet --list-sdks
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
%%dotnet_major_version%%.0.XXX [C:\Program Files\dotnet\sdk]
```
Huomaa, että XXX on joku numero; olennaista, että versiona lukee %%dotnet_major_version%%.0 ja että virhettä ei tule.

Avaa Pääte ellei se ole jo
Asenna .NET suorittamalla alla olevat komennot (huom: yhteensä 2 komentoa):
```
brew tap isen-ng/dotnet-sdk-versions
```
```
brew install --cask dotnet-sdk%%dotnet_major_version%%
```
Anna asennuksen suoriutua loppuun asti. Sinulta saatetaan pyytää macOS-käyttäjän salasanaa Password:-kentässä. Kirjoita silloin salasana paikalle ja paina Enter-näppäintä. (Mikäli vastaan tulee tilanne että edelliset komennot menevät läpi mutta dotnet ei kuitenkaan ole asentunut, voit seurata Microsoftin asennusohjeita)
Sulje kaikki auki olevat komentorivit ja avaa uusi Pääte
Testaa, että .NET on asennettu suorittamalla komento:
```
dotnet --list-sdks
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
%%dotnet_major_version%%.0.XXX [/usr/local/share/dotnet/sdk]
```
Huomaa, että XXX on joku numero; olennaista, että versiona lukee %%dotnet_major_version%%.0 ja että virhettä ei tule.

Avaa jakelusi pääteohjelma ellei se ole jo
Asenna .NET SDK -pakkaus: dotnet-sdk-%%dotnet_major_version%%.0. Pakkauksen nimi on yleensä sama kaikissa yleisillä jakeluissa (Ubuntu, Debian, Fedora, Arch, jne.)
Asennuksen jälkeen sulje ja avaa pääte uudelleen
Testaa, että .NET on asennettu suorittamalla komento:
```
dotnet --list-sdks
```
Jos asennus onnistui, näet seuraavanlaisen tulosteen:
```
%%dotnet_major_version%%.0.XXX [/usr/local/share/dotnet/sdk]
```
Huomaa, että XXX on joku numero; olennaista, että versiona lukee %%dotnet_major_version%%.0 ja että virhettä ei tule.

Git

Avaa PowerShell-komentorivi ellei se ole jo
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:

Avaa Pääte ellei se ole jo
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.

Avaa jakelusi pääteohjelma ellei se ole jo
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.

JetBrains Rider

Avaa PowerShell-komentorivi ellei se ole jo
Asenna JetBrains Rider suorittamalla alla oleva komento:
```
winget install --interactive -e --id=JetBrains.Rider
```
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"
- Install JetBrains ETW Host Service
- Add Rider executables to Microsoft Defender exclusions
- Create Associations: .sln, .cs, .csproj Etene asennusohjelmassa ja anna ohjelman asentua.
Kun pääset asennusohjelman loppuun, valitse Run JetBrains Rider ja paina Finish. Testaa, että ohjelma toimii.

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

Hyväksy mahdolliset Riderin käyttöehdot.
Kun JetBrains Rider kysyy lisenssiä, valitse Free Non-Commercial License.
Valitse Register-linkki ja rekisteröidy JetBrains-käyttäjäksi. Valitse Continue with email ja tee itsellesi tunnus.
Kun olet rekisteröitynyt, avaa Rider ja valitse Log in for Non-Commercial License.

Kun olet kirjautunut, hyväksy vielä lisenssin ehdot ja valitse Start Non-Commercial license.
Suorita asetusten asettaminen loppuun. Suositellut asetukset:
- Teema: Valitse haluamasi teema
- Näppäimistöasettelu: Suosittelemme vaihtoehdot Visual Studio tai VS Code
- Pluginit: valitse Continue without Plugins
Kun olet valmis ja pääset Welcome to JetBrains Rider -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Avaa Pääte ellei se ole jo
Asenna JetBrains Rider suorittamalla alla oleva komento:
```
brew install --cask rider
```
Anna asennuksen suoriutua loppuun asti. Sinulta saatetaan pyytää macOS-käyttäjän salasanaa Password:-kentässä. Kirjoita silloin salasana paikalle ja paina Enter-näppäintä.
Tarkista, että Rider toimii. Avaa Launchpad ja käynnistä sieltä Rider.

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

Hyväksy mahdolliset Riderin käyttöehdot.
Kun JetBrains Rider kysyy lisenssiä, valitse Free Non-Commercial License.
Valitse Register-linkki ja rekisteröidy JetBrains-käyttäjäksi. Valitse Continue with email ja tee itsellesi tunnus.
Kun olet rekisteröitynyt, avaa Rider ja valitse Log in for Non-Commercial License.

Kun olet kirjautunut, hyväksy vielä lisenssin ehdot ja valitse Start Non-Commercial license.
Suorita asetusten asettaminen loppuun. Suositellut asetukset:
- Teema: Valitse haluamasi teema
- Näppäimistöasettelu: Suosittelemme vaihtoehdot Visual Studio tai VS Code
- Pluginit: valitse Continue without Plugins
Kun olet valmis ja pääset Welcome to JetBrains Rider -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Avaa jakelusi pääteohjelma ellei se ole jo
Asenna Rider. Asennustapa vaihtelee jakelun mukaan:
- Arch: Asenna rider-pakkaus AUR:sta. Voit asentaa sen käsin tai käyttämällä yay-työkalua:
```
yay -S rider
```
- Muut jakelut: Suosittelemme asentamaan Rider-snapin käyttäen snap-pakkaustenhallintaa:
```
snap install rider --classic
```
  Vaihtoehtoisesti voit asentaa Riderin käsin seuraamalla virallisia asennusohjeita
Tarkista, että Rider toimii. Käynnistä JetBrains Rider (joko sovellusvalikosta tai rider-komennolla). Ensimmäisellä kerralla käynnistys saattaa kestää, sillä järjestelmä tarkistaa sovelluksen. Järjestelmä saattaa myös kysyä, Rider on internetsitä ladattu appi. Avataanko se?. Siinä tapauksessa voi valita Avaa.

Hyväksy mahdolliset Riderin käyttöehdot.
Kun JetBrains Rider kysyy lisenssiä, valitse Free Non-Commercial License.
Valitse Register-linkki ja rekisteröidy JetBrains-käyttäjäksi. Valitse Continue with email ja tee itsellesi tunnus.
Kun olet rekisteröitynyt, avaa Rider ja valitse Log in for Non-Commercial License.

Kun olet kirjautunut, hyväksy vielä lisenssin ehdot ja valitse Start Non-Commercial license.
Suorita asetusten asettaminen loppuun. Suositellut asetukset:
- Teema: Valitse haluamasi teema
- Näppäimistöasettelu: Suosittelemme vaihtoehdot Visual Studio tai VS Code
- Pluginit: valitse Continue without Plugins
Kun olet valmis ja pääset Welcome to JetBrains Rider -ikkunaan, voit sulkea sen. Ohjelman asennus on valmis!

Tekstieditori

Tälle opintojaksolle riittää mikä tahansa tekstieditori, joka ei ole toimistosovellus, eli ei Google Docs, Microsoft Word, tai muu asiakirjojen laadintaan tarkoitettu sovlelus. Vaihtoehtoja on monta. Ihmisillä on hyvin erilaisia preferenssejä tekstieditorien suhteen, joten kannattaa kokeilla erilaisia vaihtoehtoja ja valita itselle mieluisin.

Koska jokin tekstieditori täytyy valita, käytämme tässä ohjeessa Visual Studio Codea (VS Code). Se on suosittu, ilmainen, ja monipuolinen tekstieditori, jota voi laajentaa monin tavoin, jopa IDE-tasoiseksi työkaluksi lisäosien avulla. Jos haluat käyttää jotain muuta tekstieditoria, voit toki tehdä niin, mutta ohjeet on kirjoitettu VS Coden käyttöä ajatellen.

Avaa PowerShell-komentorivi ellei se ole jo
Asenna VS Code suorittamalla seuraava komento:
```
winget install -e --id=Microsoft.VisualStudioCode --override '/SILENT /mergetasks="!runcode,addcontextmenufiles,addcontextmenufolders"'
```
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
Kokeile käynnistää VS Code suorittamalla komento:
```
code
```
Jos VS Code avautuu, olet onnistuneesti asentanut sen! Jatkossa pääset VS Codeen myös klikkaamalla käynnistä-palkin Hae-ikonia → Kirjoita Visual Studio Code → Valitse Visual Studio Code.

Avaa Pääte ellei se ole jo
Asenna VS Code suorittamalla alla oleva komento:
```
brew install --cask visual-studio-code
```
Anna asennuksen suoriutua loppuun asti. Sinulta saatetaan pyytää macOS-käyttäjän salasanaa Password:-kentässä. Kirjoita silloin salasana paikalle ja paina Enter-näppäintä.
Tarkista, että VS Code toimii. Avaa Launchpad ja käynnistä sieltä Visual Studio Code.

Jos VS Code avautuu, olet onnistuneesti asentanut sen!

Avaa jakelusi pääteohjelma ellei se ole jo
Asenna Visual Studio Code. Asennustapa vaihtelee jakelun mukaan:
- Arch: Asenna visual-studio-code-bin-pakkaus AUR:sta. Voit asentaa sen käsin tai käyttämällä yay-työkalua:
```
yay -S visual-studio-code-bin
```
- Muut jakelut: Suosittelemme asentamaan code-snapin käyttäen snap-työkalua:
```
snap install code --classic
```
  Vaihtoehtoisesti voit asentaa VS Coden käsin seuraamalla virallisia asennusohjeita
Tarkista, että VS Code toimii. Käynnistä VS Code joko sovellusvalikosta tai code-komennolla. Jos VS Code avautuu, olet onnistuneesti asentanut sen!

JyPeli

Avaa käyttöjärjestelmäsi komentorivi (PowerShell, Pääte tai vastaava).
Asenna JyPeli-projektipohjat (engl. templates) suorittamalla alla oleva komento:
```
dotnet new install Jypeli.Templates
```
Kun asennus on valmis, näet jotakin tekstiä mallia:
```
Success: Jypeli.Templates installed the following templates:
```
Kokeile, että JyPeli toimii luomalla tasohyppelypeliprojekti ja suorittamalla se. Suorita alla olevat komennot (huom: yhteensä neljä komentoa):
```
cd ~
```
```
dotnet new Tasohyppelypeli -o TasohyppelypeliTesti
```
```
cd TasohyppelypeliTesti
```
```
dotnet run
```
Erityisesti viimeisen komennon suorittaminen voi hieman kestää. Komennot tekevät seuraavat asiat:
- Komento 1 muuttaa aktiivisen hakemiston kotihakemistoksi
- Komento 2 tekee uuden C#-projektin, jonka pohja otetaan JyPeli tasohyppelypeliesimerkistä
- Komento 3 siirtää komentorivin projektikansion sisälle
- Komento 4 kääntää ja käynnistää pelin. Tuloksena pitäisi avautua pelattava tasohyppelypeli.
Voit kokeilla peliä tai sulkea sen.

ComTest

ComTest on Riderin lisäosa, jonka avulla tällä opintojaksolla kirjoitetaan yksikkötestejä.

Avaa JetBrains Rider ja odota, kunnes pääset Welcome to JetBrains Rider -näkymään
Klikkaa ikkunan vasemmassa alalaidassa oleva Configure → Plugins
Valitse Marketplace-välilehti ja hae hakusanalla ComTest
Valitse Comtest Runner -pluginin kohdalta Install
Paina Save
Sulje JetBrains Rider

Mitä seuraavaksi?

Onneksi olkoon! Asennettujen työkalujen käyttöä käydään läpi luennoilla sekä materiaalin luvussa 1.2 Ohjelmointiympäristö kuntoon. TODO: Lisää linkki.

Jos olet tutkinto-opiskelija, sinulla on oikeus hankkia JetBrains Student Pack, joka sisältää käyttöoikeuden kaikkiin JetBrains IDE-ohjelmiin. Tällä opintojaksolla Riderin Non-commercial license -lisenssi riittää, mutta erityisesti ohjelmoinnista kiinnostuneelle Student Packista voi olla hyötyä myöhemmissä opinnoissa.

Ongelmatilanteita ja niiden ratkaisuja

Alla on lueteltu joitain yleisimpiä ongelmatilanteita, joita asennuksen tai työkalujen käytön yhteydessä voi tulla vastaan. Jos löydät ongelman, jota ei ole listattu alla,

TODO: Lisää linkit.

tule pääteohjauksiin (ajat ja paikat löytyvät kotisivulta),
laita viestiä Teamsissa (Kysymyksiä ja apua -kanava) tai
laita viestiä opettajille: ohj1-opet@tim.jyu.fi.

Silk.NET.Core.Loader.SymbolLoadingException' occurred in Silk.NET.Core.dll: 'Native symbol not found (Symbol: glfwWindowHintString)

Yllä olevan virheviestin syynä on todennäköisimmin että sinulla ei ole GLFW asennettuna, tai se on liian vanha. Monen Linux-distron mukana tulee versio 3.2, mutta Jypeli vaatii vähintään version 3.3.

Asenna uusin GLFW-versio käyttämäsi paketinhallinnan avulla.

System.PlatformNotSupportedException: GLFW is not supported on this platform...

Voi olla että tietokoneellasi ei ole näytönohjaimen ajureita asennettuna. Mene Windowsin asetukset -> Päivitykset -> Valinnaiset (päivitä-nappulan alapuolella) -> Ajurit. Asenna sieltä jotenkin näyttöön liittyvä ajuri, esimerkiksi "Intel Display Driver"

Jos ajuria ei löydy ja käytät kannettavaa, todennäköisesti sinulla on integroitu näytöonohjain, jolloin ajuri voi löytyä prosessorin valmistajan (Intel tai AMD) sivulta. Hae ajurit Googlesta esimerkiksi hakusanalla Intel graphics driver tai AMD graphics driver prosessorin valmistajasta riippuen.

Seuraavista työkaluista voi olla hyötyä:

Intel: Driver support & Assistant tool
AMD: Auto detect and install drivers

Rider pyytää asentamaan .NETia vaikka olen asentanut sen jo

Voi olla, että Rider ei löydä oikeaa .NET-versiota.

Kokeile seuraavaa:

Avaa Rider aloitusnäkymä (jos Rider on auki, laita se kiinni ja avaa uudelleen).
Avaa asetukset menemällä Configure (vasemmassa alalaidassa) → Settings
Mene kohtaan Build, Execution, Deployment → Toolset and Build
Klikkaa kohdan .NET CLI executable path -kentän alasvetovalikkoa:

Jos alasvetovalikon listassa näkyy useampi vaihtoehto, kokeile valita jotain toista vaihtoehtoa kuin nykyinen arvo. Paina lopuksi Save ja kokeile luoda uusi solution. Jos virhe toistuu, kokeile jotain toista valintaa.

Rider on hidas tai antaa erilaisia oikeusvirheitä

Erityisesti Windows-laitteilla Rider tai C#-ohjelmien ajaminen voi olla hidasta haittaohjelmien torjuntaohjelman erityisen tiukkojen tarkistusääntöjen vuoksi.

Mikäli sinulla on käytössä Microsoft Defender, Rider yleensä kysyy, haluatko Riderin säätävän sen asetukset automaattisesti. Muiden tuotteiden tapauksessa asetukset tulee säätää itse.

Katso Riderin viralliset toimintaohjeet haittaohjelmien torjuntaohjelmien säätämiseksi.

Rider-lisenssin uudelleenaktivointi

Lisenssi täytyy mahdollisesti aika ajoin uudelleenaktivoida kohdasta Help -> Manage licenses -> Activate.

dotnet not found / command not found: dotnet

Katso .NET-asennusohjeet Työkalut-ohjeesta.

A fatal error occurred. The folder [/usr/share/dotnet/host/fxr] does not exist

Jos komentoriviltä tulee (Linux):

A fatal error occurred. The folder [/usr/share/dotnet/host/fxr] does not exist

niin ks: https://stackoverflow.com/questions/73753672/a-fatal-error-occurred-the-folder-usr-share-dotnet-host-fxr-does-not-exist

Näppäinkomennot eivät toimi

Jotkin editorin näppäinoikotiet ei toimi sellaisenaan muilla kuin Yhdysvaltalaisilla näppäimistöillä. On siis tarpeen valita toimimattomille suosikkikomennoillesi uudet näppäinoikotiet asetuksista: File → Settings → Keymap → Editor actions.

Keyboard shortcuts

Ohjelmointi 1

Windows

Windows

Windows

Windows

Windows

Windows

Windows