Ensimmäisen tietokoneohjelma, kääntäminen komentoriviltä

Tässä tehtävässä oletetaan että olet asentanut kurssin työkaluista ainakin tekstieditorin ja Riderin (tai Visual Studion).

1. Mikä ihmeen komentorivi?

Ennen tämän ohjeen lukemista, tutustu komentorivin perusteisiin.

Tässä harjoituksessa käytetään komentorivistä esimerkkinä Git Bash -sovellusta. macOS:lla voit käyttää järjestelmän omaa Pääte/Terminal-ohjelmaa.

Mikäli haluat tutustua saman asian tekemiseen Windowsin CMD Promtilla tai PowerShellillä, katso syksyn 2020 materiaalia.

# hello

2. Kansion luonti demotehtäviä varten

Luo aluksi kansio kooditiedostoja varten komentoriviä käyttäen.

Avaa komentorivi (Windowsilla Git Bash, macOS:lla Pääte/Terminal).

Windowsissa kansion polku johon tiedostot tulevat voi olla esimerkiksi C:\kurssit\ohj1\demot\demo1. macOS:ssa ja Linuxissa kansio kannattaa tehdä oman kotihakemiston alaisuuteen. macOS:ssa ja Linuxissa käyttäjän oman kotihakemiston tunnus on ~/, joka lyhenne kotihakemistolle, esim /users/vesal

Alla olevissa komennoissa käytetään yllä mainittua macOS:n polkua esimerkkinä, sovella tilannetta omaan järjestelmääsi.

Alla olevat komennot annetaan komentorivillä.

cd ~/
mkdir -p kurssit/ohj1/demot/demo1
cd kurssit/ohj1/demot/demo1

Eli mitä tehtiin?

  1. vaihdettiin aktiivinen kansio omaan kotihakemistoon
  2. luodaan uusi hakemisto (mkdir, make directory) kokopolku kerralla (-p eli path) ja sitten annetaan koko hakemistopolku joka halutaan luoda. Tätä ei tarvitse enää luoda toista kertaa vaikka sulkisit komentoikkunan.
  3. vaihdetaan hakemistoon (cd, change directory)

Tee demotehtävät tähän juuri luomaasi hakemistoon. Jos joudut käynnistämään komentorivin uudelleen, pitää viimeinen kohta (cd-alkuinen komento) tehdä uuudelleen.

Pro tip: Nuoli ylös -painikkeella saat komentorivillä aina edellisen komennon.

3. Ohjelman luominen, kääntäminen ja ajaminen dotnetillä:

Luodaan seuraavaksi ensimmäinen ohjelma.

Oletetaan että olet tehnyt edellisessä vaiheessa luodun kansiorakenteen ja siirtynyt kansioon kurssit/ohj1/demot/demo1 (tai johonkin vastaavaan tekemääsi kansioon).

Anna seuraavat komennot komentorivillä.

Asenna tarvittavat projektimallit.

dotnet new --install Jypeli.Templates

Kun projektimallit on asennettu, niitä ei tarvitse enää uudelleen asentaa vaikka sulkisitkin komentorivin.

Luo HelloWorld projekti

dotnet new ConsoleMain -n HelloWorld

Jos tämä oleva komento ei jostain syystä toimi niin kokeile

~/.dotnet/dotnet new ConsoleMain -n HelloWorld

Vaihda syntyneen projektin hakemistoon

cd HelloWorld

Katso mitä tiedostoja syntyi:

ls -la

Käynnistä nyt asentamasi editori, ja muokkaa tiedoston HelloWorld.cs sisältämää koodia. Laita Main funktion sisään (eli siellä olevien aaltosulkujen {} väliseen alueeseen) esimerkiksi

System.Console.WriteLine("Hello World!");

Tallenna tiedosto muokkaustesi jälkeen.

Käännä ja aja ohjelma komennolla

dotnet run

Jälleen korvaa tarvittaessa dotnet komennolla ~/.dotnet/dotnet

Jos sait virheilmoituksen, tekemissäsi muokkauksissa on jokin virhe.

Huomioi, että komento dotnet run on annettava samasta kansiosta jossa sijaitsee .csproj loppuinen tiedosto (esimerkissä tiedosto on HelloWorld.csproj).

Lisätietoa kiinnostuneille: Komento dotnet run tekee paitsi kääntää mutta myös automaattisesti liittää tarvittavat kirjastot projektiin (vertaa syksyn2020 ohjeisiin kääntää Jypeli ohjelma komentoriviltä käyttäen csc:tä).

These are the current permissions for this document; please modify if needed. You can always modify these permissions from the manage page.