Arbeitsumgebung einrichten: Unterschied zwischen den Versionen

Aus Das Sopra Wiki
Zur Navigation springen Zur Suche springen
VisuellWikitext
(1st draft)
 
Keine Bearbeitungszusammenfassung
 
(86 dazwischenliegende Versionen von 10 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
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. Sie benötigen mindestens eine der hier vorgestellten Alternativen.
{{TOCRight}}
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.


= Poolrechner =
== Windows ==
Im Pool ist Visual Studio 2019 derzeit nicht installiert. Jedoch kann stattdessen Visual Studio 2017 verwendet werden. Für die Verwendung mit MonoGame müssen folgende Schritte durchgeführt werden:
=== Visual Studio ===
* Windows booten: bei Start des PCs im Bootloader Windows 7 auswählen.
Installieren Sie Visual Studio 2022 Community (64 Bit) indem Sie den Installationsanweisungen auf [https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2022 Install Visual Studio] folgen.
* CTRL+ALT+ENTF drücken, um sich mit dem Pool-Account anzumelden.
* '''Visual Studio 2017''' einmal starten, damit die nötigen Verzeichnisse und Dateien angelegt werden.
* Sobald VS2017 gestartet ist, Visual Studio wieder '''schließen'''.
* Im Explorer auf das Windows-Laufwerk "S: (software)" navigieren.
* Installation der Plugins für Visual Studio (siehe auch Readme-Datei auf S:):
** Für '''MonoGame-Installation''': Verzeichnis "Visual C#" nach "C:\Users\<USERNAME>\Documents\Visual Studio 2017\Templates\ProjectTemplates" kopieren.
* Visual Studio 2017 starten.


= Windows =
Wählen Sie während der Installation unter <code>Workloads</code> die folgende Optionen aus:
* Stellen Sie sicher, dass Ihr PC mit dem Internet verbunden ist.
*<code>.NET desktop development</code>
===MonoGame===
Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_windows.html#install-monogame-extension-for-visual-studio-2022 Install MonoGame extension for Visual Studio 2022] folgen.
===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.


== Visual Studio ==
===Resharper===
* Laden Sie [https://visualstudio.microsoft.com/downloads/ Visual Studio Community herunter].
Die Resharperkonfiguration wird benötigt damit der Resharper die von uns empfohlene Codingstandards überprüft.{{:Resharper_Installieren}}
* Folgen Sie der [https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2019#step-3---install-the-visual-studio-installer Installationsanleitung von Microsoft] und achten Sie dabei darauf die folgenden Optionen unter "Workloads" auszuwählen:
** .NET Core cross-platform development
** .Net Desktop Development
** Universal Windows Platform development


== Monogame ==
===Git===
* Öffnen Sie Visual Studio, wählen Sie im Startbildschirm "Continue without code." Öffnen Sie <tt>Extensions -> Manage Extensions -> Visual Studio Marketplace</tt>. Suchen Sie "Monogame", installieren Sie "Monogame project templates".
Es gibt unzählige Git Clients. Empfehlenswert ist vor allem für den Einstieg [https://git-scm.com/downloads der offizielle Git Client], dessen grafisches Interface jedoch sehr rudimentär ist. Es empfiehlt sich daher zusätzlich einen zweiten Client wie z.B. [https://tortoisegit.org/ TortoiseGit] oder eine der [https://git-scm.com/downloads/guis zahlreichen Alternativen] zu verwenden.
* Schließen Sie alle Visual Studio Instanzen, damit die Installation erfolgen kann.
* Nach abschluss der Installation öffnen Sie Visual Studio und wählen Sie <tt>Create a new project</tt>. Wählen Sie <tt>Monogame Cross-Plattform Desktop Application (OpenGL)</tt> und nennen Sie das Project <tt>testMonogame</tt>.
* Das erste erstellen wird einige Zeit dauern, da der NuGet Paketmanager das Monogame Framework herunterläd und installiert.
* Klicken Sie auf den grünen "Playbutton" unter dem Menu. Das Projekt wird kompiliert und nach einiger Zeit erscheint ein Programmfenster gefüllt mit blauer Farbe. Das bedeutet sie sind bereit Monogame Projekte zu entwickeln.
* (Optional) Unter "Solution Explorer" klicken Sie mit der rechten Maustaste auf <tt>testMonogame" -> "Manage NuGet Packages</tt>, hier sollten im Reiter "Install" Monogame.Framework und Monogame.Contantbuilder version > 3.8 erscheinen.
* Öffnen sie <tt>tools -> Command line -> Developer command prompt</tt> und führen sie diesen Befehl aus: <code>dotnet tool install --global dotnet-mgcb-editor</code> danach diesen: <code>mgcb-editor --register</code>.
* Schliesen Sie Visual-Studio und öffnen Sie es wieder. In ihrem "testMonogame" Projekt klicken Sie im Solution Explorer mit der rechten Maustaste auf auf "Content.mgcb" und wählen Sie "Open with". Wählen Sie jetzt "mgcb-editor-wps" und klicken sie auf "Set as Default". Klicken Sie aus Okay. Jetzt sollte sich der Monogame Content builder öffnen.


== [[Resharper]] ==
Bereiten Sie ihr Git wie beschrieben in [[Git#Git im Softwarepraktikum|Git im Softwarepraktikum]] vor.
* Erstellen Sie sich [https://account.jetbrains.com/login einen Account bei Jetbrains]. Verwenden Sie ihre uni-freiburg.de Email Adresse, damit sie eine kostenlose Lizenz erhalten.
* [https://www.jetbrains.com/resharper/ Laden Sie Resharper herunter] und führen Sie die Installation aus.
* Laden Sie die Sopra spezifischen Resharper Einstellungen herunter [[Datei:Sopra-Resharper.zip]], [[Datei:Sopra-Resharper-final.zip]] und entpacken Sie diese.
* Öffen Sie in Visual Studio <tt>Extensions -> ReSharper -> Manage Options</tt>.
* Klicken Sie rechts auf das Item <tt>This Computer</tt> und wählen Sie <tt>Add Layer->Open Settings File...</tt>.
* Wählen Sie die Datei <tt>Softwarepraktikum.DotSettings</tt>, bzw. <tt>Softwarepraktikum-final.DotSettings</tt> aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.
* '''Achtung:''' Zur finalen Abgabe werden einige Regeln, die zuvor nur als "Hinweis" gewertet wurden, nun als "Warning" gewertet. Die Einstellungen sind also etwas strenger. Stellen Sie sicher, dass Sie zur finalen Abgabe Ihres Programms die <tt>Softwarepraktikum-final.DotSettings</tt> zur Überprüfung der Einhaltung der ReSharper-Regeln verwenden. Sie können natürlich auch bereits während des Verlaufs des Softwarepraktikums diese Regeln verwenden, um den Arbeitsaufwand zur Beseitigung der neuen Warnings am Ende des Softwarepraktikums zu reduzieren.


== Git ==
==Linux ==
* Folgen sie dem [[Git#Git_Installieren | Git intallieren tutorial]] aus diesem Wiki.
Diese Anleitung ist für Debian geschrieben. Entsprechend können die Pfade auf abweichenden Distributionen anders sein.  


= Linux =
=== .NET===
* <tt>tbd</tt>
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.
 
===Rider===
Installieren Sie Rider, indem Sie den Installationsanweisungen auf [https://www.jetbrains.com/help/rider/Installation_guide.html Install JetBrains Rider] folgen.
 
=== MonoGame===
Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_ubuntu.html#install-monogame-templates Install MonoGame templates] folgen.
===MonoGame Projekt<ref name=":0" />===
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_netcore.html .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 <code>Content.mgcb</code> nicht den gewünschten Effekt hat, versuchen Sie folgenden Workaround.
 
* Öffnen Sie das Terminal in Rider (<code>View > Tool Windows > Terminal</code>) oder (<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.
* [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.
 
 
===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===
 
*Installieren Sie Git indem Sie den Installationsanweisungen auf [https://git-scm.com/download/linux Download for Linux and Unix] folgen.
*Bereiten Sie ihr Git wie beschrieben in [[Git#Git im Softwarepraktikum|Git im Softwarepraktikum]] vor.
 
==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 [https://learn.microsoft.com/en-us/visualstudio/mac/installation?view=vsmac-2022 Install Visual Studio for Mac] folgen.
 
===MonoGame ===
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" />===
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===
 
*Installieren Sie Git indem Sie den Installationsanweisungen auf [https://git-scm.com/download/mac Download for macOS] folgen.
*Bereiten Sie ihr Git wie beschrieben in [[Git#Git im Softwarepraktikum|Git im Softwarepraktikum]] vor.
 
==Ubuntu in den Computer Labs==
=== .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.
 
===Rider===
Laden Sie Rider auf [https://www.jetbrains.com/rider/download/#section=linux Download Rider] herunter und entpacken Sie es z.B. nach <code>~/jetbrains-rider</code>.
 
Sie können Rider über den Befehl <code>~/jetbrains-rider/bin/rider.sh</code> starten.
 
===MonoGame ===
Installieren Sie die MonoGame Erweiterung indem Sie den Installationsanweisungen auf [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_ubuntu.html#install-monogame-templates Install MonoGame templates] folgen.
===MonoGame Projekt<ref name=":0" />===
Erstellen Sie ein MonoGame Projekt wie in [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_netcore.html .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 <code>Content.mgcb</code> nicht den gewünschten Effekt hat, versuchen Sie folgenden Workaround.
 
*Ö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.
 
===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 sollte bereits auf dem Rechner installiert sein. Sie können dies mit dem Befehl <code>git --version</code> überprüfen.
 
==Referenzen==
 
<references />

Aktuelle Version vom 17. Oktober 2023, 18:22 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.

Resharper

Die Resharperkonfiguration wird benötigt damit der Resharper die von uns empfohlene Codingstandards überprüft.

  • Erstellen Sie sich einen Account bei Jetbrains. Verwenden Sie ihre ...uni-freiburg.de E-Mail-Adresse, damit sie eine kostenlose Lizenz erhalten. Wenn Sie nicht sofort eine Lizenz erhalten, gehen Sie auf folgende Seite und beantragen die Lizenz explizit.
  • Laden Sie Resharper herunter und führen Sie die Installation aus.
  • Laden Sie die Sopra-spezifischen Resharper Einstellungen herunter und entpacken Sie diese.
  • Öffnen Sie in Visual Studio Extensions -> ReSharper -> Manage Options.
  • Klicken Sie rechts auf das Item This Computer und wählen Sie Add Layer -> Open Settings File....
  • Wählen Sie die Datei Softwarepraktikum.DotSettings aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.

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 6.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.


Resharper

Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.

  • Laden Sie die Sopra-spezifischen Resharper Einstellungen herunter und entpacken Sie diese.
  • Öffnen Sie in Rider File > Settings > Manage Layers.
  • Klicken Sie rechts auf das Item This Computer und wählen Sie Add Layer > Open Settings File....
  • Wählen Sie die Datei Softwarepraktikum.DotSettings aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.

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.

Resharper

Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.

  • Erstellen Sie sich 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 Rider herunterladen. Diese IDE beinhaltet Resharper und kann somit zum Style-Check verwendet werden.

Git

Ubuntu in den Computer Labs

.NET

.NET SDK sollte auf dem Rechner bereits in einer Version >= 6.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.

Resharper

Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.

  • Laden Sie die Sopra-spezifischen Resharper Einstellungen herunter und entpacken Sie diese.
  • Öffnen Sie in Rider File > Settings > Manage Layers.
  • Klicken Sie rechts auf das Item This Computer und wählen Sie Add Layer > Open Settings File....
  • Wählen Sie die Datei Softwarepraktikum.DotSettings aus. Diese sollte nun als Eintrag "Softwarepraktikum" vorhanden sein.

Git

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

Referenzen

  1. ↑ 1,0 1,1 1,2 1,3 https://docs.monogame.net/articles/getting_started/0_getting_started.html MonoGame getting started
Abgerufen von „https://sopranium.de/index.php?title=Arbeitsumgebung_einrichten&oldid=10815“