Hausaufgabe: Unterschied zwischen den Versionen

Aus Das Sopra Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
(15 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{TOCRight}}
{{TOCRight}}
{{BA|LeonH|Sollte nicht Punkt 3 vor Punkt 2 passieren?}}


== Einleitung ==
== Einleitung ==
Zu Beginn des Softwarepraktikums soll sich jeder Teilnehmer mit [[CSharp|C#]], [[MonoGame]] und den dazugehörigen Werkzeugen vertraut machen. Ein guter Startpunkt dafür ist die [[Tutorials|Tutorial-Seite]]. Außerdem soll der erste Anstoß zum selbständigen Recherchieren der benötigten Quellen für das Softwarepraktikum gegeben werden. Aus diesem Grund müssen '''von jedem Teilnehmer''' in der ersten Woche (siehe [[Roadmap]]) verbindliche Hausaufgaben gemacht werden. Diese bestehen aus 5 Aufgaben.
Zu Beginn des Softwarepraktikums soll sich jeder Teilnehmer mit [[CSharp|C#]], [[MonoGame]] und den dazugehörigen Werkzeugen vertraut machen.  
Dazu werden Sie im Laufe dieser Hausaufgabe die Werkzeuge installieren, und damit ein kleines [[MonoGame]]-Programm schrieben.
Die Hausaufgabe muss '''von jedem Teilnehmer''' in der ersten Woche (siehe [[Roadmap]]) verbindliche gemacht werden. <br>
Bitte beachten Sie:


* '''Lesen Sie den Text jeder Aufgabe vollständig durch, bevor Sie mit der Bearbeitung beginnen.'''
* '''Lesen Sie den Text jeder Aufgabe vollständig durch, bevor Sie mit der Bearbeitung beginnen.'''
* '''Bearbeiten Sie die Aufgaben der Reihe nach.'''
* '''Bearbeiten Sie die Aufgaben der Reihe nach''', da diese aufeinander aufbauen.
* '''Beginnen sie nicht erst, wenn die Gruppeneinteilung online ist!''' (Aufgabe 1 lässt sich bereits ohne Gruppeneinteilung erledigen)
* '''Beginnen sie nicht erst, wenn die Gruppeneinteilung online ist!''' (Aufgabe 1 lässt sich bereits ohne Gruppeneinteilung erledigen und kann, falls Probleme auftreten viel Zeit in anspruch nehmen)


== Aufgabe 1: Setup ==  
== Aufgabe 1: Setup ==  
Zeile 14: Zeile 15:


=== Arbeitsumgebung ===
=== Arbeitsumgebung ===
Folgen Sie dem Artikel [[Arbeitsumgebung einrichten]] entsprechend Ihrem Betriebssystem um eine von uns supportete Entwicklungsumgebung einzurichten.
Im Fogenden sollen Sie ihre Arbeitsumgebung einrichten. Sie können im Sopra beliebige andere Werkezeuge verwenden, müssen aber sicherstellen, dass diese mit den hier vogestellten Werkzeugen kompatibel sind.


Falls Sie andere Tools verwenden möchten, müssen Sie sicherstellen, dass Ihr Projekt zu der hier vorgestellten Methode kompatibel ist.
* Folgen Sie dem Artikel [[Arbeitsumgebung einrichten]] entsprechend Ihrem Betriebssystem um ihre Entwicklungsumgebung einzurichten.
* Folgen Sie dem Artikel [[Virtuelles Treffen#Funktionstest von Sound und Video|Virtuelles Treffen]] um auszuprobieren, ob sie ohne technische Probleme an einem Gruppentreffen teilnehmen können.


=== Dienste ===
=== Dienste ===
Um auf die Dienste zugreifen zu können, brauchen Sie einen gültigen Poolaccount.


Die folgenden Dienste sollten Sie eingerichtet und getestet haben:  
Die folgenden Dienste sollten Sie eingerichtet und getestet haben:  
* Zugang zum [[Gitea]] ihrer Gruppe auf [https://sopragit.informatik.uni-freiburg.de Sopra Git].
* Zugang zum [[Gitea]] ihrer Gruppe auf [https://sopragit.informatik.uni-freiburg.de Sopra Git].
* [[GIT#Git für das SOPRA vorbereiten|Einrichten des Git Repository]].
* Die Gruppenmailingliste.
* Die Gruppenmailingliste.


Zeile 47: Zeile 47:
=== User Stories für Aufgabe 3 erstellen ===
=== User Stories für Aufgabe 3 erstellen ===
{{RefImg|Firstusrstry.png|500px|3|Eine User Story anlegen.}}
{{RefImg|Firstusrstry.png|500px|3|Eine User Story anlegen.}}
Prüfen Sie ob für die Hausaufgabe bereits alle Userstories existieren. Wenn nicht, legen Sie diese an.  
Prüfen Sie ob für die Hausaufgabe bereits alle Items existieren. Wenn nicht, legen Sie diese an.  
* Klicken Sie auf den Reiter <code>Issues</code>.
* Klicken Sie auf den Reiter <code>Issues</code>.
* Prüfen Sie ob bereits eine User Story mit dem Titel <code>Student <NAME> soll Scrum, Gitea und Git verstehen</code> und Label <code>User Story</code> existiert (siehe Abb. 3).
* Prüfen Sie ob bereits ein Item mit dem Titel <code>Student <NAME> soll Scrum, Gitea und Git verstehen</code> existiert (siehe Abb. 3).
** Wenn nicht legen Sie eine entsprechende Userstory an indem Sie den weiteren Punkten folgen:  
** Wenn nicht legen Sie eine entsprechende Userstory an indem Sie den weiteren Punkten folgen:  
*# Klicken Sie <code>Neuer Issue</code>.
*# Klicken Sie <code>Neuer Issue</code>.
*# Tragen sie als Titel <code>Student <NAME> soll Scrum, Gitea und Git verstehen</code> ein.
*# Tragen sie als Titel <code>Student <NAME> soll Scrum, Gitea und Git verstehen</code> ein.
*# Tragen sie im Textfeld darunter die User Story <code>Student <NAME> soll Scrum, Gitea und Git verstehen um effizient arbeiten zu können.</code> ein.
*# Tragen sie im Textfeld darunter die ausführliche Beschreibung <code>Student <NAME> soll Scrum, Gitea und Git verstehen um effizient arbeiten zu können.</code> ein.
*# Weisen Sie die Label <code>user story</code> und hohe Priorität über das Label <code>high</code> zu , indem Sie auf das Zahnrad neben dem Schrifzug ''Label'' drücken und die entsprechenden Label auswählen.
*# Weisen Sie dem Item eine hohe Priorität über das Label <code>high</code> zu, indem Sie auf das Zahnrad neben dem Schrifzug ''Label'' drücken und die entsprechenden Label auswählen.
*# Weisen Sie dem Sprint (Meilenstein) ''Hausaufgabe'' zu.
*# Weisen Sie dem Sprint (Meilenstein) ''Sprint 00 (Hausaufgabe)'' zu.
*# Drücken sie auf <code>Issue Erstellen</code>.
*# Drücken sie auf <code>Issue Erstellen</code>.


Bitte beachten Sie in dieser, und in folgenden Aufgaben, den Platzhalter <code><NAME></code> geeignet (z.B.: mit ihrem Usernamen, oder Vornamen) zu ersetzen.
Bitte beachten Sie in dieser, und in folgenden Aufgaben, den Platzhalter <code><NAME></code> geeignet (z.B.: mit ihrem Usernamen, oder Vornamen) zu ersetzen.


=== User Story für Aufgabe 4 erstellen ===
=== Items für Aufgabe 4 erstellen ===


Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, eine User Stories für Aufgabe 4
Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, eine Item für Aufgabe 4
* Titel <code>Student <NAME> soll die Clean Code Development Texte lesen</code> mit User Story <code>Student <NAME> soll die Clean Code Development Texte lesen, um besseren Code schreiben zu können.</code>
* Titel <code>Student <NAME> soll die Clean Code Development Texte lesen</code> mit Beschreibung <code>Student <NAME> soll die Clean Code Development Texte lesen, um besseren Code schreiben zu können.</code>
* Titel <code>Student <NAME> soll den Usability Artikel lesen</code> mit User Story <code>Student <NAME> soll den Usability Artikel lesen, um von vornherein Usabilityprobleme zu vermeiden.</code>
* Titel <code>Student <NAME> soll den Usability Artikel lesen</code> mit Beschreibung <code>Student <NAME> soll den Usability Artikel lesen, um von vornherein Usabilityprobleme zu vermeiden.</code>
* Titel <code>Student <NAME> soll die Dokumentation Texte lesen</code> mit User Story <code>Student <NAME> soll die Dokumentation Texte lesen, um seinen Code sinvoll dokumentieren zu können.</code>
* Titel <code>Student <NAME> soll die Dokumentation Texte lesen</code> mit Beschreibung <code>Student <NAME> soll die Dokumentation Texte lesen, um seinen Code sinvoll dokumentieren zu können.</code>


=== User Story für Aufgabe 5 erstellen ===
=== Items für Aufgabe 5 erstellen ===
Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, eine User Story für Aufgabe 5
Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, ein Item für Aufgabe 5
* Titel <code>Student <NAME> soll ein MonoGame Programm schreiben</code> mit User Story <code>Student <NAME> soll das in Aufgabe 5 beschriebene Programm schreiben, um seine Entwicklungswerkzeuge zu testen.</code>
* Titel <code>Student <NAME> soll ein MonoGame Programm schreiben</code> mit Beschreibung <code>Student <NAME> soll das in Aufgabe 5 beschriebene Programm schreiben, um seine Entwicklungswerkzeuge zu testen.</code>


=== Tasks akzeptieren ===
=== Items akzeptieren ===
{{RefImg|gitea_hausaufgabe_tasks_assigned.png|500px|4|User Stories für die Hausaufgabe, vom Studenten akzeptiert und mit Zeitschätzung.}}
{{RefImg|gitea_hausaufgabe_tasks_assigned.png|500px|4|Items für die Hausaufgabe, vom Studenten akzeptiert und mit Zeitschätzung.}}
Bevor Sie mit den Aufgaben beginnen, sollten Sie sich die entsprechendn User Stories zuweisen (siehe Abb. 4).
Bevor Sie mit den Aufgaben beginnen, sollten Sie sich die entsprechenden Items zuweisen (siehe Abb. 4).
* Wählen Sie eine ihrer Stories aus dem Sprintbacklog (<code>Issues -> Milestones -> Hausaufgabe</code>) aus, indem Sie auf den Titel des Tasks klicken.
* Wählen Sie eines ihrer Items aus dem Sprintbacklog (<code>Issues -> Milestones -> Hausaufgabe</code>) aus, indem Sie auf den Titel des Tickets klicken.
* Geben sie eine Abschätzung wie lange es dauern wird die Story nach der Definition of Done umzusetzten. Weisen Sie das Label <code>est: 1</code> um die Abschätzung zu geben, dass eine Stunde Arbeit benötigt wird um die User Story umzusetzten. Wenn sie vermuten, dass Sie mehr als eine Stunde benötigen, wählen Sie einen entsprechend höheren Wert aus.  
* Geben sie eine Abschätzung wie lange es dauern wird das Item nach der Definition of Done umzusetzten. Weisen Sie das Label <code>est: 1</code> um die Abschätzung zu geben, dass es insgesamt eine Stunde Arbeit benötigt wird. Wenn sie vermuten, dass Sie mehr als eine Stunde benötigen, wählen Sie einen entsprechend höheren Wert aus.  
* Weisen Sie sich dem Task zu, indem Sie auf das Zahnrad neben dem Schriftzug ''Zuständig'' klicken, und ihren Benutzernamen auswählen.  
* Weisen Sie sich dem Item zu, indem Sie auf das Zahnrad neben dem Schriftzug ''Zuständig'' klicken, und ihren Benutzernamen auswählen.  
Aktzeptieren Sie so alle Tasks die sie in den vorhergehenden Aufgaben erstellt haben. Akzeptieren Sie auch den Task zur Aufgabe 5 falls dieser schon existierte.
Aktzeptieren Sie so alle Tasks die sie in den vorhergehenden Aufgaben erstellt haben. Akzeptieren Sie auch das Item zu Aufgabe 5 falls dieses schon existierte.


Es ist nicht nötig einen Kommentar zu schreiben, alle Änderungen an Labels und zugewiesenen Personen werden sofort übernommen und in der Historie der User Story eingetragen.
Beachten Sie, dass es nicht nötig für jede Änderung einen Kommentar zu schreiben. Alle Änderungen an Labels und zugewiesenen Personen werden sofort übernommen und in der Historie des Tickets eingetragen.


=== Überprüfen der Tasks ===
=== Überprüfen der Items ===


Bevor Sie mit der Arbeit zu beginnen, prüfen Sie noch einmal ob alle Userstories im Sprintbacklog vorhanden sind.
Bevor Sie mit der Arbeit zu beginnen, prüfen Sie noch einmal ob alle Items für Ihre Aufgaben im Sprintbacklog vorhanden sind.
* Klicken sie auf den Reiter <code>Issues -> Meilensteine -> Hausaufgabe</code>
* Klicken sie auf den Reiter <code>Issues -> Meilensteine -> Hausaufgabe</code>
* Schränken Sie die Anzeige auf ihnen zugewiesene Stories ein, indem sie unter <code>Label ⯆</code> <code>User Story</code> wählen, und unter <code>Zuständig ⯆</code> ihren Usernamen. Prüfen Sie ob alle Stories vorhanden sind.
* Schränken Sie die Anzeige auf die Ihnen zugewiesenen Items ein, indem sie unter <code>Zuständig ⯆</code> ihren Usernamen wählen. Prüfen Sie ob alle Items vorhanden sind.
* Erstellen Sie eventuell nicht vorhandene Userstories und Tasks wie in den vorhergehenden Aufgaben beschrieben.
* Erstellen Sie eventuell nicht vorhandene Userstories und Tasks wie in den vorhergehenden Aufgaben beschrieben.


Zeile 93: Zeile 93:
* Lesen Sie außerdem den Wikipedia-Artikel zu [http://de.wikipedia.org/wiki/User_Story User Stories].
* Lesen Sie außerdem den Wikipedia-Artikel zu [http://de.wikipedia.org/wiki/User_Story User Stories].
* Machen Sie sich mit den anderen Funktionen von [[Gitea]] vertraut und lesen Sie den Artikel [[Scrum und Gitea]]
* Machen Sie sich mit den anderen Funktionen von [[Gitea]] vertraut und lesen Sie den Artikel [[Scrum und Gitea]]
* Sollte es Fragen zum Vorgehen (Scrum und Gitea) geben, schreiben Sie diese als Kommentar in ihre User Story, damit eventuelle Fragen schnell geklärt werden können (Kommentarfeld unter <code>Issues -> Meilensteine -> Hausaufgabe -> Student <NAME> soll Scrum, Gitea und Git verstehen</code>).
* Sollte es Fragen zum Vorgehen (Scrum und Gitea) geben, schreiben Sie diese als Kommentar in ihr Item in Gitea, damit eventuelle Fragen schnell geklärt werden können (Kommentarfeld unter <code>Issues -> Meilensteine -> Hausaufgabe -> Student <NAME> soll Scrum, Gitea und Git verstehen</code>).
* Lesen sie die Artikel [[GIT|Git]] und [[GitWorkflow| Git Workflow]]
* Lesen sie die Artikel [[GIT|Git]] und [[GitWorkflow| Git Workflow]]
** [[Git#Repository clonen|Klonen]] sie das Gruppenrepository.
**[[Git#Repository clonen|Klonen]] sie das Gruppenrepository.
** Schreiben Sie Ihren Namen in die dafür vorgesehene Zeile in <code>README.md</code>. Verwenden Sie hierfür '''nicht''' den Editor in Gitea, sondern editieren sie die Datei in ihrem lokalen Git-Repository. Falls es bereits einen Termin für das Gruppentreffen gibt, tragen Sie diesen auch ein.
** Öffnen Sie dort die Datei <code>README.md</code> und fügen Sie ihren Namen an der dafür vorgesehenen Stelle hinzu. Verwenden Sie hierfür '''nicht''' den Editor in Gitea.
** [[Git#Änderungen an einer Datei| Committen]] sie ihre Änderungen: Benutzen sie die Commitnachricht <code>Added name to README.md (closes #<ticketnummer>)</code> um den entsprechenden Task in Gitea [[Git#Git und Gitea | per Commitnachricht zu schließen]].
** [[Git#Änderungen an einer Datei| Committen]] sie ihre Änderungen: Benutzen sie die Commitnachricht <code>Added name to README.md (closes #<ticketnummer>)</code> um das entsprechende Item in Gitea [[Git#Git und Gitea | per Commitnachricht zu schließen]].
** [[Git#Änderungen in das remote Repository laden (pushen)| Synchronisieren]] sie ihre Änderungen mit dem Server. Beachten halten Sie sich dabei an [[GitWorkflow#Tägliche Arbeit Synchronisieren| den vorgeschlagenen Git-Workflow]]. Es it gut möglich, dass dabei Konflikte entstehen, beachten sie hierzu [[Git#Konflikte lösen| die Anleitung zum Konflikte lösen in Git]].
** [[Git#Änderungen in das remote Repository laden (pushen)| Synchronisieren]] sie ihre Änderungen mit dem Server. Halten Sie sich dabei and [[GitWorkflow#Tägliche Arbeit Synchronisieren| den empfohlenen Git-Workflow]]. Es it gut möglich, dass dabei Konflikte entstehen, beachten sie hierzu [[Git#Konflikte lösen| die Anleitung zum Konflikte lösen in Git]], und lösen Sie die entstehenden Konflikte sinvoll auf.
* Sollte es noch keine <code>.gitignore</code>-Datei in Ihrem Repository geben, erstellen Sie in ihrem Repository eine entsprechende Datei ([[Git#Dateien Ignorieren]]), sodass temporäre Dateien von Visual Stuidio und Verzeichnisse für den Compileroutput von Git ignoriert werden. Comitten Sie diese Datei und pushen Sie diese ebenfalls. Eine gute Vorlage finden Sie unter [https://github.com/github/gitignore/blob/master/VisualStudio.gitignore Github].
* Sollte es noch keine <code>.gitignore</code>-Datei in Ihrem Repository geben, erstellen Sie in ihrem Repository eine entsprechende Datei ([[Git#Dateien Ignorieren]]), sodass temporäre Dateien von Visual Stuidio und Verzeichnisse für den Compileroutput von Git ignoriert werden. Comitten Sie diese Datei und pushen Sie diese ebenfalls. Eine gute Vorlage finden Sie unter [https://github.com/github/gitignore/blob/master/VisualStudio.gitignore Github].


Zeile 106: Zeile 106:
Lesen Sie sich die folgenden Artikel durch, und kommentieren Sie ihr entsprechendes Ticket:
Lesen Sie sich die folgenden Artikel durch, und kommentieren Sie ihr entsprechendes Ticket:
* Lesen Sie [[CleanCode|Clean Code Development]]  
* Lesen Sie [[CleanCode|Clean Code Development]]  
** Beschreiben Sie in einem Kommentar zum entsprechenden Task ein Cleancodeprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.
** Beschreiben Sie in einem Kommentar zum entsprechenden Item ein Cleancodeprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.
* Lesen Sie [[Dokumentation]]
* Lesen Sie [[Dokumentation]]
* Lesen Sie [[UsabilityForGames|Usability-Prinzipien beim Spieldesign]]  
* Lesen Sie [[UsabilityForGames|Usability-Prinzipien beim Spieldesign]]  
** Beschreiben Sie in einem Kommentar zum entsprechenden Task ein Usabilityprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.
** Beschreiben Sie in einem Kommentar zum entsprechenden Item ein Usabilityprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.


=== User Stories bearbeiten ===
=== Items bearbeiten ===
Bearbeiten sie die Aufgaben und tragen Sie entsprechende Zeiten in die User Stories ein (im Menü rechts, ''Time Tracker -> Add Time''). Besonders bei Programmieraufgaben ist dies sinnvoll, da so eine Historie der Bearbeitung und der verbrauchten Zeit erstellt wird. Dies hilft nicht nur Ihnen bei der Planung weiterer Aufgaben und Abschätzung der dafür benötigten Zeit, sondern dient auch als Nachweis für Ihre kontinuierliche Mitarbeit (siehe [[Formalien]]).
Bearbeiten sie die Aufgaben und tragen Sie entsprechende Zeiten in die Items in Gitea ein (im Menü rechts, ''Time Tracker -> Add Time''). Besonders bei Programmieraufgaben ist dies sinnvoll, da so eine Historie der Bearbeitung und der verbrauchten Zeit erstellt wird. Dies hilft nicht nur Ihnen bei der Planung weiterer Aufgaben und Abschätzung der dafür benötigten Zeit, sondern dient auch als Nachweis für Ihre kontinuierliche Mitarbeit (siehe [[Formalien]]).


'''Achtung''': Sie können die Summe der einmal eingetragenen Zeit nachträglich nur nach oben verändern.
'''Achtung''': Sie können die Summe der einmal eingetragenen Zeit nachträglich nur nach oben verändern.


=== User Stories schließen ===
=== Items schließen ===
Wenn Sie mit einer Aufgabe fertig sind, sollten Sie Ihren entsprechenden User Stories schließen. Gehen Sie ähnlich wie beim Akzeptieren einer Story vor und drücken Sie auf den Button ''Schließen''. Beachten Sie bei Aufgaben die sie mit einem Commmit abschließen, dass Sie die User Story auch über die [[Git#Git und Gitea | per Commitnachricht schließen können]].
Wenn Sie mit einer Aufgabe fertig sind, sollten Sie Ihren entsprechenden Items schließen. Gehen Sie ähnlich wie beim Akzeptieren einer Story vor und drücken Sie auf den Button ''Schließen''. Beachten Sie bei Aufgaben die zu denen Sie etwas comitten, dass Sie das Item auch über die [[Git#Git und Gitea |Commitnachricht schließen können]].


Vergessen Sie nicht die Zeit, die Sie für den Task benötigt haben, einzutragen (falls Sie das noch nicht gemacht haben).
Vergessen Sie nicht die Zeit, die Sie für den Task benötigt haben, einzutragen (falls Sie das noch nicht gemacht haben).
Zeile 123: Zeile 123:
== Aufgabe 5: Programm schreiben ==  
== Aufgabe 5: Programm schreiben ==  
[[Datei:homework_final.jpg|thumb|right|Abbildung 5: Das fertige Programm könnte so aussehen.]]
[[Datei:homework_final.jpg|thumb|right|Abbildung 5: Das fertige Programm könnte so aussehen.]]
Bevor Sie mit dieser Aufgabe beginnen, sollten Sie Ihren entsprechenden User Story akzeptieren.
Erstellen Sie ein [[MonoGame]] Programm, welches die folgenden Eigenschaften erfüllt:  
 
{{BA|LeonH| vielleicht noch andeuten, dass die Maus entprellt werden soll? das hat mich damals einen punkt gekostet}}
 
Erstellen Sie ein [[MonoGame]] Programm, welches die folgenden Eigenschaften erfüllt:
=== Funktionale Anforderungen ===
=== Funktionale Anforderungen ===
[[Datei:unilogo.png|right|thumb|Abbildung 6: Das Uni-Logo]]
[[Datei:unilogo.png|right|thumb|Abbildung 6: Das Uni-Logo]]
Zeile 158: Zeile 154:
=== Ressourcen ===
=== Ressourcen ===
Damit das Erstellen von Grafiken ignoriert werden kann, gibt es hier die beiden Beispieldateien aus der Einführungsveranstaltung:
Damit das Erstellen von Grafiken ignoriert werden kann, gibt es hier die beiden Beispieldateien aus der Einführungsveranstaltung:
* [[:Media:unilogo.png|Das Uni-Logo]]
* [[Medium:Unilogo.png|Das Uni-Logo]]
* [[:Media:background.png|Hintergrundgrafik]]
* [[Medium:Background.png|Hintergrundgrafik]]


Als Audiodateien können beliebige, kurze, Dateien verwendet werden. Die beiden aus der Einführungsveranstaltung bekannten Waves gibt es hier:
Als Audiodateien können beliebige, kurze, Dateien verwendet werden. Die beiden aus der Einführungsveranstaltung bekannten Waves gibt es hier:
* [[Datei:logo_hit.wav|Das Logo wird getroffen]]  
* [[Datei:logo_hit.wav|Das Logo wird getroffen]]
* [[Datei:logo_miss.wav|Das Logo wird nicht getroffen]]
* [[Datei:logo_miss.wav|Das Logo wird nicht getroffen]]


Zeile 169: Zeile 165:


== Abgabe Finalisieren ==
== Abgabe Finalisieren ==
{{RefImg|gitea_mergehomework.png|300px|8|Einen Pullrequest erstellen.}}
 
Wenn Sie in Ihrer Gruppe die Aufgaben als letztes abschließen (d.h. Sie die letzte offene User Story im Sprint schließen) erledigen Sie noch folgende Aufgabe. In den auf die Hausaufgabe folgenden Sprints erledigt dies der Product Owner.
Wenn Sie in Ihrer Gruppe die Aufgaben als letztes abschließen (d.h. Sie die letzte offene User Story im Sprint schließen) erledigen Sie noch folgende Aufgabe. In den auf die Hausaufgabe folgenden Sprints erledigt dies der Product Owner.



Version vom 23. Oktober 2020, 12:03 Uhr

Einleitung

Zu Beginn des Softwarepraktikums soll sich jeder Teilnehmer mit C#, MonoGame und den dazugehörigen Werkzeugen vertraut machen. Dazu werden Sie im Laufe dieser Hausaufgabe die Werkzeuge installieren, und damit ein kleines MonoGame-Programm schrieben. Die Hausaufgabe muss von jedem Teilnehmer in der ersten Woche (siehe Roadmap) verbindliche gemacht werden.
Bitte beachten Sie:

  • Lesen Sie den Text jeder Aufgabe vollständig durch, bevor Sie mit der Bearbeitung beginnen.
  • Bearbeiten Sie die Aufgaben der Reihe nach, da diese aufeinander aufbauen.
  • Beginnen sie nicht erst, wenn die Gruppeneinteilung online ist! (Aufgabe 1 lässt sich bereits ohne Gruppeneinteilung erledigen und kann, falls Probleme auftreten viel Zeit in anspruch nehmen)

Aufgabe 1: Setup

Setzen Sie eine Arbeitsumgebung auf und testen Sie die Zugänge zu den verschiedenen Diensten.

Arbeitsumgebung

Im Fogenden sollen Sie ihre Arbeitsumgebung einrichten. Sie können im Sopra beliebige andere Werkezeuge verwenden, müssen aber sicherstellen, dass diese mit den hier vogestellten Werkzeugen kompatibel sind.

  • Folgen Sie dem Artikel Arbeitsumgebung einrichten entsprechend Ihrem Betriebssystem um ihre Entwicklungsumgebung einzurichten.
  • Folgen Sie dem Artikel Virtuelles Treffen um auszuprobieren, ob sie ohne technische Probleme an einem Gruppentreffen teilnehmen können.

Dienste

Die folgenden Dienste sollten Sie eingerichtet und getestet haben:

Aufgabe 2: Gitea

Abbildung 1: Auswahl der vorkonfigurierten Labels.

Bereiten Sie ihr Gitea auf den Hausaufgabensprint und die Aufgaben ihrer Gruppe vor. Gehen Sie dazu wie folgt vor.

Gitea vorbereiten

Um Gitea in Verbindung mit Scrum verwenden zu können, müssen vorher bestimmte Labels (siehe Abb. 1) für die Items im Backlog eingerichtet werden.

  • Klicken Sie auf Issues -> Labels.
  • Wenn noch keine Labels eingerichtet wurden, werden Sie gefragt ob eines der vorkonfigurierten Menge von Labels verwendet werden soll. Wählen Sie hier das vorkonfigurierte Set Sopra.
  • Prüfen sie ob Labels für Priorität und Zeitabschätzung vorhanden sind, wie auf dem Bild zu sehen (Details können variieren). Wenn keine Labels zur Zeitabschätzung und Priorisierung vorhanden sind, löschen Sie alle Labels. Wählen Sie dann wie oben beschrieben das vorkonfigurierte Labelset für das Sopra.


Sprint für Hausaufgabe anlegen

Abbildung 2: Den Hausaufgabensprint erstellen.

Prüfen sie ob in Gitea ein Sprint für die Hausaufgabe angelegt wurde.

  • Klicken Sie auf den Reiter Issues -> Milestones.
  • Falls kein Sprint (Milestone) für die Hausaufgabe angezeigt wird (siehe Abb. 2), legen Sie einen Milesstone mit dem Namen Sprint 00 (Hausaufgabe) an.
    • Verwenden Sie das Datum für das Ende des Sprints das Abgabedatum auf der Hauptseite.


User Stories für Aufgabe 3 erstellen

Abbildung 3: Eine User Story anlegen.

Prüfen Sie ob für die Hausaufgabe bereits alle Items existieren. Wenn nicht, legen Sie diese an.

  • Klicken Sie auf den Reiter Issues.
  • Prüfen Sie ob bereits ein Item mit dem Titel Student <NAME> soll Scrum, Gitea und Git verstehen existiert (siehe Abb. 3).
    • Wenn nicht legen Sie eine entsprechende Userstory an indem Sie den weiteren Punkten folgen:
    1. Klicken Sie Neuer Issue.
    2. Tragen sie als Titel Student <NAME> soll Scrum, Gitea und Git verstehen ein.
    3. Tragen sie im Textfeld darunter die ausführliche Beschreibung Student <NAME> soll Scrum, Gitea und Git verstehen um effizient arbeiten zu können. ein.
    4. Weisen Sie dem Item eine hohe Priorität über das Label high zu, indem Sie auf das Zahnrad neben dem Schrifzug Label drücken und die entsprechenden Label auswählen.
    5. Weisen Sie dem Sprint (Meilenstein) Sprint 00 (Hausaufgabe) zu.
    6. Drücken sie auf Issue Erstellen.

Bitte beachten Sie in dieser, und in folgenden Aufgaben, den Platzhalter <NAME> geeignet (z.B.: mit ihrem Usernamen, oder Vornamen) zu ersetzen.

Items für Aufgabe 4 erstellen

Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, eine Item für Aufgabe 4

  • Titel Student <NAME> soll die Clean Code Development Texte lesen mit Beschreibung Student <NAME> soll die Clean Code Development Texte lesen, um besseren Code schreiben zu können.
  • Titel Student <NAME> soll den Usability Artikel lesen mit Beschreibung Student <NAME> soll den Usability Artikel lesen, um von vornherein Usabilityprobleme zu vermeiden.
  • Titel Student <NAME> soll die Dokumentation Texte lesen mit Beschreibung Student <NAME> soll die Dokumentation Texte lesen, um seinen Code sinvoll dokumentieren zu können.

Items für Aufgabe 5 erstellen

Erstellen Sie wie in den vorhergehenden Aufgaben beschrieben, ein Item für Aufgabe 5

  • Titel Student <NAME> soll ein MonoGame Programm schreiben mit Beschreibung Student <NAME> soll das in Aufgabe 5 beschriebene Programm schreiben, um seine Entwicklungswerkzeuge zu testen.

Items akzeptieren

Abbildung 4: Items für die Hausaufgabe, vom Studenten akzeptiert und mit Zeitschätzung.

Bevor Sie mit den Aufgaben beginnen, sollten Sie sich die entsprechenden Items zuweisen (siehe Abb. 4).

  • Wählen Sie eines ihrer Items aus dem Sprintbacklog (Issues -> Milestones -> Hausaufgabe) aus, indem Sie auf den Titel des Tickets klicken.
  • Geben sie eine Abschätzung wie lange es dauern wird das Item nach der Definition of Done umzusetzten. Weisen Sie das Label est: 1 um die Abschätzung zu geben, dass es insgesamt eine Stunde Arbeit benötigt wird. Wenn sie vermuten, dass Sie mehr als eine Stunde benötigen, wählen Sie einen entsprechend höheren Wert aus.
  • Weisen Sie sich dem Item zu, indem Sie auf das Zahnrad neben dem Schriftzug Zuständig klicken, und ihren Benutzernamen auswählen.

Aktzeptieren Sie so alle Tasks die sie in den vorhergehenden Aufgaben erstellt haben. Akzeptieren Sie auch das Item zu Aufgabe 5 falls dieses schon existierte.

Beachten Sie, dass es nicht nötig für jede Änderung einen Kommentar zu schreiben. Alle Änderungen an Labels und zugewiesenen Personen werden sofort übernommen und in der Historie des Tickets eingetragen.

Überprüfen der Items

Bevor Sie mit der Arbeit zu beginnen, prüfen Sie noch einmal ob alle Items für Ihre Aufgaben im Sprintbacklog vorhanden sind.

  • Klicken sie auf den Reiter Issues -> Meilensteine -> Hausaufgabe
  • Schränken Sie die Anzeige auf die Ihnen zugewiesenen Items ein, indem sie unter Zuständig ⯆ ihren Usernamen wählen. Prüfen Sie ob alle Items vorhanden sind.
  • Erstellen Sie eventuell nicht vorhandene Userstories und Tasks wie in den vorhergehenden Aufgaben beschrieben.

Aufgabe 3: Scrum und Gitea verstehen

  • Recherchieren Sie, was Scrum ist und wie Scrum funktioniert.
  • Lesen Sie außerdem den Wikipedia-Artikel zu User Stories.
  • Machen Sie sich mit den anderen Funktionen von Gitea vertraut und lesen Sie den Artikel Scrum und Gitea
  • Sollte es Fragen zum Vorgehen (Scrum und Gitea) geben, schreiben Sie diese als Kommentar in ihr Item in Gitea, damit eventuelle Fragen schnell geklärt werden können (Kommentarfeld unter Issues -> Meilensteine -> Hausaufgabe -> Student <NAME> soll Scrum, Gitea und Git verstehen).
  • Lesen sie die Artikel Git und Git Workflow
  • Sollte es noch keine .gitignore-Datei in Ihrem Repository geben, erstellen Sie in ihrem Repository eine entsprechende Datei (Git#Dateien Ignorieren), sodass temporäre Dateien von Visual Stuidio und Verzeichnisse für den Compileroutput von Git ignoriert werden. Comitten Sie diese Datei und pushen Sie diese ebenfalls. Eine gute Vorlage finden Sie unter Github.

Hinweis: Achten Sie darauf, dass die in ihrem Git eingestellte Emailadresse mit der in Gitea eingestellten Emailadesse übereinstimmt, da Ihnen sonst keine Commits zugeordnet werden können.

Aufgabe 4: Texte lesen

Lesen Sie sich die folgenden Artikel durch, und kommentieren Sie ihr entsprechendes Ticket:

  • Lesen Sie Clean Code Development
    • Beschreiben Sie in einem Kommentar zum entsprechenden Item ein Cleancodeprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.
  • Lesen Sie Dokumentation
  • Lesen Sie Usability-Prinzipien beim Spieldesign
    • Beschreiben Sie in einem Kommentar zum entsprechenden Item ein Usabilityprinzip und wieso Sie es für das Sopra für besonders wichtig erachten.

Items bearbeiten

Bearbeiten sie die Aufgaben und tragen Sie entsprechende Zeiten in die Items in Gitea ein (im Menü rechts, Time Tracker -> Add Time). Besonders bei Programmieraufgaben ist dies sinnvoll, da so eine Historie der Bearbeitung und der verbrauchten Zeit erstellt wird. Dies hilft nicht nur Ihnen bei der Planung weiterer Aufgaben und Abschätzung der dafür benötigten Zeit, sondern dient auch als Nachweis für Ihre kontinuierliche Mitarbeit (siehe Formalien).

Achtung: Sie können die Summe der einmal eingetragenen Zeit nachträglich nur nach oben verändern.

Items schließen

Wenn Sie mit einer Aufgabe fertig sind, sollten Sie Ihren entsprechenden Items schließen. Gehen Sie ähnlich wie beim Akzeptieren einer Story vor und drücken Sie auf den Button Schließen. Beachten Sie bei Aufgaben die zu denen Sie etwas comitten, dass Sie das Item auch über die Commitnachricht schließen können.

Vergessen Sie nicht die Zeit, die Sie für den Task benötigt haben, einzutragen (falls Sie das noch nicht gemacht haben).

Aufgabe 5: Programm schreiben

Abbildung 5: Das fertige Programm könnte so aussehen.

Erstellen Sie ein MonoGame Programm, welches die folgenden Eigenschaften erfüllt:

Funktionale Anforderungen

Abbildung 6: Das Uni-Logo
Abbildung 7: Hintergrundgrafik
  • Das Programm zeichnet eine Hintergrundgrafik in einem MonoGame-Fenster.
  • Vor dieser Hintergrundgrafik rotiert ein Uni-Logo um den Bildschirmmittelpunkt.
    • Das Logo muss transparent sein, d.h. es dürfen keine weißen Ränder der verwendeten Grafik sichtbar sein. Außerdem muss durch alle nicht-schwarzen Stellen des Logos hindurchgesehen werden können.
    • Das Logo muss korrekt skaliert sein, damit es vollständig in den sichtbaren Bereich hinein passt.
    • Das Logo darf während der Bewegung nicht über die Ränder des sichtbaren Bereiches hinausragen. (Größenveränderung des Fensters ist zu vernachlässigen. Es gilt die Größe des Fensters bei Programmaufruf.)
  • Innerhalb des MonoGame-Fensters wird ein Maus-Cursor angezeigt.
    Hinweis, falls Sie mit einer virtuellen Maschine arbeiten, in der Windows installiert ist: Normalerweise wird der Mauszeiger in MonoGame Fenstern standardmäßig ausgeblendet, wenn man ihn nicht explizit aktiviert. Beim Arbeiten mit einer virtuellen Maschine kann es jedoch sein, dass der Mauszeiger im Fenster immer angezeigt wird. In diesen Fällen wird nicht bemerkt, dass man den Mauszeiger eigentlich hätte anschalten müssen. Um sicher zu stellen, dass die Anforderung erfüllt ist, testen Sie Ihr Programm sicherheitshalber noch einmal an einem der Poolrechner unter Windows, um einen möglichen Punktabzug an dieser Stelle in der Hausaufgabe auszuschließen.
  • Wenn der Benutzer mit der Maus innerhalb des Fensters klickt, soll ein Sound abhängig von der Position des Cursors abgespielt werden:
    • Befindet sich der Cursor über dem Logo, soll ein Ton A erklingen.
    • Befindet sich der Cursor nicht über dem Logo, soll ein Ton B erklingen.
    • Ton A und Ton B müssen verschieden sein.

Randbedingungen

Die Randbedingungen müssen erfüllt werden. Insbesondere muss Ihre Abgabe komplett frei von Resharper-Fehlern und Warnungen sein. Die zu verwendenden Settings sind die der finalen Abgabe (Softwarepraktikum-final.DotSettings).

ReSharper-Hinweise

Beim Erstellen eines MonoGame-Projekts wird eine Variable, mGraphics von MonoGame angelegt, welche augenscheinlich initial nicht verwendet wird. Das heißt, sie wird innerhalb des Quelltextes nicht gelesen. Die Variable wird jedoch intern von der MonoGame-Engine verwendet und darf nicht gelöscht werden, da sonst wichtige Grafikschnittstellen nicht gefunden werden und das Programm abstürzt.

Es kann sein, dass die Hausaufgabe programmiert werden kann, ohne dass man diese Variable jemals irgendwo verwenden muss. Dies führt dazu, dass ReSharper eine Fehlermeldung bzgl. einer unbenutzten Variable im Projekt ausgibt.

Um ReSharper-Konformität der Hausaufgabe unter diesen Bedingungen herzustellen, sind mehrere Möglichkeiten denkbar:

  1. Verwenden der mGraphics Variable bei der Erstellung eines Sprite-Batches. Es ist möglich, den SpriteBatch, auf dem das Uni-Logo gezeichnet wird, mit
    someSpriteBatch = new SpriteBatch(mGraphics.GraphicsDevice);
    
    zu initialisieren.
  2. Hinzufügen einer ReSharper-Ausnahme für die Variable mGraphics. Eine Ausnahme für diese Variable ist die einzige Ausnahme, die wir akzeptieren.

Ressourcen

Damit das Erstellen von Grafiken ignoriert werden kann, gibt es hier die beiden Beispieldateien aus der Einführungsveranstaltung:

Als Audiodateien können beliebige, kurze, Dateien verwendet werden. Die beiden aus der Einführungsveranstaltung bekannten Waves gibt es hier:

Abgabe

Bitte verwenden Sie zur finalen Abgabe der Hausaufgabe das Git-Repository ihrer Gruppe: Abgabe/Hausaufgabe

Abgabe Finalisieren

Wenn Sie in Ihrer Gruppe die Aufgaben als letztes abschließen (d.h. Sie die letzte offene User Story im Sprint schließen) erledigen Sie noch folgende Aufgabe. In den auf die Hausaufgabe folgenden Sprints erledigt dies der Product Owner.


Der Fortschritt der während des Sprints erziehlt wurde (Inkrement) muss auf den release branch übtertragen werden, damit trotz weiterer Arbeit immer eine auslieferbare Version verfügbar ist.

  • Schließen Sie das Sprintbacklog (Issues -> Meilensteine -> Hausaufgabe -> Schießen).
  • Erstellen sie einen Pullrequest (siehe Abb. 8), sodass der aktuelle Stand von master nach release übertragen werden kann wird. Gehen Sie wie folgt vor:
    • Klicken Sie in Gitea auf den Reiter Code -> Branch: master.
    • Drücken Sie auf den grünen Button neben dem Branch-dropdown.
    • Prüfen Sie im folgenden Dialog, dass als Ziel release und als pullen von master gewählt sind. Geben Sie dem Pullrequest den Titel Hausaufgabe.
    • Drücken Sie auf Pullrequest Erstellen.
    • Gitea wird feststellen, dass master automatisch in release gemerged werden kann. Ein weiteres Drücken auf Pull-Request Zusammenführen öffnet ein Kommentarfenster, noch einmal drücken schließt den Pull-Request ab.

Die Änderungen die Sie und ihre Gruppe während des Hausaufgabensprints gemacht haben, wurden nun in den release-branch übertrangen.

Hinweise

  • Falls Sie Probleme beim Starten der Anwendung haben, schauen Sie zuerst in die FAQ. Ein oft auftretendes Problem ist z.B. die Fehlermeldung "No suitable graphics card found".
  • Möglicherweise wird bei Ihnen kein Sound abgespielt, obwohl dies Ihrer Einschätzung nach eigentlich der Fall sein sollte. Prüfen Sie in diesem Fall, ob die Installation der DirectX Runtime das Problem behebt.