Arbeitsumgebung einrichten: Unterschied zwischen den Versionen

Aus Das Sopra Wiki
Langenfeld (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Frank (Diskussion | Beiträge)
Resharper + .NET 8
Zeile 12: Zeile 12:
===MonoGame Projekt<ref name=":0">https://docs.monogame.net/articles/getting_started/0_getting_started.html MonoGame getting started</ref>===
===MonoGame Projekt<ref name=":0">https://docs.monogame.net/articles/getting_started/0_getting_started.html MonoGame getting started</ref>===
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_vs.html Creating a Project with Visual Studio 2022] beschrieben.
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_vs.html Creating a Project with Visual Studio 2022] beschrieben.
===Resharper===
Die Resharperkonfiguration wird benötigt damit der Resharper die von uns empfohlene Codingstandards überprüft.{{:Resharper_Installieren}}


===Git===
===Git===
Zeile 25: Zeile 22:


=== .NET===
=== .NET===
Installieren Sie .NET SDK in Version 6 indem Sie den Installationsanweisungen auf [https://dotnet.microsoft.com/en-us/download/dotnet/6.0 Download .NET 6.0] für Ihre Distribution folgen.
Installieren Sie .NET SDK in Version 6 indem Sie den Installationsanweisungen auf [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 Download .NET 8.0] für Ihre Distribution folgen.


===Rider===
===Rider===
Zeile 42: Zeile 39:
* [https://docs.monogame.net/articles/tools/mgcb_editor.html Wie hier beschrieben] muss der Befehl im Wurzelverzeichniss des Projektes ausgeführt werden.
* [https://docs.monogame.net/articles/tools/mgcb_editor.html Wie hier beschrieben] muss der Befehl im Wurzelverzeichniss des Projektes ausgeführt werden.
* Das [https://github.com/seclerp/rider-monogame rider-monogame-plugin] bietet ebenfalls einen shortcut um den externen MGCB Editor zu öffnen.
* Das [https://github.com/seclerp/rider-monogame rider-monogame-plugin] bietet ebenfalls einen shortcut um den externen MGCB Editor zu öffnen.
===Resharper ===
Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.
*Laden Sie die [[Medium:Sopra-Resharper.zip|Sopra-spezifischen Resharper Einstellungen]] herunter und entpacken Sie diese.
* Öffnen Sie in Rider <code>File > Settings > Manage Layers</code>.
*Klicken Sie rechts auf das Item <code>This Computer</code> und wählen Sie <code>Add Layer > Open Settings File...</code>.
*Wählen Sie die Datei <code>Softwarepraktikum.DotSettings</code> aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.
===Git===
===Git===


Zeile 66: Zeile 53:
Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_macos.html#install-monogame-extension-for-visual-studio-for-mac Install MonoGame extension for Visual Studio for Mac] folgen.
Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_macos.html#install-monogame-extension-for-visual-studio-for-mac Install MonoGame extension for Visual Studio for Mac] folgen.
===MonoGame Projekt<ref name=":0" />===
===MonoGame Projekt<ref name=":0" />===
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_vsm.html Creating a Project with Visual Studio for Mac] beschrieben.
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_vsm.html Creating a Project with Visual Studio for Mac] beschrieben
 
===Resharper ===
Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.
*Erstellen Sie sich [https://account.jetbrains.com/login JetBrains Account]. Verwenden Sie ihre uni-freiburg.de Email Adresse, damit sie eine kostenlose Lizenz erhalten.
*Für Visual Studio (Mac OS) gibt es leider keine nutzbare Version von Resharper. Alternativ können Sie aber über den erstellten JetBrains Account kostenlos [https://www.jetbrains.com/rider/ Rider] herunterladen. Diese IDE beinhaltet Resharper und kann somit zum Style-Check verwendet werden.


===Git===
===Git===
Zeile 80: Zeile 62:
==Ubuntu in den Computer Labs==
==Ubuntu in den Computer Labs==
=== .NET===
=== .NET===
.NET SDK sollte auf dem Rechner bereits in einer Version >= 6.0 installiert sein. Sie können dies mit dem Befehl <code>dotnet --version</code> überprüfen.
.NET SDK sollte auf dem Rechner bereits in einer Version >= 8.0 installiert sein. Sie können dies mit dem Befehl <code>dotnet --version</code> überprüfen.


===Rider===
===Rider===
Zeile 96: Zeile 78:


*Öffnen Sie das Terminal in Rider (<code>Ctrl+Alt+1</code>)
*Öffnen Sie das Terminal in Rider (<code>Ctrl+Alt+1</code>)
*Geben Sie den Befehl <code>dotnet mgcb-editor</code> oder <code>dotnet mgcb-editor <Pfad zur Content.mgcb></code> ein.
*Geben Sie den Befehl <code>dotnet mgcb-editor</code> oder <code>dotnet mgcb-editor <Pfad zur Content.mgcb></code> ein
 
===Resharper ===
Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.
 
*Laden Sie die [[Medium:Sopra-Resharper.zip|Sopra-spezifischen Resharper Einstellungen]] herunter und entpacken Sie diese.
* Öffnen Sie in Rider <code>File > Settings > Manage Layers</code>.
*Klicken Sie rechts auf das Item <code>This Computer</code> und wählen Sie <code>Add Layer > Open Settings File...</code>.
*Wählen Sie die Datei <code>Softwarepraktikum.DotSettings</code> aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.


===Git===
===Git===

Version vom 26. September 2024, 09:58 Uhr

Die Arbeitsumgebung beinhaltet alle Produkte die im Sopra für die Entwicklung benötigt werden. In diesem Artikel wird beschrieben wie Sie Ihre Arbeitsumgebung einrichten und testen.

Windows

Visual Studio

Installieren Sie Visual Studio 2022 Community (64 Bit) indem Sie den Installationsanweisungen auf Install Visual Studio folgen.

Wählen Sie während der Installation unter Workloads die folgende Optionen aus:

  • .NET desktop development

MonoGame

Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf Install MonoGame extension for Visual Studio 2022 folgen.

MonoGame Projekt[1]

Erstellen Sie ein MonoGame Projekt wie in Creating a Project with Visual Studio 2022 beschrieben.

Git

Es gibt unzählige Git Clients. Empfehlenswert ist vor allem für den Einstieg der offizielle Git Client, dessen grafisches Interface jedoch sehr rudimentär ist. Es empfiehlt sich daher zusätzlich einen zweiten Client wie z.B. TortoiseGit oder eine der zahlreichen Alternativen zu verwenden.

Bereiten Sie ihr Git wie beschrieben in Git im Softwarepraktikum vor.

Linux

Diese Anleitung ist für Debian geschrieben. Entsprechend können die Pfade auf abweichenden Distributionen anders sein.

.NET

Installieren Sie .NET SDK in Version 6 indem Sie den Installationsanweisungen auf Download .NET 8.0 für Ihre Distribution folgen.

Rider

Installieren Sie Rider, indem Sie den Installationsanweisungen auf Install JetBrains Rider folgen.

MonoGame

Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf Install MonoGame templates folgen.

MonoGame Projekt[1]

Erstellen Sie ein MonoGame Projekt wie in .NET CLI (JetBrains Rider or Visual Studio Code) beschrieben.


Info: Falls Sie den MGCB Editor in Rider öffnen möchten und ein Doppelklick auf die Datei Content.mgcb nicht den gewünschten Effekt hat, versuchen Sie folgenden Workaround.

  • Öffnen Sie das Terminal in Rider (View > Tool Windows > Terminal) oder (Ctrl+Alt+1)
  • Geben Sie den Befehl dotnet mgcb-editor oder dotnet mgcb-editor <Pfad zur Content.mgcb> ein.
  • Wie hier beschrieben muss der Befehl im Wurzelverzeichniss des Projektes ausgeführt werden.
  • Das rider-monogame-plugin bietet ebenfalls einen shortcut um den externen MGCB Editor zu öffnen.

Git

Mac OS

Wichtig: Da wir keinen Zugriff auf Maschinen mit aktuellem macOS haben, kann diese Anleitung mittlerweile veraltet sein. Wir können bei Problemen mit macOS leider keinen Support leisten.

Visual Studio

Installieren Sie Visual Studio 2022 Community (64 Bit) indem Sie den Installationsanweisungen auf Install Visual Studio for Mac folgen.

MonoGame

Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf Install MonoGame extension for Visual Studio for Mac folgen.

MonoGame Projekt[1]

Erstellen Sie ein MonoGame Projekt wie in Creating a Project with Visual Studio for Mac beschrieben

Git

Ubuntu in den Computer Labs

.NET

.NET SDK sollte auf dem Rechner bereits in einer Version >= 8.0 installiert sein. Sie können dies mit dem Befehl dotnet --version überprüfen.

Rider

Laden Sie Rider auf Download Rider herunter und entpacken Sie es z.B. nach ~/jetbrains-rider.

Sie können Rider über den Befehl ~/jetbrains-rider/bin/rider.sh starten.

MonoGame

Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf Install MonoGame templates folgen.

MonoGame Projekt[1]

Erstellen Sie ein MonoGame Projekt wie in .NET CLI (JetBrains Rider or Visual Studio Code) beschrieben.


Info: Falls Sie den MGCB Editor in Rider öffnen möchten und ein Doppelklick auf die Datei Content.mgcb nicht den gewünschten Effekt hat, versuchen Sie folgenden Workaround.

  • Öffnen Sie das Terminal in Rider (Ctrl+Alt+1)
  • Geben Sie den Befehl dotnet mgcb-editor oder dotnet mgcb-editor <Pfad zur Content.mgcb> ein

Git

Git sollte bereits auf dem Rechner installiert sein. Sie können dies mit dem Befehl git --version überprüfen.

Referenzen