Merge pull request #21471 from unoplatform/dev/agzi/MigrationDocsUpdates

docs: Update migration guides for Uno 6.3 (.NET 10 support, dropped .NET 8) and misc adjustments

Author: agneszitte

doc/articles/Assets/quick-start/live-wizard-03-create-app.png

@@ -174,7 +174,7 @@ Based on SkiaSharp support, Uno Platform provides AnimatedVisualPlayer to give t
 
 ## Performance and app size with AOT/Jiterpreter
 
-Uno Platform allows to use .NET 8 features such as Profiled AOT (Ahead Of Time compilation) and the Jiterpreter, to get better performance for your apps and balanced size. Profiled AOT is a powerful feature that allows to continue using the interpreter for code that is not often used, thus keeping your app's size down.
+Uno Platform allows to use .NET 9+ features such as Profiled AOT (Ahead Of Time compilation) and the Jiterpreter, to get better performance for your apps and balanced size. Profiled AOT is a powerful feature that allows to continue using the interpreter for code that is not often used, thus keeping your app's size down.
 
 ## Comprehensive App Packaging for All Platforms
 
@@ -283,7 +283,7 @@ As Uno Platform grows, the team behind it grows as well. The product is in good
 
 ## Integrates with any .NET Library
 
-In addition to the UI components mentioned above, Uno Platform apps also integrate perfectly with your existing .NET libraries. This includes both .NET Standard 2.0 and libraries targeting .NET 6, up to the latest with .NET 8. Because of this, your Uno Platform app has compatibility with packages like Json.NET, LiteDB, SQLite, and SkiaSharp.
+In addition to the UI components mentioned above, Uno Platform apps also integrate perfectly with your existing .NET libraries. This includes both .NET Standard 2.0 and libraries targeting .NET 6, up to the latest .NET version. Because of this, your Uno Platform app has compatibility with packages like Json.NET, LiteDB, SQLite, and SkiaSharp.
 
 ## The Community
 

doc/articles/Assets/quick-start/rider-configure-new-unoplatform-app.png

@@ -40,4 +40,4 @@ Uno Platform applications run on all macOS versions supported by .NET, currently
 
 ## Linux
 
-Uno Platform applications run on Linux distributions and versions where .NET 8 and later are supported, [listed here](https://learn.microsoft.com/dotnet/core/install/linux), using the `net9.0-desktop` target framework. Supported environments are X11 and Framebuffer.
+Uno Platform applications run on Linux distributions and versions where latest .NET versions are supported, [listed here](https://learn.microsoft.com/dotnet/core/install/linux), using the `net9.0-desktop` target framework. Supported environments are X11 and Framebuffer.

doc/articles/concepts/overview/why-uno-platform.md

@@ -1,17 +1,23 @@
-This setting lets you choose the .NET version to target. The default is .NET 9.0, but you can also choose .NET 8.0!
+This setting lets you choose the .NET version to target. The default is .NET 9.0, but you can also choose .NET 10.0!
 
-- #### .NET 8.0
+- #### .NET 9.0
+
+    [.NET 9.0](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-9/overview), the successor to .NET 8, has a special focus on cloud-native apps and performance.
+    As a Standard Term Support (STS) release, it is now supported for **24 months (until November 10, 2026)**. See the [STS latest announcement](https://devblogs.microsoft.com/dotnet/dotnet-sts-releases-supported-for-24-months/) for more details.
 
-    [.NET 8.0](https://learn.microsoft.com/dotnet/core/whats-new/dotnet-8) is the successor to .NET 7. It will be supported for three years (until November 2026) as a long-term support (LTS) release. This is the most stable option for new projects.
+    > [!NOTE]
+    > For **mobile workloads**, there is **no change yet**, support remains at **18 months**. See [MAUI support policy](https://dotnet.microsoft.com/en-us/platform/support/policy/maui) for more details.
 
     ```dotnetcli
-    dotnet new unoapp -tfm net8.0
+    dotnet new unoapp -tfm net9.0
     ```
 
-- #### .NET 9.0
+- #### .NET 10.0
 
-    [.NET 9.0](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-9/overview) the successor to .NET 8, has a special focus on cloud-native apps and performance. It will be supported for 18 months (until May 2026) as a standard-term support (STS) release. This is the default (for both blank and recommended presets).
+    [.NET 10.0](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/overview), the successor to .NET 9, includes improvements in performance, C# 14 support, and long-term platform stability.
+    As a Long Term Support (LTS) release, it will be supported for **three years (until November 2028)**.
+    At the moment, it is in preview and the least stable option for new projects.
 
     ```dotnetcli
-    dotnet new unoapp -tfm net9.0
+    dotnet new unoapp -tfm net10.0
     ```

doc/articles/getting-started/requirements.md

@@ -94,7 +94,7 @@ Once that's printed, go ahead and start profiling:
 dotnet-trace collect --diagnostic-port ~/my-dev-port,connect --format speedscope
 ```
 
-## Profiling .NET Android applications (.NET 8)
+## Profiling .NET Android applications
 
 ### Enable profiling in your application
 

doc/articles/getting-started/wizard/includes/framework.md

@@ -40,17 +40,17 @@ To do so:
         <PropertyGroup>
             <!-- Uncomment each line for each platform that you want to build: -->
 
-            <!-- <OverrideTargetFramework Condition="''!='hint: Windows App Sdk (WinUI)'">net8.0-windows10.0.19041.0</OverrideTargetFramework> -->
-            <!-- <OverrideTargetFramework Condition="''!='hint: Webassembly'">net8.0-browserwasm</OverrideTargetFramework> -->
-            <!-- <OverrideTargetFramework Condition="''!='hint: Desktop'">net8.0-desktop</OverrideTargetFramework> -->
-            <!-- <OverrideTargetFramework Condition="''!='hint: iOS'">net8.0-ios</OverrideTargetFramework> -->
-            <!-- <OverrideTargetFramework Condition="''!='hint: Android'">net8.0-android</OverrideTargetFramework> -->
-            <!-- <OverrideTargetFramework Condition="''!='hint: TvOS'">net8.0-tvos</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: Windows App Sdk (WinUI)'">net9.0-windows10.0.19041.0</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: Webassembly'">net9.0-browserwasm</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: Desktop'">net9.0-desktop</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: iOS'">net9.0-ios</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: Android'">net9.0-android</OverrideTargetFramework> -->
+            <!-- <OverrideTargetFramework Condition="''!='hint: TvOS'">net9.0-tvos</OverrideTargetFramework> -->
         </PropertyGroup>
     </Project>
     ```
 
-    Make sure to replace `net8.0` and `-windows10.0.19041.0` with the appropriate version from your `.csproj` project.
+    Make sure to replace `net9.0` and `-windows10.0.19041.0` with the appropriate version from your `.csproj` project.
 
 - You can commit `solution-config.props.sample` to your source control.
 - Next, make a copy of `solution-config.props.sample` to `solution-config.props`. This file is [automatically loaded](https://github.com/unoplatform/uno/blob/71f1d5ab067c0dcfad2f4cccd310e506cdeaf6bf/src/Uno.Sdk/targets/Uno.Import.SolutionConfig.props#L9) by the `Uno.Sdk`.

doc/articles/guides/profiling-applications.md

@@ -54,7 +54,7 @@ On Windows (the `net9.0-windows10.0.xxxxx` target framework) using [Windows App
 
 ### Binaries
 
-Uno Platform applications use [.NET 8+](https://learn.microsoft.com/dotnet/core/introduction) and run on all major platforms:
+Uno Platform applications use [.NET 9+](https://learn.microsoft.com/dotnet/core/introduction) and run on all major platforms:
 
 - **Mobile/Desktop**: via .NET for Mobile
 - **Web**: via .NET for WebAssembly

doc/articles/guides/solution-building-single-targetframework.md

@@ -8,7 +8,11 @@ Migrating from .NET 8 to .NET 9 is a generally straightforward process. You may
 To upgrade to .NET 9:
 
 - First, read [What's New in .NET 9](https://learn.microsoft.com/dotnet/core/whats-new/dotnet-9/overview)
-- Install [Visual Studio 17.12 Preview 3](https://visualstudio.microsoft.com/vs/) or later and run [uno.check](xref:UnoCheck.UsingUnoCheck) with the `--pre-major` parameter to install .NET 9.
+- Install/Update the IDE of your choice:  
+  - [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) - minimal version **17.12** or later  
+  - [Visual Studio Code](https://code.visualstudio.com/) - minimal version **1.94** or later with the related [**C# Dev Kit**](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) stable version
+  - [JetBrains Rider](https://www.jetbrains.com/rider/) - minimal version **2024.3** or later
+- Run [uno.check](xref:UnoCheck.UsingUnoCheck) to install .NET 9.
 - Change all your target framework (TFM) references from `net8.0` to `net9.0`, and `net8.0-*` to `net9.0-*`.
 - Delete your bin and obj folders
 

doc/articles/how-uno-works.md

@@ -0,0 +1,23 @@
+---
+uid: Uno.Development.MigratingFromNet9ToNet10
+---
+
+# How to Upgrade from .NET 9 to .NET 10
+
+Migrating from .NET 9 to .NET 10 is a generally straightforward process. Below are some specific adjustments you may need to make to your projects and libraries when upgrading.
+
+To upgrade to .NET 10:
+
+- First, read [What's New in .NET 10](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/overview).
+- Use **[.NET 10 RC1](https://devblogs.microsoft.com/dotnet/dotnet-10-rc-1/)** along with:
+  - **Visual Studio** - the latest version of [Visual Studio 2026 Insiders](https://visualstudio.microsoft.com/insiders/), as recommended by Microsoft in their [announcement](https://devblogs.microsoft.com/dotnet/dotnet-10-rc-1/#🚀-get-started), or later.
+  - **Visual Studio Code** - the latest version of [Visual Studio Code](https://code.visualstudio.com/Download) and the [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension, also recommended by Microsoft in the same [announcement](https://devblogs.microsoft.com/dotnet/dotnet-10-rc-1/#🚀-get-started).
+  - **Rider** - the latest stable version, as .NET 10 support has been available since [Rider 2025.1](https://www.jetbrains.com/rider/whatsnew/2025-1/).
+- Run the latest stable version of [uno.check](xref:UnoCheck.UsingUnoCheck) with the [`--pre-major` parameter](https://aka.platform.uno/uno-check-pre-major) to install .NET 10.
+- Uno Platform provides an updated [Visual Studio extension](https://aka.platform.uno/vs-extension-marketplace) in the store that supports Visual Studio 2026 and the new `.slnx` solution format.
+- Change all your target framework (TFM) references from `net9.0` to `net10.0`, and from `net9.0-*` to `net10.0-*`.
+- Clean your project by deleting the `bin` and `obj` folders.
+
+## Known Issues
+
+For an up-to-date list of **known issues** when using **.NET 10** with Uno Platform, please refer to our [Health Status page](https://aka.platform.uno/health-status).