Skip to content

Commit 409926d

Browse files
Add section on target framework
1 parent 4307d4f commit 409926d

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

articles/migration/updating_versions.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,24 @@ description: A guide on updating MonoGame when a new release is pushed.
66
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.
77

88
## 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.
1010

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
1221
Open your existing project in Visual Studio 2022 and perform the following
1322
1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...".
1423
2. In the NuGet Packages Manager window, click the *Updates* tab.
1524
3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right.
1625

17-
### Manually Editing .csproj File
26+
#### Manually Editing .csproj File (VSCode/Rider)
1827
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
1928
1. Open your project's *.csproj* file
2029
2. Locate the `<PacakgeReference>` elements for any MonoGame referenced packages.

0 commit comments

Comments
 (0)