Skip to content

Add upgrade instructions for new native backends #292

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
CartBlanche merged 1 commit into from
Jul 18, 2026
Merged

Add upgrade instructions for new native backends #292

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 38 additions & 2 deletions website/content/blog/2026-07-15-3.8.5-release-2026.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,42 @@ Since this code is shared with Xbox it means less work for our maintainers and c

This gives us a new target platform on PC that is Microsoft GDK compatible and can be used in a release on the Microsoft Store or PC Game Pass.

## Upgrading your projects

If you want to experiment with the new native backends you can replace your existing DesktopGL/WindowsDX `PackageReference` entires in your .csproj with the following.

### DesktopVK

Add a `MonoGamePlatform` property, this tells the Content system which platform you are building for.

```xml
<MonoGamePlatform>DesktopVK</MonoGamePlatform>
```

The *replace* you existing `DesktopGL` package reference with the following

```xml
<PackageReference Include="MonoGame.Framework.Native" Version="3.8.*" />
<PackageReference Include="MonoGame.Runtime.MacOS.Vulkan" Version="3.8.*" />
<PackageReference Include="MonoGame.Runtime.Linux.Vulkan" Version="3.8.*" />
<PackageReference Include="MonoGame.Runtime.Windows.Vulkan" Version="3.8.*" />
```

### WindowsDX12

Add a `MonoGamePlatform` property, this tells the Content system which platform you are building for.

```xml
<MonoGamePlatform>WindowsDX12</MonoGamePlatform>
```

The *replace* you existing `WindowsDX` package reference with the following

```xml
<PackageReference Include="MonoGame.Framework.Native" Version="3.8.*" />
<PackageReference Include="MonoGame.Runtime.Windows.DX12" Version="3.8.*" />
```

## New Content Builder

In 3.8.5 we included the first release of our new Content Builder system.
Expand Down Expand Up @@ -135,6 +171,6 @@ The team is excited to get moving on 3.8.6. It will mainly serve as hardening o

## Feedback

Any feedback or questions should be directed to the [MonoGame Discord Forum here](https://discord.com/channels/355231098122272778/1429828570993266778)
Any feedback or questions should be directed to the [MonoGame Discord Forum here](https://discord.com/channels/355231098122272778/1456336483991425065)

{% include 'partials/_blog_footer.njk' %}
{% include 'partials/_blog_footer.njk' %}
Loading