Det praktiska arbetet under HT1 inleds med en labbserie som normalt utförs i par. Ni hittar laborationsinstruktionerna på kursens Wiki. Labbarna är inte ett examinationsmoment i sig själva, utan en förberedelse inför det som faktiskt examineras. Målet är att samtliga kursdeltagare ska ges en möjlighet att:

• Undersöka hur StarCraft II fungerar i praktiken.

• Lära sig arbeta med programmeringsgränssnittet till StarCraft, vilket kommer att behövas i de senare stegen.

• Få idéer och inspiration inför den individuella utredningen (examinationsmoment UPG3) och det gemensamma utvecklingsprojektet (examinationsmoment UPG4), samt en bättre förståelse för vad som faktiskt är möjligt och rimligt att genomföra inom kursen.

Ett par veckor innan slutet av HT1 börjar det bli dags att gå över till att skapa en grundläggande gemensam agent. Här är några viktiga punkter:

• Den gemensamma agenten bör vara klar innan HT2 börjar.

• Den ska vara en enkel grundagent där man senare (under HT2) integrerar AI-tekniker.

• Den kan baseras på era implementationer från labbarna eller på en nyligen implementerad "basagent" som kan ge ytterligare inspiration och hjälp, men som å andra sidan kräver att man sätter sig in i den nya koden.

Ju längre ni har kommit med detta när HT2 börjar, desto större chanser att ni kan implementera AI-teknikerna på ett bra sätt. Grupper som inte är klara med basen förrän ett par veckor in i HT2 får ofta problem att hinna implementera, testa och utvärdera ordentligt.

Under HT2 behöver alla i gruppen arbeta på bland annat följande punkter:

• Implementera den egna funktionaliteten, det egna ansvarsområdet (till exempel "byggnadsordning"). Detta behöver komma igång direkt i HT2 – man behöver lite marginaler för att t.ex. kunna ta ett avbrott i några dagar för att tänka över saker, eller för att man kanske blir sjuk ett tag.

• Samarbeta med övriga i gruppen för att fortsätta med den gemensamma funktionalitet som man upptäcker att man behöver. Mycket bör redan vara klart i och med basagenten som skrevs i HT1, men man upptäcker säkerligen några fler behov när man arbetar i HT2. Detta arbete behöver fördelas jämnt inom gruppen.

• Testa den egna funktionaliteten, men även testa att integrera flera olika funktionaliteter tillsammans. Vi ser ibland att olika gruppmedlemmar arbetar på helt egna grenar i Git och att integreringen inte sker förrän på slutet, och det kan vara ett stort misstag. Integrera så tidigt ni kan.

  Ett tips är att skapa ett antal featureflaggor där man kan slå av och på olika funktionaliteter, med "fallback" till en väldigt grundläggande funktionalitet om någon flagga är falsk. Exempel: Om FIND_SAFE_PATHS är True används någons "hitta-säker-väg-implementation". Om flaggan är False (kanske för att funktionen inte är färdig eller för att man vill testa om det är den funktionen som orsakar en bugg) anropas automatiskt en fallback som använder den inbyggda förflyttningen istället.

• Rapportera hur det går och diskutera frågor och problem (mer om det senare).

• Arbeta på projektdelen av den individuella slutrapporten när du har material, och arbeta vidare med polering av utredningsdelen när du har fått kommentarer.

Redovisning varje vecka

I princip varje vecka under HT2 har vi ett redovisningstillfälle. Vid frånvaro, se kursinfo.

På redovisningstillfällen kommer varje grupp att få 30 minuter till att diskutera nuläget med er handledare. Ni behöver då vara förberedda på att t.ex. förklara hur det har gått med basagenten och diskutera lite om hur ni tänker fortsätta ert arbete efter föregående veckan.

Presentation som slutredovisning

Vid slutredovisningarna kommer ni att ha lite mer tid att redovisa vad ni har åstadkommit under terminen. Varje grupp kommer att redovisa separat under ett eget pass, där varje individ får en viss tid tilldelad att presentera sitt eget resultat. Varje grupp kommer att vara närvarande i högst en timme.

Kodinlämning

När du lämnar in slutrapporten, som innehåller projektdelen, behöver du också "lämna in" den programkod du har skrivit. Vid behov kan granskaren titta på den för att få mer information om vad du gjorde och hur du implementerade det.

Fokus är inte på att koden ska vara snyggt skriven eller extremt väldokumenterad! Däremot behöver det finnas någon form av översiktlig kommentar om var just din kod ligger och hur den hänger ihop. Detta läggas i filen liuid123.txt eller liuid123.md i roten av filarkivet (repository), där liuid123 är ditt ID.

Inför inlämningen skapar du tillsammans med gruppen en gemensam tagg (på main-branchen) för den commit du vill "lämna in". På det sättet skyddar du dig mot eventuella ändringar gjorda av andra gruppmedlemmar senare, till exempel vid komplettering. Du kan sedan slå upp denna tagg i projektet i Gitlabs webgränssnitt. Gå till Repository / Tags i vänstermenyn, som i detta exempel:

Klicka på taggens namn (t.ex. "v32.50.0" i exempelbilden -- inte en commit-hash som "2869de24" eftersom det är själva taggen vi vill åt). Kopiera sedan den URL du får fram i webläsaren. I exemplet blir det https://gitlab.com/gitlab-org/gitlab-ui/-/tags/v32.50.0; i ditt fall blir det t.ex. https://gitlab.liu.se/tddd92-2024/tddd92-2024-projekt-sgX-XX/-/tags/taggnamn, beroende på vilken grupp du är med i och vad du kallade din tagg.

Denna URL/länk ska du ha med i din inlämningsissue när du lämnar in en individuell slutrapport!