Mile.Xaml is the lightweight XAML Islands toolchain with the Windows 11 controls styles. It was originally created for improving the development and deployment experience in modernization of NanaZip. For validating the usability of this, NanaBox and NanaGet were also created.
- Provide XAML Compiler, XAML Designer and XAML Hot Reload support.
- Provide Windows 11 XAML controls styles for Windows Runtime XAML controls.
- Provide C/C++ projects, .NET Framework (Visual Studio 2022 Version 17.9.0 or later), and Modern .NET (.NET 8.0 or later) projects support.
- Integrate all features from Microsoft.Toolkit.Win32.UI.XamlApplication.
- Provide support for responding to Windows theme changes from dark to light or vice versa at run time.
- Integrate several XAML Islands workarounds.
- Provide Mile.Xaml.ContentWindow window class for simplifying the development.
- Provide immersive Mica effect support Mile.Xaml.ContentWindow window class.
- Provide Win32 context menu dark mode support.
- Use VC-LTL 5.x toolchain to make the binary size smaller.
- Provide NuGet package.
You only need to search and add Mile.Xaml package in your NuGet client.
There are some samples that demonstrate using XAML Islands with Mile.Xaml. We hope it can help you develop applications with Mile.Xaml and enjoy the beauty of XAML Islands.
If you don't want to deploy Windows 11 XAML controls styles for Windows Runtime
XAML controls (Mile.Xaml.Styles.SunValley.xbf) to your project's output folder,
please set <MileXamlNoSunValleyXamlStyle>true</MileXamlNoSunValleyXamlStyle>
in your project configuration file.
Modern .NET support is based on the official UWP Support in .NET 9 SDK, which requires the following components:
- .NET 9.0 SDK
- Visual Studio 2022 v17.12
- Windows 11 SDK 26100.1882
Warning: the MSI version of Windows 11 SDK (and the 26100 SDK provided in VS) is still at 26100.1742, which does not support the C#/WinRT mode of UWP XAML compiler.
If you installed it, you may see similar errors during build:
error MSB4064: The "UsingCsWinRT" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.Windows.UI.Xaml.Build.Tasks, Version=0.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35 from the path: C:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\XamlCompiler\Microsoft.Windows.UI.Xaml.Build.Tasks.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.
Installing a newer NuGet version of SDK on your project may not work, as VS will still prefer the globally installed version.
To workaround this, you need to manually upgrade the XAML compiler in Windows SDK. Download the standalone XAML compiler from Microsoft and follow the instructions in the README file.
- Supported OS: Windows 10 Version 2004 (Build 19041) or later
- Supported Platforms: x86, x86-64(AMD64) and ARM64
Note: This list sort in alphabetical order.
- AndromedaMelody, https://github.com/AndromedaMelody
- driver1998, https://github.com/driver1998
- Kenji Mouri, https://github.com/MouriNaruto
- Yifei Gao (高怡飞), https://github.com/Gaoyifei1011
