GitHub classroom -tehtävät

Osa opintojakson tehtävänannoista löytyy GitHub-palvelusta, kukin omana repositorionaan. Kyseisissä tehtävissä hyödynnetään tehtävien automaattista tarkastusta GitHub classroom -palvelun avulla. Tehtäväkohtaiset ohjeet löydät aina kustakin repositoriosta, mutta tehtävien yhteiset ohjeet on kirjattu alle.

---

Tällä sivulla:

• Vaihe 1: Tehtävän hyväksyminen
• Vaihe 2: Kloonaa repositorio
• Vaihe 3: Tee muutoksia
• Vaihe 4: Suorita testit paikallisesti
• Vaihe 5: git status, git add ja git commit
• Vaihe 6: Päivitä muutoksesi etärepositorioon
• Vaihe 7: Tarkastele automaattisen arvioinnin tuloksia
• Vaihe 8: Tee korjauksia (tarvittaessa)
• Vaihe 9: Lähetä tehtävä

Voit soveltaa näitä ohjeita esim. VS Code -koodieditorin tai Eclipsen kanssa seuraamalla VS Code:n omia ohjeita tai lukuisia Eclipsen ohjeita.

Vaihe 1: Tehtävän hyväksyminen

1. Kirjaudu sisään GitHub-tilillesi.

2. Avaa linkki, jonka opettajasi on antanut sinulle päästäksesi tehtävään käsiksi.

3. Klikkaa “Accept” -painiketta. Tämä luo sinulle yksityisen kopion repositoriosta, jossa voit työskennellä tehtävän parissa.

Vaihe 2: Kloonaa repositorio

1. Avaa terminaali, Git Bash tai Git-työkalu tietokoneellasi.

2. Siirry hakemistoon, johon haluat tallentaa tehtäväsi. Huom: Tämän hakemisto pitää olla oman koneen paikallisella levyllä, älä kloonaa OneDriveen tai muuhun pilvipalvelujakoon, viimeisimmän versiot löytyvät aina GitHubista joten OneDriven käytöstä ei saa mitään hyötyä, mutta voi aiheuttaa käännösohgelmia.

3. Käytä seuraavaa komentoa repositorion kloonaamiseen (korvaa <repository_url> tehtävän repositorion URL-osoitteella):

   git clone <repository_url>
   

   Huom! Tehtävän kloonaamiseksi sinun tulee olla kirjautuneena GitHubiin myös Git-työkalullasi. Seuraa tarpeen mukaan työkalun ohjeita.

Vaihe 3: Tee muutoksia

1. Avaa tehtävässä annetut tiedostot valitsemassasi Java-kehitysympäristössä.

   • VS Code -koodieditorin Java-ohjeistus löytyy sivustolta Java in Visual Studio Code . Seuraa sivun ohjeita ja asenna itsellesi editorin suosittelema Java-laajennus “Language Support for Java”.

   • Eclipse -koodieditorille löytyy lukuisia epävirallisia ohjeita Java-projektin lisäämiseksi työtilaan.

     Suosittelemme, että kloonaat projektin ensin Eclipsen ulkopuolella ja lisäät kloonatun projektin Eclipseen seuraavasti: File - Import - Gradle - Existing Gradle Project. Mikäli käytät Windows-käyttöjärjestelmää, joudut mahdollisesti asettamaan Eclipsen työtilaan UTF-8-merkistökoodauksen, jotta ääkköset ja erikoismerkit toimivat oikein. Merkistökoodaus asetetaan Window-valikon Preferences-kohdasta tämän kuvan mukaisesti.

2. Kirjoita ohjelmakoodia tehtävänannon ohjeiden mukaisesti.

Vaihe 4: Suorita testit paikallisesti

1. Koodin kirjoittamisen jälkeen testaa se paikallisesti varmistaaksesi, että se toimii odotetusti. Tarkemmat ohjeet ratkaisun testaamiseksi löydät tehtävänannosta.

Vaihe 5: git status, git add ja git commit

1. Komentotulkissa, terminaalissa tai Git Bashissa siirry tehtävähakemistoon:

   cd <tehtävä_hakemisto>
   

2. Käytä seuraavia komentoja muutosten lisäämiseen ja commitointiin:

   git status     # näyttää muuttuneet tiedostot
   git add <muutettu tiedosto>
   git commit -m "Tehtävä suoritettu"
   

Vaihe 6: Päivitä muutoksesi etärepositorioon

1. Päivitä tekemäsi commit etärepositorioon GitHubissa:

   git push
   

Vaihe 7: Tarkastele automaattisen arvioinnin tuloksia

1. Odota, että automaattinen arviointiprosessi suoritetaan GitHub actions -työkalulla.

2. Tarkastele automaattisen arvioinnin tuloksia käymällä oman repositoriosi sivulla GitHubissa. Löydät automaattisten testien tuottamat tulokset ja pistemäärän “actions”-välilehden alta.

Vaihe 8: Tee korjauksia (tarvittaessa)

1. Mikäli automaattinen arviointi paljastaa ongelmia tai virheitä, palaa takaisin koodiisi, tee tarvittavat korjaukset ja toista vaiheet 4–7. Voit palauttaa tehtävät niin monta kertaa kuin on tarpeen tehtävän määräaikaan asti.

Vaihe 9: Lähetä tehtävä

1. Kun olet tyytyväinen koodiisi ja testien tuloksiin, tehtävä on suoritettu.

2. Noudata mahdollisia kurssitoteutuskohtaisia lisäohjeita, kuten repositorion linkin lisääminen Teamsiin tai Moodleen.

Tämä ohjeistus luotiin ChatGPT:n avulla.

---