|
|
| (42 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{TOCRight}} | | {{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. Sie benötigen mindestens eine der hier vorgestellten Alternativen. | | 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 == | | == Windows / Linux == |
| * Stellen Sie sicher, dass Ihr PC mit dem Internet verbunden ist.
| | === .NET=== |
| | Installieren Sie .NET SDK in Version 9 indem Sie den Installationsanweisungen auf [https://dotnet.microsoft.com/en-us/download/dotnet/9.0 Download .NET 9.0] für Ihr Betriebssystem folgen. |
|
| |
|
| === Visual Studio === | | === Entwicklungsumgebung === |
| * Laden Sie [https://visualstudio.microsoft.com/downloads/ Visual Studio Community herunter].
| | Richten Sie Ihre Entwicklungsumgebung. Wir empfehlen die Verwendung von [https://www.jetbrains.com/de-de/rider/ Jetbrains Rider]. Als Student haben sie Zugriff auf eine [https://www.jetbrains.com/de-de/community/education/#students kostenlose Bildungslizenz]. Alternativ können Sie unter Windows [https://visualstudio.microsoft.com/de/vs/community/ Visual Studio Community 2026] verwenden. |
| * 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
| |
| '''Hinweis''': achten Sie bei der Installation von Visual Studio und .net darauf, die 64bit version zu installieren, da Monogame nur noch diese unterstützt.
| |
|
| |
|
| === Monogame ===
| | Zur Installation der IDE inkl. MonoGame folgen Sie bitte der [https://docs.monogame.net/articles/getting_started/2_choosing_your_ide_rider.html Anleitung] der MonoGame-Dokumentation. |
| Templates zu Visual Studio hinzufügen.
| |
| * Öffnen Sie Visual Studio.
| |
| * Wählen Sie im Startbildschirm <tt>Continue without code</tt> (unten rechts).
| |
| * Öffnen Sie <tt>Extensions -> Manage Extensions -> Visual Studio Marketplace</tt>.
| |
| * Suchen Sie "Monogame", installieren Sie <tt>MonoGame project templates</tt> (Version >= 3.8.0).
| |
| * Schließen Sie alle Visual Studio Instanzen, damit die Installation erfolgen kann.
| |
|
| |
|
| === Monogame Projekt erstellen<ref>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 MonoGame Getting Started Tutorial</ref>=== |
| * Nach Abschluss der Installation öffnen Sie Visual Studio
| | Erstellen Sie ein MonoGame Projekt wie in der [https://docs.monogame.net/articles/getting_started/2_choosing_your_ide_rider.html MonoGame-Dokumentation] beschrieben. Wählen Sie hierbei als <code>Type</code> des Projekts <code>Cross-Platform OpenGL Desktop App</code> bzw. <code>Cross-Platform Desktop App</code>. |
| * Wählen Sie <tt>Create a new project -> Monogame Cross-Plattform Desktop Application (OpenGL)</tt> und nennen Sie das Projekt <tt>TestMonogame</tt>.
| |
| * Das erste Erstellen wird einige Zeit dauern, da der NuGet Paketmanager das Monogame Framework herunterlädt 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): Sie können überprüfen ob die Installation erfolgreich war indem sie unter <tt>Solution Explorer</tt> mit der rechten Maustaste auf <tt>TestMonogame</tt> klicken und <tt>Manage NuGet Packages</tt> wählen. Im folgenden Fenster sollte im Reiter <tt>Installed</tt> <tt>Monogame.Framework</tt> und <tt>Monogame.Contentbuilder</tt> mit einer Version >= 3.8.0 erscheinen.
| |
| Monogame Content Builder installieren<ref name=":0">https://docs.monogame.net/articles/tools/mgcb_editor.html MonoGame MGCB Editor installation.</ref>.
| |
| * Öffnen Sie <tt>Tools -> Command Line -> Developer Command Prompt</tt> und führen Sie nacheinander diese Befehle aus:
| |
| ** <code>dotnet tool install --global dotnet-mgcb-editor</code>
| |
| ** <code>mgcb-editor --register</code>
| |
| * Schließen Sie Visual-Studio und öffnen Sie Ihr "testMonogame" Projekt wieder.
| |
| * Klicken Sie im Solution Explorer mit der rechten Maustaste auf auf <tt>Content.mgcb</tt> und wählen Sie <tt>Open with</tt>.
| |
| * Wählen Sie die Option <tt>mgcb-editor-wps</tt>, klicken Sie auf <tt>Set as Default</tt> und klicken Sie auf <tt>Okay</tt>.
| |
| * Ab jetzt sollte sich beim öffnen von <tt>Content.mgcb</tt> der Monogame Content Builder öffnen.
| |
|
| |
|
| === Resharper Installieren und Einrichten ===
| |
| {{:Resharper_Installieren}}
| |
|
| |
|
| === Git ===
| | 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. |
| Folgen sie dem [[Git#Git_Installieren |Git Intallieren]] Artikel aus diesem Wiki.
| |
|
| |
|
| == Linux == | | * Öffnen Sie das Terminal in Rider (<code>View > Tool Windows > Terminal</code>) oder (<code>Ctrl+`</code>) |
| Diese Anleitung ist für Debian geschrieben. Entsprechend können die Pfade auf anderen Distributionen leicht anders sein.
| | * 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/getting_started/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. |
| | ===Git=== |
| | Sie können Git direkt von der Kommandozeile verwenden. Für etwas mehr Komfort empfiehlt sich ein grafischer Client wie z.B. [https://tortoisegit.org/ TortoiseGit] (Windows) oder eine der [https://git-scm.com/downloads/guis zahlreichen Alternativen], die extra installiert werden müssen. Verwenden Sie Rider, ist der grafische Git-Client den Rider mitliefert empfehlenswert (Git muss trotzdem erst installiert werden). |
|
| |
|
| === Abhängigkeiten ===
| | Bereiten Sie ihr Git wie beschrieben in [[Git#Git im Softwarepraktikum|Git im Softwarepraktikum]] vor. |
| * Nehmen Sie das Linux-Software-Repository für Microsoft-Produkte in Ihre Paketquellen auf
| |
| **<code>$ wget [https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb] -O /tmp/packages-microsoft-prod.deb </code>
| |
| ** <code>$ sudo apt install /tmp/packages-microsoft-prod.deb </code>
| |
| ** <code>$ sudo apt update </code>
| |
| * Installieren Sie Mono und .NET Core
| |
| **<code>$ sudo apt install mono-devel dotnet-sdk-6.0 </code>
| |
|
| |
|
| === Rider === | | ==Mac OS== |
| * Laden Sie [https://www.jetbrains.com/rider/download/#section=linux Rider] herunter
| | '''Wichtig''': Da wir keinen Zugriff auf Maschinen mit aktuellem Mac OS haben, können wir bei Problemen mit Mac OS leider '''keinen Support''' leisten. |
| * Installieren sie es indem sie <code>$ sudo tar -xzf JetBrains.Rider-XXXX.X.X.tar.gz -C /opt</code> in ihrem Downloadordner ausführen
| |
| * Sie können Rider über '''/opt/Jetbrains Rider-XXXX.X.X/bin/Rider.sh''' starten.
| |
|
| |
|
| ==== Resharper konfigurieren ====
| | Falls Sie dennoch unter Mac OS entwickeln wollen, folgen Sie bitte der obigen Anleitung. |
| Die Resharperkonfiguration wird benötigt damit der Resharper die von uns geforderten Codingstandards überprüft.
| |
|
| |
|
| ===== Globale Konfiguration (für alle Projekte) ===== | | ==Referenzen== |
| Kopieren Sie die Settingsdatei [[Datei:Sopra-Resharper.zip]] ins Installationsverzeichnis von Rider: '''~/.config/JetBrains/RiderXXXX.X/resharper-host/GlobalSettingsStorage.DotSettings'''
| |
|
| |
|
| ===== Projekt-gebundene Konfiguration =====
| | <references /> |
| Kopieren Sie die Settingsdatei in den Projektordner in dem sich auch die ''.sln'' Datei befindet: '''/pfad/zum/projektordner/{Solution Name}.sln.DotSettings'''
| |
| | |
| === MonoGame ===
| |
| Sie können die MonoGames Templates mit dem folgenden Befehl installieren <code>$ dotnet new --install MonoGame.Templates.CSharp</code>
| |
| | |
| Installieren Sie den Monogame Content Builder<ref name=":0" />.
| |
| * Öffnen Sie <tt>Tools -> Command Line -> Developer Command Prompt</tt> und führen Sie nacheinander diese Befehle aus:
| |
| **<code>dotnet tool install --global dotnet-mgcb-editor</code>
| |
| **<code>mgcb-editor --register</code>
| |
| == Mac OS ==
| |
| '''Wichtig''': Da wir leider keinen Zugriff auf Maschinen mit aktuellem macOS haben, kann diese Anleitung mittlerweile veraltet sein. Wir können bei Problemen mit Mac OS leider '''keinen Support''' leisten.
| |
| | |
| === Visual Studio ===
| |
| * Laden Sie [https://visualstudio.microsoft.com/vs/mac/ Visual Studio für Mac] herunter.
| |
| * Öffnen Sie die heruntergeladene .dmg Datei und wählen Sie "Visual Studio installieren".
| |
| * Sie werden nun dazu aufgefordert auszuwählen was Sie installieren wollen. Wählen Sie ".NET core" aus und installieren Sie dies.
| |
| | |
| === MonoGame ===
| |
| * Laden Sie die [https://github.com/MonoGame/MonoGame/releases/download/v3.8/MonoDevelop.MonoGame_IDE_VisualStudioForMac_3.8.0.1641.mpack Monogame Erweiterung für Visual Studio (Mac)] herunter.
| |
| * Folgen Sie [https://docs.monogame.net/articles/getting_started/1_setting_up_your_development_environment_macos.html dieser Anleitung] um die Erweiterung zu installieren.
| |
| * Um ein neues Projekt zu erstellen, folgen Sie [https://docs.monogame.net/articles/getting_started/2_creating_a_new_project_vsm.html dieser] Anleitung.
| |
| | |
| === Resharper ===
| |
| * 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.
| |
| * 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.
| |
| | |
| == Referenzen ==
| |
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 / Linux
.NET
Installieren Sie .NET SDK in Version 9 indem Sie den Installationsanweisungen auf Download .NET 9.0 für Ihr Betriebssystem folgen.
Entwicklungsumgebung
Richten Sie Ihre Entwicklungsumgebung. Wir empfehlen die Verwendung von Jetbrains Rider. Als Student haben sie Zugriff auf eine kostenlose Bildungslizenz. Alternativ können Sie unter Windows Visual Studio Community 2026 verwenden.
Zur Installation der IDE inkl. MonoGame folgen Sie bitte der Anleitung der MonoGame-Dokumentation.
Erstellen Sie ein MonoGame Projekt wie in der MonoGame-Dokumentation beschrieben. Wählen Sie hierbei als Type des Projekts Cross-Platform OpenGL Desktop App bzw. Cross-Platform Desktop App.
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+`)
- 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
Sie können Git direkt von der Kommandozeile verwenden. Für etwas mehr Komfort empfiehlt sich ein grafischer Client wie z.B. TortoiseGit (Windows) oder eine der zahlreichen Alternativen, die extra installiert werden müssen. Verwenden Sie Rider, ist der grafische Git-Client den Rider mitliefert empfehlenswert (Git muss trotzdem erst installiert werden).
Bereiten Sie ihr Git wie beschrieben in Git im Softwarepraktikum vor.
Mac OS
Wichtig: Da wir keinen Zugriff auf Maschinen mit aktuellem Mac OS haben, können wir bei Problemen mit Mac OS leider keinen Support leisten.
Falls Sie dennoch unter Mac OS entwickeln wollen, folgen Sie bitte der obigen Anleitung.
Referenzen
