Microsoft has just released Windows App SDK 1.0.0-Preview3, a toolkit that enables desktop app developers to build apps with a modern Windows user interface, APIs, and platform features.
The main new feature in SDK version 1.0.0-Preview 3 is support for deploying WinUI 3 applications without an MSIX package. Please see the instructions for Unpackaged WinUI 3 Desktop Applications to configure your WinUI 3 application to support unpackaged deployment.
- Unpackaged WinUI 3 applications are only supported on Windows versions 1909 and later.
- Unpackaged WinUI 3 applications are supported on x86 and x64, Arm64 support will be added in the next stable release.
- MSIX packaging tools for a single project for VS 2019 or VS 2022 is required for unpackaged applications.
- In an unzipped application, you may receive a prompt to install .NET 3.5; if you do, you can ignore it.
- Some APIs are currently not supported in unpackaged applications. We aim to fix this issue in the next stable release. Some examples :
- ListView, CalendarView, and GridView controls use incorrect styles and we aim to fix this in the next stable release.
For more information or to start developing with WinUI, see:
Other limitations and known issues
- Unpackaged apps not supported on Windows 10, version 1809: We aim to fix this problem in the next stable release.
- C # Single Project MSIX application does not compile if C ++ UWP tools are not installed: If you have a C # single-project MSIX project, you will need to install the C ++ Universal Windows Platform Tools (v14x) optional component.
- This version presents the Blank, packaged application (WinUI 3 in the desktop) templates for C # and C ++ projects. These templates allow you to build your app in an MSIX package without the use of a separate packaging project. These models have known issues in this release:
- Missing publish menu item until you restart VS: when creating a new app in VS 2019 and VS 2022 using the Blank, packaged application (WinUI 3 in the desktop) project template, the command to publish the project does not appear on the menu until you close and reopen Visual Studio.
- Error adding C ++ static / dynamic library project references to C ++ applications using single project MSIX wrapper: Visual Studio displays an error stating that the project cannot be added as a reference because the project types are not compatible.
- Error referencing a custom user control in a class library project: The application will crash with the error that the system cannot find the specified path.
- C # template for Visual Studio 2019. You will encounter the error when you attempt to build the project: “The project does not know how to run the profile name of the projectTo resolve this issue, install the Single-project MSIX Packaging Tools extension.
- C # template for Visual Studio 2019 and Visual Studio 2022. You will encounter the following error when attempting to run or debug your project on your development machine: “The project must be deployed before we can debug.” Please enable deployment in configuration manager. To resolve this issue, enable deployment for your project in Control panel. For detailed instructions, see the instructions for creating a WinUI 3 desktop app with C # and Windows App SDK 1.0 Preview 2.
- C ++ template for Visual Studio 2022 version 17.0 through Preview 4. You will encounter the following error the first time you try to run your project: “There were deployment errors”. To resolve this problem, run or deploy your project a second time. This issue will be fixed in Visual Studio 2022 version 17.0 Preview 7.
- No support for any processor build configuration: When adding the Windows Application SDK to an existing .NET application or component that supports Any processor, you must specify the desired architecture:
- C # projects using 1.0 Preview 3 must use the following .NET SDK: .NET 5 SDK version 5.0.400 or later if you are using Visual Studio 2019 version 16.11.
- If you want
co_awaitOn the DispatcherQueue.TryEnqueue method, use the resume_foreground helper function in the Windows Implementation Library (WIL):
- Add a reference to the Microsoft.Windows.ImplementationLibrary NuGet package.
- Add the
#includeinstruction in your code file.
Learn more and find download links from Microsoft here.