**I denne oppgaven skal du lage din helt egen applikasjon!**
Du kan velge mellom **tre oppgaver**:
Du kan velge mellom **tre oppgaver** (alle gir like mange poeng):
- Du kan lage en applikasjon med utgangspunkt i [Tetris-koden](https://git.app.uib.no/ii/inf101/24v/assignments). Du har også muligheten til å bruke koden deres fra semesteroppgave 1.
- Du kan lage en applikasjon med utgangspunkt i koden for [Othello, Tic Tac Toe, Connect Four og Blob Wars](https://git.app.uib.no/ii/inf101/24v/assignments).
- Du kan ta utgangspunkt i et [tomt repo]](https://git.app.uib.no/ii/inf101/24v/assignments) og lage en applikasjon helt fra bunnen av.
- Du kan ta utgangspunkt i et [tomt repo (Empty)](https://git.app.uib.no/ii/inf101/24v/assignments) og lage en applikasjon helt fra bunnen av.
> :exclamation: Du skal jobbe ut i fra ett av de repoene du finner i `assignments`-mappen. **IKKE FORK repoet!!!!!!!!!**
> :exclamation: Du skal jobbe ut i fra ett av de repoene du finner i `assignments`-mappen. **IKKE FORK REPOET!!!!!!!!!**
### Krav
Uansett hva du velger, har vi satt opp noen krav alle må forholde seg til:
- Du skriver programmet med Java
- Du skriver programmet i Java
- Applikasjonen må være **visuell**:
- Når programmet kjøres skal en GUI (Graphical User Interface) komme opp. Det er ikke nok å kun bruke konsollen.
- Applikasjonen må være laget med Swing (altså samme rammeverk vi har benyttet så langt i kurset, balnt annet i Tetris). Du har muligheten til å bruke andre rammeverk for visning ved forespørsel og godkjenning.
- Applikasjonen må være laget med Swing (altså samme rammeverk vi har benyttet så langt i kurset, blant annet i Tetris). Du har muligheten til å bruke andre rammeverk for visning ved forespørsel og godkjenning.
- Det er tillatt med applikasjoner som hovedsakelig er algoritmiske eller utfører beregninger, men applikasjonen må likevel ha et visuelt grensesnitt mot brukeren.
- Applikasjonen må være **interaktiv**:
- En bruker skal kunne klikke med musen eller bruke tastaturet for å interagere med applikasjonen.
- Applikasjonen må ha en viss **kompleksitet**:
- Applikasjonen må ha et visst omfang. *Snake* er en applikasjon med nok funksjonalitet, mens [dette](https://www.braingle.com/games/dontclick/) er ikke nok.
- Applikasjonen må ha et visst omfang. *Snake* er en applikasjon med nok funksjonalitet, mens [dette](https://www.braingle.com/games/dontclick/) er ikke nok. Vi viser eksempler for hva som er tilstrekkelig kompleksitet senere i oppgaveteksten, på forelesningen 03.04.24 og i Discord-kanalen #ideér
- Vi forventer at applikasjonen er oppdelt i ulike klasser som representerer ulike elementer av programmet.
> :exclamation: Vi forventer at du legger ned minst 25 timer i å lage programmet, men mange vil nok oppleve at de bruker mer tid enn dette og at det kan variere fra oppgave til oppgave.
## De forskjellige oppgavene
### Tetris
Hvis du ønsker å lage en applikasjon som er basert på tastetrykk, en timer som styrer endringer i programmet og figurer som flyttes rundt i et grid, kan det være en ide å ta utgangspunkt i [Tetris](https://git.app.uib.no/ii/inf101/24v/assignments).
Hvis du ønsker å lage en applikasjon som er basert på tastetrykk, en timer som styrer endringer i programmet og figurer som flyttes rundt i et grid, kan det være en idé å ta utgangspunkt i [Tetris](https://git.app.uib.no/ii/inf101/24v/assignments).
Noen forslag til applikasjoner du kan lage er:
-[Pacman](https://freepacman.org/)
...
...
@@ -49,7 +49,7 @@ Noen forslag til applikasjoner du kan lage er:
Det vil ikke være nok å bare utvide ett av de eksisterende spillene, som for eksempel å lage Connect Five eller lignende. Applikasjonen din må være noe annet enn de fire spillene som alt er implementerte, men utover dette kan du benytte deg av så mye eller lite eksisterende kode i prosjektet ditt som du ønsker.
### Start fra scratch
Dersom applikasjonen du ønsker å lage ikke passer inn i noen av de eksisterende rammeverkene, eller du ønsker en større utfordring, kan det være en ide å ta utgangspunkt i et [tomt repo](https://git.app.uib.no/ii/inf101/24v/assignments).
Dersom applikasjonen du ønsker å lage ikke passer inn i noen av de eksisterende rammeverkene, eller du ønsker en større utfordring, kan det være en ide å ta utgangspunkt i et [tomt repo (Empty)](https://git.app.uib.no/ii/inf101/24v/assignments).
Du får utlevert et tomt prosjekt som er klart til å fylles med hva enn du måtte ønske!
...
...
@@ -61,7 +61,7 @@ Vær bevisst på at det vil være vanskeligere å få hjelp med prosjektet ditt
## Obligatorisk oppfølging
I løpet av denne oppgaven må du møte på gruppetime hver uke, hvor en av gruppelederne dine registrerer hvor langt du har kommet med prosjektet. Dette er for å forsikre at alle studenter er på rett vei, og for å forhindre at noen tar på seg for mye arbeid med prosjektet sitt.
I løpet av denne oppgaven må du møte på gruppetime i uke 15. 16 og 18/19, hvor en av gruppelederne dine registrerer hvor langt du har kommet med prosjektet. Dette er for å forsikre at alle studenter er på rett vei, og for å forhindre at noen tar på seg for mye arbeid med prosjektet sitt.
**Det er *ditt* ansvar å møte på gruppetime. Hvis du er syk skal du kontakte din gruppeleder og informere om dette. Gruppeleder vil *ikke* purre på deg. Hvis du ikke møter til gruppetime eller kommuniserer med gruppelederen din, vil dette føre til at du får stryk på oppgaven, og du mister muligheten til å ta eksamen i emnet.**
...
...
@@ -70,7 +70,7 @@ Sørg for å orientere deg om hvem din gruppeleder er og hvordan du kan kontakte
**Meld dere opp til grupper på MittUiB. Det er denne gruppen du må stille på for å få godkjent underveis og vurdering til slutt.**
### Møte 1 - Oppstart
I uke 15 (08. - 12. april) møter du til oppstartsmøte. Her må du ha de følgende punktene klart:
I uke 15 (08. - 12. april) møter du til oppstartsmøte. Her må du ha gjort de følgende punktene:
- En idé for programmet. Hva skal programmet ditt være og hvilken funksjonalitet skal det ha?
- Valg av kodebase (Tetris, Othello/BlobWars/Connect4/TicTacToe, fra scratch)
- En plan/oversikt av viktigste klassene. Skriv opp hva de viktigste klassene for programmet ditt vil være og si hvilke variabler/metoder de burde inneholde
...
...
@@ -80,7 +80,7 @@ I uke 15 (08. - 12. april) møter du til oppstartsmøte. Her må du ha de følge
**Stiller du uten å ha gjort dette arbeidet så stryker du oppgaven og dermed emnet.**
### Møte 2 - Progresjon
I uke 16 (15. - 19. april) møter du til progresjonsmøte. Her må du ha de følgende punktene klart:
I uke 16 (15. - 19. april) møter du til progresjonsmøte. Her må du ha gjort de følgende punktene:
- Et kjørbart program som viser frem deler av funksjonalitet. Du må kunne kjøre programmet slik at en GUI kommer opp. Her skal noe av den endelige funksjonaliteten vises.
- 5 tester ferdiglaget. Du må ha testet koden din så langt. Du kan ikke vise frem tester som var i repoet fra før av.
...
...
@@ -99,11 +99,20 @@ Gruppelederen kommer til å spørre deg spørsmål om koden din som du må kunne
## Poengberegning
Dere vil få tildelt poeng basert på de følgende punktene:
- Funksjonalitet (3 poeng)
- Er programmet visuellt og interaktivt?
- Har du tilstrekkelig kompleksitet? Fungerer ting som de skal?
- OOP-konsepter (3 poeng)
- Benytter du deg av de konseptene vi har lært i emnet? Objekter, grensesnitt, enkapsulering, ploymorfisme, iterator, generics, etc.
- Kodestil (3 poeng)
- Er koden din lett og lese? Har du fornuftige hjelpemetoder?
- Dokumentasjon (3 poeng)
- Har du gode variabelnavn og javadocs som dokumenterer public og protected metoder?
- Testing (3 poeng)
- Tester du public/protected metoder? Tester du for hjørnetilfeller?
- Video (1 poeng)
- Lag en video hvor du filmer skjermen og viser frem funksjonaliteten av applikasjonen din. Last opp på Youtube (privat om du ønsker) og legg til en lenke til videoen i README.md.
## Hva er "tilstrekkelig kompleksitet"?
Eksempler på programmer som er innenfor kravet til kompleksitet når de kommer i sin enkleste form:
...
...
@@ -112,6 +121,8 @@ Eksempler på programmer som er innenfor kravet til kompleksitet når de kommer
*[Tron Light Cycles](https://www.classicfreearcade.com/flash-game/21670/tron-game.html) for to spillere (se også [video](https://www.youtube.com/watch?v=1zv333wxZFU) av orginalen fra 1982).
* Pong med poeng og to spillere
Du finner flere eksempler i forelesningen 03.04.24 og på Discord-kanalen #ideér.
Eksempler på programmer som er *utenfor* kravet til kompleksitet når de kommer i sin aller enkleste form:
* Sprettende ball i vinduet som kan flyttes med museklikk eller piltaster.
...
...
@@ -120,18 +131,20 @@ Eksempler på programmer som er *utenfor* kravet til kompleksitet når de kommer
Med andre ord, applikasjonen må være noe mer enn bare et enkelt eksempel på en funksjonalitet -- det må ha en *helhet*, en *historie*, eller en *rikhet* ved seg.
Hvis du er usikker, ta en prat med din gruppeleder.
Hvis du er usikker, ta en prat med din gruppeleder eller spør på Discord-kanalen #ideér.
## Arbeid i par
<!-- Kopiert fra i fjor men modifisert til å omhandle gruppetime og ikke møte med gruppeleder. Gjelder de samme reglene fortsatt? -->
<!-- I utgangspunktet er oppgaven individuell, men dersom dere er to personer med sterkt ønske å samarbeide som et par, tillater vi dette. Du bør i så fall samarbeide men en partner du kan jobbe med slik at begge parter har faglig utbytte av samarbeidet uten at utviklingen av applikasjonen blir skjevfordelt. Rammene for et slikt samarbeid:
I utgangspunktet er oppgaven individuell, men dersom dere er to personer med sterkt ønske å samarbeide som et par, tillater vi dette. Du bør i så fall samarbeide men en partner du kan jobbe med slik at begge parter har faglig utbytte av samarbeidet uten at utviklingen av applikasjonen blir skjevfordelt. Rammene for et slikt samarbeid:
* Dere må begge gå på samme gruppetime og møter gruppeleder sammen.
* Dere må begge skrive all koden selv (altså i to kopier, én kopi hver) uten å kopiere maskinelt mellom kodene.
* Dere må levere inn koden individuelt.
* Vurdering av oppgaven gjøres individuelt.
**Du må kunne forklare alt av koden ved vurdering. Hvis du da har bare kopiert fra noen andre og ikke skjønner hvordan koden fungerer så vil du ikke motta noen poeng.**
Det er ikke tillatt å samarbeide i større grupper.
Dersom dere ønsker å arbeide i par, gi beskjed om dette til deres gruppeledere, så vil dere bli flyttet til samme gruppe dersom dere ikke allerede er det. -->
Dersom dere ønsker å arbeide i par, gi beskjed om dette til deres gruppeledere, så vil dere bli flyttet til samme gruppe dersom dere ikke allerede er det.
**Øvrig samarbeid**
...
...
@@ -143,10 +156,22 @@ Det er alltid tillatt å be om hjelp av og gi hjelp til noen som ikke lager det
* Dersom du har kopiert en metode, skriv en kommentar om opphavet i begynnelsen av metoden.
* Dersom du har kopiert en hel klasse, skriv øverst i filen hvor klassen kommer fra.
Når dere siterer, skriv hvor dere har koden fra, hvem som er opphaver og når koden ble hentet. F.eks.:
**Du kan benytte kode du ikke har skrevet selv så mye du ønsker.** Den delen av koden som er kopiert vil imidlertid ikke inngå som en del av vurderingsgrunnlaget med mindre den er vesentlig omarbeidet for å passe med sin nye kontekst.
Begge overnevnte punkter gjelder også kode som er skrevet ved å følge detaljerte tutorials.
Du har lov til å bruke kode fra laboppgavene og semesteroppgaven. Kode som du selv har skrevet her trenger du ikke å sitere, men om du bruker noe av den utleverte koden uten vesentlige endringer så må du sitere.
**Benytt gjerne kunstig intelligens.** AI-verktøy som CoPilot, Ghostwriter og ChatGPT er tillatt. Dersom du kopierer et større avsnitt eller en klasse fra ChatGPT, skriv en kommentar om dette.
