According to the information, Microsoft recently released Windows App SDK 1.0.0-Preview 3, which is a toolkit that enables desktop application developers to use modern Windows UI, API and platform feature to build applications.
The following is the updated content of Windows App SDK 1.0.0-Preview 3:
WinUI 3
Windows App SDK 1.0.0-Preview 3 will be the first to support Windows 11 style design, and the main new feature is to support the deployment of WinUI 3 applications without MSIX packaging. Please check the WinUI 3 unpackaged desktop application instructions to configure your WinUI 3 application to support unpackaged deployment.
Known issues:
- Unpackaged WinUI 3 applications only support Windows version 1909 and later versions.
- Unpackaged WinUI 3 applications support x86 and x64, and arm64 support will be added in the next stable version.
- Unpackaged applications require the single-project MSIX packaging tool of VS 2019 or VS 2022.
- In unpackaged applications, you may receive a prompt to install .NET 3.5; if so, you can ignore it.
- Some APIs are currently not supported in unpackaged applications. Microsoft’s goal is to solve this problem in the next stable version. Here are a few examples:
ApplicationData
StorageFile.GetFileFromApplicationUriAsync
ApiInformation ( not supported on Windows 10 )
Package.Current
ListView, CalendarView, and GridView controls are using incorrect styles. The goal is to fix this issue in the next stable version.
For more information or to start using WinUI development, please see:
Windows UI 3 Library (WinUI)
Get started developing apps with WinUI 3
Other limitations and known issues
Unpackaged applications are not supported on Windows 10 version 1809: the goal is to solve this problem in the next stable version.
If the C++ UWP tool is not installed, the C#Single-project MSIX application cannot be compiled. If you have a C#Single-project MSIX project, you need to install the optional components of C++ (v14x) Universal Windows Platform (UWP) tools.
This version introduces a blank application, packaged (WinUI 3 desktop version) template for C# and C++ projects. These templates enable you to build the application into an MSIX package without the need to use a separate packaging project. In this version, these templates have some known issues.
The release menu item is missing before restarting VS: When using a blank application in VS 2019 and VS 2022, packaging (WinUI 3 desktop version) project template to create a new application, the command to publish the project will not appear in the menu until you close and restart Open Visual Studio.
Error when adding C++ static/dynamic library project reference to C++ application using Single-project MSIX packaging: Visual Studio displays an error, the project cannot be added as a reference due to incompatible project types.
An error occurred while referencing a custom user control in a class library project: the application will crash. The error is that the system cannot find the specified path.
C# template for Visual Studio 2019: When you try to build a project, you will encounter such an error. “The project does not know how to run the configuration file project name”. In order to solve this problem, please install the Single-project MSIX packaging tool extension .
C# template for Visual Studio 2019 and Visual Studio 2022: When you try to run or debug your project on the development computer, you will encounter the following error. “This project needs to be deployed before debugging. Please enable deployment in Configuration Manager”. To solve this problem, please enable deployment for your project in the configuration manager. For detailed instructions, please refer to the instructions for creating WinUI 3 desktop applications using C# and Windows App SDK 1.0 Preview 2 .
C++ templates for Visual Studio 2022 version 17.0 until Preview 4: When you first try to run the project, you will encounter the following error. “A deployment error has occurred.” To solve this problem, please run or deploy your project a second time. This problem will be fixed in Visual Studio 2022 version 17.0 preview.
Does not support any CPU build configuration: When adding the Windows App SDK to an existing .NET application or component that supports any CPU, you must specify the required architecture: x86, x64, or arm64.
C# projects using 1.0 Preview 3 must use the following .NET SDK: If you are using version 16.11 of Visual Studio 2019, use .NET 5 SDK 5.0.400 or higher.
If you want to co_await the DispatcherQueue.TryEnqueue method, please use the resume_foreground helper function in the Windows Implementation Library (WIL) :
1 Add a reference to the Microsoft.Windows.ImplementationLibrary NuGet package.
2 Add #include <wil/cppwinrt.h> to your code file.
3 Use wil::resume_foreground (your_dispatcher); to co_await the result.
