this article will guide you on how to resolve the issue of a missing windows app runtime environment prompt when running non-packaged winui 3 applications on a customer's machine.
The prompt for a missing Windows App Runtime environment on the user's machine appears as follows:
By clicking "Yes," you will be directed to the download page at https://www.php.cn/link/460eb45f1f9b67a58c96a73be551f37b.
To resolve this issue, you can download and install the Windows App Runtime installation package, known as WindowsAppRuntimeInstall.exe.
However, requiring users to install additional files like WindowsAppRuntimeInstall.exe is not ideal for an application. This article will explain how to configure WinUI 3 applications to function like traditional Win32 applications, allowing them to be simply copied and run on a user's machine.
Step 1: Ensure that the Microsoft.WindowsAppSDK NuGet package is at version 1.2 or later. As of June 15, 2023, the latest version available is 1.3.230602002. The WindowsAppSdkUndockedRegFreeWinRTInitialize feature, which helps avoid the aforementioned prompt, was introduced in version 1.2.
Step 2: Modify the csproj project file by setting WindowsAppSDKSelfContained to true and WindowsPackageType to None. When these settings are configured as such, the SDK automatically sets WindowsAppSdkUndockedRegFreeWinRTInitialize to true.
The updated csproj project file would look like this:
WinExe net6.0-windows10.0.19041 enable true x86;x64;x86 win10-x86;win10-x64 true None
After applying these modifications, you can publish the application independently, eliminating the need for users to install the Windows App Runtime environment. The application can be run by simply double-clicking it.
Due to the limited official documentation available on WindowsAppSdkUndockedRegFreeWinRTInitialize and UndockedRegFreeWinRT, I am not well-versed in their specifics. If you're interested in learning more, I recommend further exploration on your own.
