Skip to content

Commit 0f6b06f

Browse files
Update instructions for dotnet workloads, and installing wget on iOS
1 parent 14c831e commit 0f6b06f

File tree

3 files changed

+76
-7
lines changed

3 files changed

+76
-7
lines changed

articles/getting_started/1_setting_up_your_os_for_development_macos.md

Lines changed: 31 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,34 @@ To develop with MonoGame in C#, you will need to install the .NET SDK. As of Mon
1313

1414
![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_8_download_page.png)
1515

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+
1637
# Apple Silicon Known Issues
1738

1839
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.
1940

2041
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
2344

2445
## Setup Wine For Effect Compilation
2546

@@ -28,13 +49,19 @@ Effect (shader) compilation requires access to DirectX. This means it will not
2849
MonoGame provides a setup script that can be executed to setup the Wine environment for Effect (shader) compilation.
2950

3051
1. Install [brew.sh](https://brew.sh)
31-
2. Enter the following command:
52+
1. Enter the following command:
3253

3354
```sh
3455
brew install p7zip curl && brew install --cask wine-stable
3556
```
3657

37-
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 command in 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 command in the terminal:
3865

3966
```sh
4067
wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash

articles/getting_started/1_setting_up_your_os_for_development_ubuntu.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,27 @@ To develop with MonoGame in C#, you will need to install the .NET SDK. As of Mon
1616

1717
This will ensure the latest .NET 8 SDK is installed and setup in your environment.
1818

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+
1940
## Setup Wine For Effect Compilation
2041

2142
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/).

articles/getting_started/1_setting_up_your_os_for_development_windows.md

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,46 @@ title: Setting up your OS for development on Windows
33
description: This section provides a step-by-step guide for setting up your development environment on Windows.
44
---
55

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

88
> [!IMPORTANT]
99
> 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.
1010
1111
## Install .NET 8 SDK
1212

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
1414

1515
1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
1616

1717
![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_8_download_page.png)
1818

1919
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.
2020
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.
2222

2323
![Verify Installation](./images/1_setting_up_your_development_environment/vscode/windows/verify-install.png)
2424

25+
## Install additional workloads
26+
27+
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+
2546
## Next Steps
2647

2748
Choose from one of the three IDE options on Windows:

0 commit comments

Comments
 (0)