Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Debuggausnäyte

Debuggauksen kuvaus ja ohjeet. Lomakkeet edelleen TIMissä.

Debuggausnäytteessä osoitat, että osaat käyttää debuggeria ongelmatilanteiden selvittämiseen. Näytteessä testataan muun muassa seuraavien osa-alueiden hallintaa:

  • askeltaminen aliohjelman sisään (step into)
  • aliohjelman suorittaminen yhtenä askeleena (step over)
  • keskeytyskohdan asettaminen
  • ehdollisen keskeytyskohdan asettaminen
  • arvon muuttaminen debuggerissa
  • muuttujan asettaminen watch-seurantaan; watch-arvon seuraaminen

Näyte arvostellaan asteikolla hyväksytty/hylätty.

Aikataulu ja takarajat

Tutkinto-opiskelijatLukiolinjatAvoin yliopisto
Näyte tulee palauttaa osan 8 takarajaan mennessä. Mahdollisista aikataulujoustoista (esim. sairauden takia) on aina sovittava ohjaajan kanssa. Palauttaminen myöhässä ilman ennalta sovittua joustoa voi johtaa näytteen hylkäämiseen.Näyte tulee palauttaa valitsemasi opintojaksototeutuksen aikataulun mukaisesti.Näytteen palauttamiselle ei ole takarajaa, mutta se on hyväksytettävä ohjaajalla.

Miksi?

Debuggerin käyttö on osa kurssin osaamistavoitteita. Ohjelman koon kasvaessa testaus- ja debuggaustaidot ovat olennainen osa virheiden etsimisessä ja korjaamisessa. Debuggeri on myös loistava työkalu ohjelman toiminnan ymmärtämiseksi.

Miten valmistaudun?

  1. Lue osa 5.1 Debuggaus
  2. Katso luennon debuggauksesta ja debuggerin käytöstä (kevät 2023)
  3. Harjoittele debuggausta Harjoitusnäytteellä

Näytteen suorittaminen

Voit suorittaa debuggausnäytteen videona itsenäisesti tai ohjauksessa. Voit suorittaa debuggausnäytteen sinulle sopivana aikana. Debuggausnäytteen suorittamiselle ei ole takarajaa.

Valitse haluamasi debuggausnäytteen suoritustapa ja seuraa sen mukaiset ohjeet.

  1. Lataa ja avaa DebugKoe-projekti
Debuggausnäyteprojektin latausohjeet

huomautus

Jos suoritat näytteen yliopiston mikroluokassa, lataa kaikki tiedostot ja projektit seuraavaan hakemistoon:

C:\MyTemp\ohj1\<käyttäjänimi>

Muualta ei voi ajaa omia ohjelmia.

  1. Lataa DebugKoe.zip
  2. Pura lataamasi zip-tiedosto paikkaan, josta löydät sen.
  3. Avaa Rider. Welcome to JetBrains Rider -näkymässä klikkaa oikeassa yläkulmassa olevaa Open -painiketta.
  4. Etsi ja avaa DebugKoe.sln-tiedosto Riderissa. Mikäli Rider kysyy, luotatko avattavaan projektiin, valitse Trust and Open.
  5. Avaa sen jälkeen Riderissa Program.cs-tiedosto, josta ohjelmakoodi löytyy.
  1. Lue alla vaatimukset ja ohjeet debuggausnäytteen tekemiselle ja palauttamiselle
Ruutukaappausvideon vaatimukset ja ohjeet

Sisällölliset vaatimukset videolle

  1. Opiskelijan tulee käyttää kurssilla annettua DebugKoe-tehtävää.
  2. Videossa tulee näkyä debuggausnäytteen suorittaminen kokonaisuudessaan ja katkeamattomana. Videoa ei saa editoida.
  3. Videolla tulee näkyä sekä ruutukaappauskuva että opiskelijan puhe selkeällä äänellä.
  4. Opiskelijan tulee selittää jokainen tekemänsä toiminto perustellen. Selitys tulee olla esimerkiksi:
    • "Asetan riville 59 ehdollisen keskeytyskohdan, koska..." tai
    • "Käytän continue-toimintoa, jotta..."

Näytteen hylkäämisen perusteet

  1. Videolla ei näy debuggausnäytteen suorittaminen kokonaisuudessaan.
  2. Tehtyjä toimia ei perustella.
  3. Opiskelija ei puhu tai puheesta ei saa selvää.
  4. Annetut perustelut ovat oleellisesti vääriä tai sisältävät selkeitä virhekäsityksiä. Näytteen toisessa osassa on kiinnitettävä erityistä huomiota siihen, mihin kohtaan ohjelman suoritus keskeytyy ja miksi.

Tekniset vaatimukset videolle

  1. Resoluution tulee olla mielellään vähintään Full HD (1920x1080). Jos näyttösi tarkkuus on hyvin korkea, pienennä sitä. Pääasia on, että tekstistä saa selvää.
  2. Äänen tulee olla selvästi kuultavissa. Käytä mielellään hyvälaatuista mikrofonia ja puhu lähelle mikrofonia.
  3. Tarkista äänentasot testinauhoituksella. Kytke tarvittaessa kohinansuodatukset tai muut automaattiset äänenparannustoiminnot pois päältä mikäli mahdollista.
  4. Valitse videon laaduksi Korkea, tai vähintään 5 Mbps, jos voit sen valita.
  5. Hyviä ohjelmia ruutukaappauksen tekemiseen ovat esimerkiksi Screen-Cast-O-Matic (Windows), Open Broadcast Software (Win/Mac/Linux) ja Quicktime (Mac).

Näytteen hylkäämisen perusteet

  1. Video on niin epäselvä ettei tekstistä saa selvää.
  2. Puheraita puuttuu tai siitä ei saa selvää.

Videon jakelun vaatimukset

Laita video YouTubeen (suositus) tai Moniviestimeen. YouTubessa voit laittaa videon Unlisted-tilaan, mutta ei Private-tilaan. Tarkista esimerkiksi selaimen Incognito-tilassa, että video on todella katsottavissa myös kirjautumattomana käyttäjänä. Emme lataa tiedostoja esim. MediaFirestä tai vastaavista tiedostonjakopalveluista.

Voit poistaa videon näytteen tarkastamisen jälkeen.

Näytteen hylkäämisen perusteet

  1. Videon URL-osoite ei ole TIMissa.
  2. Tarkastaja ei pääse käsiksi videoon.
  3. Video on jossain muualla kuin YouTubessa tai Moniviestimessä.
  1. Tee DebugKoe-projektissa olevat tehtävät ja nauhoita suorituksesi, ks. ohjeet yllä.
  • Käynnistä ladattu ohjelma Debug-tilassa ja suorita projektissa olevat tehtävät. Tehtävien ohjeet löytyvät Program.cs -tiedostosta.
  • Voit yrittää debuggausnäytteen suorittamista niin monta kertaa kuin haluat.
  1. Julkaise nauhoitteesi YouTubeen tai Moniviestimeen. Kopioi videon URL-osoite TIMin Oma eteneminen -sivun debuggausnäytteen URL-osoitteen palautuskenttään. Mikäli videosi on YouTubessa, kopioi videon URL-osoite käyttäen Share-painiketta videon alapuolella. TODO: Lisää linkki.

Debuggausnäytteet tarkistetaan noin kerran viikossa. Saat ilmoituksen, kun työsi on tarkistettu.

Vinkkejä

Muistathan debugnäytteitä tehdessäsi ajaa ohjelman debug-tilassa.

Debugatessa kannattaa pyrkiä selvittämään, mikä koodissa tai muuttujien arvoissa näyttää oudolta. Esimerkiksi, jos johonkin aliohjelmaan siirrytään useita kertoja yhden sijaan, voi kutsuja olla tullut liikaa.