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/getting_started/1_setting_up_your_os_for_development_macos.md
+31-4Lines changed: 31 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,13 +13,34 @@ To develop with MonoGame in C#, you will need to install the .NET SDK. As of Mon
13
13
14
14

15
15
16
+
## Install additional workloads
17
+
18
+
If you intend to also work with platforms such as `Android` or `iOS`, you will need to install the additional .NET workload templates for those platforms which include additional features and simulators to support those platforms. Just run the following commands from the terminal for the platforms below you wish to install.
19
+
20
+
### [Android](#tab/android)
21
+
22
+
```cli
23
+
dotnet workload install android
24
+
```
25
+
26
+
### [iOS](#tab/iOS)
27
+
28
+
```cli
29
+
dotnet workload install ios
30
+
```
31
+
32
+
---
33
+
34
+
> [!NOTE]
35
+
> You can use `dotnet workload search` to detect any other available workloads you wish to use.
36
+
16
37
# Apple Silicon Known Issues
17
38
18
39
For the time being, MonoGame requires that you install the x64 version of the .NET runtime if you are running on an Apple Silicon mac in order to be able to build content. It is also required that [Rosetta](https://support.apple.com/en-us/HT211861) is enabled.
19
40
20
41
1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
21
-
2. Download the .NET Runtime Installer for macOS x64
22
-
3. Once the **.pkg** file finishes downloading, run it and follow the prompts to install the .NET Runtime
42
+
1. Download the .NET Runtime Installer for macOS x64
43
+
1. Once the **.pkg** file finishes downloading, run it and follow the prompts to install the .NET Runtime
23
44
24
45
## Setup Wine For Effect Compilation
25
46
@@ -28,13 +49,19 @@ Effect (shader) compilation requires access to DirectX. This means it will not
28
49
MonoGame provides a setup script that can be executed to setup the Wine environment for Effect (shader) compilation.
3. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net8_mgfxc_wine_setup.sh) script and execute it by entering the following commandin the terminal:
58
+
1. Install `wget` using brew to execute the next script in the following step:
59
+
60
+
```sh
61
+
brew install wget
62
+
```
63
+
64
+
1. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net8_mgfxc_wine_setup.sh) script and execute it by entering the following commandin the terminal:
Copy file name to clipboardExpand all lines: articles/getting_started/1_setting_up_your_os_for_development_ubuntu.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,27 @@ To develop with MonoGame in C#, you will need to install the .NET SDK. As of Mon
16
16
17
17
This will ensure the latest .NET 8 SDK is installed and setup in your environment.
18
18
19
+
## Install additional workloads
20
+
21
+
If you intend to also work with platforms such as `Android` or `iOS`, you will need to install the additional .NET workload templates for those platforms which include additional features and simulators to support those platforms. Just run the following commands from the terminal for the platforms below you wish to install.
22
+
23
+
### [Android](#tab/android)
24
+
25
+
```cli
26
+
dotnet workload install android
27
+
```
28
+
29
+
### [iOS](#tab/iOS)
30
+
31
+
```cli
32
+
dotnet workload install ios
33
+
```
34
+
35
+
---
36
+
37
+
> [!NOTE]
38
+
> You can use `dotnet workload search` to detect any other available workloads you wish to use.
39
+
19
40
## Setup Wine For Effect Compilation
20
41
21
42
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/).
Copy file name to clipboardExpand all lines: articles/getting_started/1_setting_up_your_os_for_development_windows.md
+24-3Lines changed: 24 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,25 +3,46 @@ title: Setting up your OS for development on Windows
3
3
description: This section provides a step-by-step guide for setting up your development environment on Windows.
4
4
---
5
5
6
-
To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
6
+
To develop with MonoGame in C#, you must install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
7
7
8
8
> [!IMPORTANT]
9
9
> If your chosen IDE for development is [Visual Studio](https://visualstudio.microsoft.com/) then you can skip this step as .NET 8 is included with the Visual Studio Installer.
10
10
11
11
## Install .NET 8 SDK
12
12
13
-
You can follow the instructions below based your operating system to install the .NET 8.0 SDK
13
+
You can follow the instructions below based on your operating system to install the .NET 8.0 SDK
14
14
15
15
1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
16
16
17
17

18
18
19
19
2. Click the **.NET SDK x64** download button to download. This will take you to the download page where the **dotnet-sdk-8.x.yyy-win-x64.exe** will download.
20
20
3. When the download completes, run the **dotnet-sdk-8.x.yyy-win-x64.exe** installer and complete the steps to install .NET on your machine.
21
-
4. When the install completes, open a new **Command Prompt** window and run the command `dotnet` to verify the installation was successful.
21
+
4. When the installation completes, open a new **Command Prompt** window and run the command `dotnet` to verify the installation was successful.
If you intend to also work with platforms such as `Android` or `iOS`, you will need to install the additional .NET workload templates for those platforms which include additional features and simulators to support those platforms. Just run the command-line command for the platforms below you wish to install.
28
+
29
+
### [Android](#tab/android)
30
+
31
+
```cli
32
+
dotnet workload install android
33
+
```
34
+
35
+
### [iOS](#tab/iOS)
36
+
37
+
```cli
38
+
dotnet workload install ios
39
+
```
40
+
41
+
---
42
+
43
+
> [!NOTE]
44
+
> You can use `dotnet workload search` to detect any other available workloads you wish to use.
45
+
25
46
## Next Steps
26
47
27
48
Choose from one of the three IDE options on Windows:
0 commit comments