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/migration/updating_versions.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,10 +5,10 @@ description: A guide on updating MonoGame when a new release is pushed.
5
5
6
6
When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates.
7
7
8
-
# Update dotnet Templates
8
+
##Update dotnet Templates
9
9
Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli.
10
10
11
-
## Visual Studio 2022
11
+
###Visual Studio 2022
12
12
Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following
13
13
14
14
1. Open Visual Studio 2022
@@ -18,7 +18,7 @@ Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Tem
18
18
19
19
If prompted to close Visual Studio to finish the update, do so now to continue installing the update.
20
20
21
-
## dotnet CLI (VSCode/Rider)
21
+
###dotnet CLI (VSCode/Rider)
22
22
Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates
23
23
24
24
```sh
@@ -30,16 +30,16 @@ The templates must be uninstalled first before the updated tempaltes are install
30
30
31
31
Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command.
32
32
33
-
# Update Existing Projects
33
+
##Update Existing Projects
34
34
Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment
35
35
36
-
## Visual Studio 2022
36
+
###Visual Studio 2022
37
37
Open your existing project in Visual Studio 2022 and perform the following
38
38
1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...".
39
39
2. In the NuGet Packages Manager window, click the *Updates* tab.
40
40
3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right.
41
41
42
-
## Manually Editing .csproj File
42
+
###Manually Editing .csproj File
43
43
Alternatively, regardless of the development environment, developers can manually edit the *.csproj* file for their project to update to the newest MonoGame release. To do this
44
44
1. Open your project's *.csproj* file
45
45
2. Locate the `<PacakgeReference>` elements for any MonoGame referenced packages.
@@ -53,7 +53,7 @@ dotnet clean
53
53
dotnet restore
54
54
```
55
55
56
-
## Update MGCB Editor
56
+
###Update MGCB Editor
57
57
Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest version of the *MonoGame Content Builder*. To do this:
58
58
1. Open the *.config/dotnet-tools.json* manifest file located in the project root directory
59
59
2. Update the version specified for each tool to the current version of MonoGame (currently this is `3.8.2.1105`).
0 commit comments