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
+12-3Lines changed: 12 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -6,15 +6,24 @@ description: A guide on updating MonoGame when a new release is pushed.
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
8
## Update Existing Projects
9
-
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
9
+
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.
10
10
11
-
### Visual Studio 2022
11
+
### Update Target Framework
12
+
Developers will need to ensure the project is updated to target the .NET version used by MonoGame at minimum (currenty `net8.0`). To do this, open your project's *.csproj* file and find the `<TargetFramework>` element and change the `net-X.Y` version to `net-8.0`, then save the file.
13
+
14
+
> [!NOTE]
15
+
> Only change the .NET version number. some projext types have platform specifiers such as `net6.0-windows`. The only thing that should change here is the version number.
16
+
17
+
### Update NuGet References
18
+
The following sections cover updating your NuGet packages for existing projects based om your developmemt environment.
19
+
20
+
#### Visual Studio 2022
12
21
Open your existing project in Visual Studio 2022 and perform the following
13
22
1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...".
14
23
2. In the NuGet Packages Manager window, click the *Updates* tab.
15
24
3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right.
16
25
17
-
### Manually Editing .csproj File
26
+
####Manually Editing .csproj File (VSCode/Rider)
18
27
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
19
28
1. Open your project's *.csproj* file
20
29
2. Locate the `<PacakgeReference>` elements for any MonoGame referenced packages.
0 commit comments