WinUI 3 Preview 4今天发布，它是一个稳定的预览版本，其中包括一些关键的错误修复以及对该框架的其他常规改进。
预览4中引入的功能
- 与WinUI 2.5的奇偶校验（包括InfoBar控件，ProgressRing和NavigationView中的新功能以及错误修复）
- 自定义标题栏功能：新的Window.ExtendsContentIntoTitleBar和Window.SetTitleBar API，允许开发人员在桌面应用程序中创建自定义标题栏。
- VirtualSurfaceImageSource支持
过去的WINUI 3预览版中引入的新功能
WinUI 3 Preview 1-3中引入了以下功能，并在WinUI 3 Preview 4中继续受支持。
- 能够使用WinUI创建桌面应用程序，包括 用于Win32应用程序的 .NET 5
- 径向渐变画笔
- TabView更新
- 黑暗主题更新
- WebView2的改进和更新
- 支持高DPI
- 支持窗口大小调整和移动
- 更新以针对最新版本的Edge
- 不再需要引用特定于WebView2的Nuget包
- 交换链面板
- MRT核心支持
- 这样可以使应用在启动时更快，更轻便，并提供更快的资源查找。
- ARM64支持
- 在应用程序内部和外部拖放
- RenderTargetBitmap（当前仅XAML内容–没有SwapChainPanel内容）
- 自定义光标支持
- 线程外输入
- 改善我们的工具/开发人员经验：
- 实时可视化树，热重载，实时属性资源管理器和类似工具
- WinUI 3的Intellisense
- 开源迁移所需的改进
有关WinUI 3的优点和WinUI路线图的更多信息，请参见 GitHub上的 Windows UI库路线图。
预览4中修复的错误列表
以下是自预览版3以来团队已修复的面向用户的错误列表。围绕稳定性和改进测试的工作也很多。
- 此版本采用了新版本的CS / WinRT和Windows SDK，该版本修复了以下错误：
- 使用{Binding}绑定到URI属性时崩溃
- C＃/ WinRT Marshal函数无法与.NET 5正确互操作
- 在Windows Insider Builds上运行时WinUI 3崩溃
- 感谢多个社区贡献者在GitHub上报告此错误！
- WebView2不会将主机应用的语言/语言环境应用于CoreWebView2Environment
- Windows社区工具包DataGrid控件在开始/滚动条出现时使应用程序崩溃
- 感谢多个社区贡献者在GitHub上报告此错误！
- 当显示模式更改时，页面呈现进入错误状态
- 在CalendarView中使用Language ComboBox时崩溃
- WinUI 3桌面：无法从WebView2中跳出
- WinUI 3桌面：具有派生的TreeViewNodes的TreeView崩溃
- WinUI 3 Desktop：无法在ContentDialog中的TextBox中输入文本
- WinUI 3桌面：ALT和F6不起作用
- 旧的已移除SwapChainPanel呈现在新的SwapChain之上
- WinUI 3 Desktop：无法使用触控板滚动
- 在同一线程上对多个窗口使用NavigationView控件时崩溃
- 辅助功能问题：在WinUI桌面应用程序启动时显示焦点
- 在DataGrid中滚动时访问冲突
- WinUI 3桌面：选项卡循环不起作用
- 在带有WinUI Xaml Islands的桌面应用程序中，在GridView上进行拖放操作失败
- 可访问性问题：在WinUI 3桌面上无法使用PageUp / PageDown键滚动
- WebView2的视口大小错误
- 打开MenuFlyout后，单击时WebView2崩溃
- WinUI 3 Desktop：尝试关闭DropDownButton或SplitButton的弹出按钮会导致应用崩溃
- WebView2：右键单击鼠标会导致崩溃
- 单击ToggleSplitButton导致应用程序崩溃
- WinUI 3桌面：任务栏上可见空的DesktopWindowXamlSource窗口
- WinUI 3桌面：DataGrid不显示
- WinUI 3 Desktop：无法将文件拖放到网格
- WinUI 3桌面：WinXP 3 Preview 2中ItemsRepeater崩溃
- 更新绑定时抛出AccessViolationException
- WinUI 3 Desktop：应用程序在滚动NavigationView时崩溃
- 动态添加或删除其ItemsSource集合中的项目时，ItemsControl不会更新。
- 如果启用了C ++一致性模式，则在App.xaml.gh中编译错误C2760
局限性和已知问题
Preview 4版本只是预览版，其中包含错误，局限性以及与台式机应用程序有关的场景的其他问题，这些都是特别新的。
以下各项是WinUI 3 Preview 4的一些已知问题。
开发者工具
- 仅支持C＃和C ++ / WinRT应用程序
- 桌面应用程序支持.NET 5和C＃9，并且必须打包在MSIX应用程序中
- UWP应用支持.NET Native和C＃7.3
- 开发人员工具和Intellisense在Visual Studio 16.8版中可能无法正常工作。
- 不支持XAML设计器
- 不支持新的C ++ / CX应用程序，但是，您现有的应用程序将继续运行（请尽快移至C ++ / WinRT）
- 桌面应用程序中对多个窗口的支持正在进行中，但尚未完全稳定。
- 如果您发现新问题或具有多窗口行为的回归，请在我们的存储库中提交错误。
- 不支持未打包的桌面部署
- 使用F5运行桌面应用程序时，请确保您正在运行打包项目。在应用程序项目上按F5键将运行一个未打包的应用程序，WinUI 3尚不支持该应用程序。
缺少平台功能
- Xbox支持
- HoloLens支持
- 窗口弹出
- 更具体地说，无论属性值如何，该
ShouldConstrainToRootBounds属性始终像设置为一样起作用true。
- 更具体地说，无论属性值如何，该
- 上墨支持
- 亚克力
- MediaElement和MediaPlayerElement
- MapControl
- SwapChainPanel和非XAML内容的RenderTargetBitmap
- SwapChainPanel不支持透明度
- Global Reveal使用后备行为，坚固耐用
- 此版本不支持XAML群岛
- 第三方生态系统库将无法完全运行
- 输入法无效
已知的问题
- Alt + F4不会关闭桌面应用程序窗口。
- 由于 CoreWindow的更改 ，以下WinRT API可能不再 按预期与桌面应用程序一起使用 ：
-
ApplicationView并且所有相关的API将不再起作用。 -
CoreApplicationView并且所有相关的API将不再起作用。 GetForCurrentView例如，可能不支持所有 APICoreInputView.GetForCurrentView。-
CoreWindow.GetForCurrentThread现在将返回null。
有关在WinUI 3桌面应用程序中使用WinRT API的更多信息，请参阅 桌面应用程序可用的Windows运行时API。
-
- Windows.UI.ViewManagement.UISettings.ColorValuesChanged事件 在桌面应用程序中不再受支持。如果您使用它来检测Windows主题中的更改，则可能会导致问题。
- 此版本包含一些实验性API。这些没有经过团队的彻底测试，可能有未知的问题。 如果您遇到任何问题，请 在我们的存储库中 提交错误。
- 以前，要获取CompositionCapabilities实例，您可以调用 CompositionCapabilites.GetForCurrentView（）。但是，此调用返回的功能 不 依赖于视图。为了解决和反映这一点，我们在此版本中删除了静态的GetForCurrentView（），因此现在您可以 直接创建 CompositionCapabilties对象。
- 对于C＃UWP应用：WinUI 3框架是一组WinRT组件，可以从C ++（使用C ++ / WinRT）或C＃中使用。使用C＃时，有两种版本的.NET，具体取决于应用程序的型号：在UWP应用程序中使用WinUI 3时，您使用的是.NET Native。在桌面应用程序中使用时，您使用的是.NET 5（和C＃/ WinRT）。在UWP中将C＃用于WinUI 3应用程序时，与WinUI 3桌面应用程序或C＃中的C＃相比，API名称空间有所不同WinUI 2应用程序：某些类型在
Microsoft名称空间而不是System名称空间中。例如，INotifyPropertyChanged接口不是在System.ComponentModel名称空间中，而是在Microsoft.UI.Xaml.Data名称空间中，这 适用于：INotifyPropertyChanged（和相关类型）INotifyCollectionChangedICommand
该
System命名空间的版本仍然存在，但不能与WinUI 3.这意味着使用ObservableCollection不工作的，是WinUI 3 C＃应用程序UWP。有关解决方法，请参阅 CollectionsInterop样品 在 XAML控件库样本。
接下来会发生什么？
开发人员可以查看Microsoft的详细 功能路线图， 以了解何时将特定功能引入WinUI 3。
安装WINUI 3 PREVIEW 4
WinUI 3 Preview 4包括Visual Studio项目模板，以帮助您开始使用基于WinUI的用户界面来构建应用程序，以及一个包含WinUI库的NuGet程序包。要安装WinUI 3 Preview 4，请按照下列步骤操作。
Windows社区工具包
如果您使用的是Windows Community Toolkit，请 下载最新版本。
除了 局限性和已知问题外，使用WinUI项目构建应用程序类似于使用XAML和WinUI 2.x构建UWP应用程序。因此， 适用于UWP应用程序和 Windows SDK中Windows.UI WinRT名称空间的大多数 指导文档。
有关WinUI项目模板入门的更多信息，请参见以下文章：
- WinUI 3桌面应用程序入门
- 适用于UWP应用的WinUI 3入门
此版本的API参考文档即将发布，但与此同时，开发人员可以查看 Preview 3的 WinUI 3 API参考文档。
如果使用WinUI 3 Preview 3创建了项目，则可以将项目升级为使用 Preview4 。有关详细说明，请参见 WinUI GitHub存储库。
为了利用WinUI 3 Preview 4中添加的最新工具功能（如热重载，Live Visual Tree和Live Property Explorer），必须将Visual Studio的最新预览版本与最新的WinUI 3预览一起使用，并确保启用Visual Studio预览功能中的WinUI工具，如此处的 说明中所述 。
XAML控件库（WINUI 3 PREVIEW 4分支）
有关 包含所有WinUI 3 Preview 4控件和功能的示例应用程序，请参见 XAML控件库的 WinUI 3 Preview 4分支。
WinUI 3 Preview 4 XAML控件库应用程序的示例
该WinUI 3预览版旨在进行早期评估，并收集开发人员社区的反馈。它应该 不被用于生产应用。微软将继续在2021年之前发布WinUI 3的预览版，然后在2021年3月发布首个受支持的正式版本。
请使用 WinUI GitHub存储库 提供反馈并记录建议和问题。
