You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/tutorials/building_2d_games/02_getting_started/index.md
+27-9Lines changed: 27 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -16,27 +16,29 @@ While the environment setup process is similar to the standard setup process for
16
16
17
17
The first thing we need to do is install the .NET *Software Development Kit* (SDK). At the time of this writing, MonoGame targets the .NET 8.0 SDK. To install it, follow the instructions based on your operating system below
18
18
19
-
### Windows
19
+
### [Windows](#tab/windows)
20
20
1. Open a web browser and navigate to https://dotnet.microsoft.com/en-us/download.
21
21
2. Click the *Download .NET SDK x64* button to start the download of the .NET SDK Installer.
22
22
3. Once the download finishes, run the installer
23
23
24
-
### macOS
24
+
### [macOS](#tab/macos)
25
25
1. Open a web browser and navigate to https://dotnet.microsoft.com/en-us/download.
26
26
2. Click the *Download .NET SDK x64 (Intel)* button start the download of the .NET SDK Installer
27
27
3. Once the download finishes, run the installer.
28
28
29
29
> [!NOTE]
30
30
> For the time being, MonoGame requires that you install the **Intel** version even if you are using an Apple Silicon (M1/M2) Mac. For Apple Silicon Macs, it also requires that [Rosetta](https://support.apple.com/en-us/HT211861) is enabled.
31
31
32
-
### Linux
32
+
### [Linux](#tab/linux)
33
33
1. Open a new *Terminal* window
34
34
2. Enter the following command to install the .NET SDK
After installing the .NET SDK, if you intend to target mobile devices such as Android or iOS, you will also need to install the corresponding mobile workloads. To do this, open a *Command Prompt* or *Terminal* window and enter the following commands
@@ -60,23 +62,27 @@ dotnet new install MonoGame.Templates.CSharp
60
62
61
63
To install VSCode, follow the instructions for your operating system below:
62
64
63
-
### Windows
65
+
### [Windows](#tab/windows)
66
+
64
67
1. Open a browser and navigate to https://code.visualstudio.com/.
65
68
2. Click the *Download for Windows* button to start the download of the installer.
66
69
3. Once the download finishes, run the installer.
67
70
68
-
### macOS
71
+
### [macOS](#tab/macos)
69
72
70
73
1. Open a web browser and navigate to https://code.visualstudio.com/.
71
74
2. Click the *Download for macOS* button to start the download of the *.zip* archive.
72
75
3. Once the download finishes, double click the *.zip* archive to extract the *Visual Studio Code.app* application package
73
76
4. Drag-and-drop the *Visual Studio Code.app* application package into your *Application* directory to make it available in the macOS *LaunchPad*.
74
77
75
-
### Linux
78
+
### [Linux](#tab/linux)
79
+
76
80
1. Open a web browser and navigate to https://code.visualstudio.com/.
77
81
2. Click the *.deb* download button to download the package for Debian based Linux distributions, or the *.rpm* download button for Red Hat based Linux distributions.
78
82
3. Once the download finishes, open the package downloaded to install.
79
83
84
+
---
85
+
80
86
## Install the C# Dev Kit Extension
81
87
82
88
For C# development using VSCode, it's recommended to use the official *C# Dev Kit* extension provided by Microsoft. Installing this extension will add additional features to VSCode such as a project system and *Solution Explorer* for C# projects. It also provides code editing features such as syntax highlighting, code completion, code navigation, refactoring, NuGet package management, and debugging tools.
@@ -105,7 +111,13 @@ To install it, with VSCode open:
105
111
106
112
*Effect* (shader) compilation requires access to DirectX. This means it will not work natively on macOS and Linux systems, but it can be used through [WINE](https://www.winehq.org/). MonoGame provides a setup script that can be executed to setup the WINE environment. Below you can find the steps based on your operating system. To do this, follow the instructions for your operating system below:
107
113
108
-
### macOS
114
+
### [Windows](#tab/windows)
115
+
116
+
> [!NOTE]
117
+
> Setting up WINE for effect compilation is not required for Windows
118
+
119
+
### [macOS](#tab/macos)
120
+
109
121
Open a new *Terminal* window and enter execute the following commands:
> After performing these steps, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
131
+
132
+
### [Linux](#tab/linux)
133
+
118
134
Open a new *Terminal* window and execute the following commands:
> After performing these steps, regardless of macOS or Linux, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
142
+
> After performing these steps, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
0 commit comments