WinUIIslands.Templates 1.1.2

WinUI Islands

WinUI Islands brings UWP XAML and WinUI 2 controls to unpackaged .NET 10 desktop applications. It provides a native Win32 window host, XAML Islands startup, custom title bars, backdrop support, AppWindow-style APIs and a NativeAOT-compatible build pipeline. Support Windows 10 version 1903 (build 18362) and later.

Why WinUI Islands

• Deployment size: 14.83 MiB across 3 files with ARM64 NativeAOT, versus 129.45 MiB across 198 files with self-contained JIT.
• Runtime memory: About 9.2 MiB idle private working set.
• Cold start: Faster than WinUI 3.
• Fast fixes: Build our own framework for quickly fix issues (There is no window-resize flickering issue in WinUIIslands).
• WinUI 3-aligned APIs: Closely follows WinUI 3 API design for easy migration from UWP or WinUI 3.
• MISC: No MSIX required. Custom TitleBar, Mica/Acrylic, and anything you want.

Quick start with the template

Install the template package:

dotnet new install WinUIIslands.Templates

Create an application:

dotnet new winuiislands -n HelloIslands
cd HelloIslands

XAML projects must be built with Visual Studio MSBuild because they use the Windows UWP XAML compiler. From a Visual Studio Developer PowerShell or Developer Command Prompt:

msbuild .\HelloIslands.csproj /restore /m /p:Configuration=Debug /p:Platform=x64
.\bin\x64\Debug\net10.0-windows10.0.26100.0\HelloIslands.exe

Use ARM64 or x86 instead of x64 when appropriate.

Publish a self-contained NativeAOT build:

msbuild .\HelloIslands.csproj /t:Publish /restore /m `
  /p:Configuration=Release `
  /p:Platform=x64 `
  /p:RuntimeIdentifier=win-x64

The application is written to:

bin\x64\Release\net10.0-windows10.0.26100.0\win-x64\publish\

Build this repository

dotnet build .\WinUIIslands\WinUIIslands.csproj
msbuild .\App1\App1\App1.csproj /restore /m /p:Configuration=Debug /p:Platform=x64

License

MIT