使用 Microsoft.UI.Xaml 解决 UWP 控件和对老版本 Windows 10 的兼容性问题-阿里云开发者社区

Windows 10 的兼容性问题

在创建 UWP 应用的时候，我们可以选择目标版本和最低版本。目标版本决定了我们能使用的最新 API，最低版本决定了我们需要支持的最低版本的 Windows 10。

选择目标版本和最低版本
▲ 图中目标版本为 17134，最低版本为 14393。事实上，目标版本必须是 17134，最低只能支持到 14393。

然而，每一次新版本 Windows 10 的推出，都带来大量新的开发 API。可以去官方文档 Choose a UWP version - UWP app developer - Microsoft Docs 了解各个版本 Windows 10 新增的功能简介。

微软在 Windows 10 16299 版本带来了 XAML 条件编译，用以在 XAML 中兼容不同版本的 Windows 10，然而这意味着必须选择 16299 作为最低 API 版本才能正常使用此功能。当然，XAML 条件编译还是带来了不少方便的特性呢，阅读 win10 uwp xaml 兼容多个版本条件编译 - 林德熙可以了解 XAML 条件编译的使用方法，顺便收获一只猫。

Windows 10 也在各个版本新增了一些控件。那么问题来了，要支持最低版本就不能使用新控件。Windows 10 又不像 iOS 那样更新率高，意味着根本不能使用新控件进行开发。

Microsoft.UI.Xaml 库

于是微软就推出了在上推出了 NuGet 包 [Microsoft.UI.Xaml](https://www.nuget.org/packages/Microsoft.UI.Xaml)。

使用此包，你需要将 UWP 的 目标版本设为 17134 ，支持的 最低版本只能到 14393 ，不能更低。

官方对此包的描述为：

This package provides backward-compatible versions of Windows UI features including UWP XAML controls, and Fluent styles and materials. It is part of the Windows UI Library.

即提供各种 Windows UI 功能的向后兼容性，包括 UWP XAML 控件、Fluent 流畅设计样式和画刷。当然，不支持亚克力效果的系统版本虽然画刷能用，不崩溃，但也没有效果的。

Microsoft.UI.Xaml 的上手方法

安装 Microsoft.UI.Xaml 后，Visual Studio 会自动打开 readme.txt 文件提示我们用法：

Thanks for installing the WinUI nuget package! Don’t forget to add this to your app.xaml:

<Application.Resources>
    <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls"/>
</Application.Resources>
See http://aka.ms/winui for more information.
即我们需要在 App.xaml 文件中添加 <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls"/> 作为应用程序的全局资源。不过，官方文档 Getting started with the Windows UI library 中有对此更详细的描述。
如果我们是新 UWP 程序，这样写是没问题的：
<Application>
    <Application.Resources>
        <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls"/> 
    </Application.Resources>
</Application>
但如果基于原有的程序进行兼容性改造，可能原 Application 中已经有资源了，就必须换一种写法：
<Application>
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <XamlControlsResources  xmlns="using:Microsoft.UI.Xaml.Controls"/>
            </ResourceDictionary.MergedDictionaries> 
        </ResourceDictionary>
    </Application.Resources>
</Application>
当然，以上这种改造在各种 XAML 上的行为都是一样的，比如我在 StackOverflow 上回答的问题 Use ResourceDictionary with other Styles in WPF 也是这样的改法，其中说明了必须这样修改的原因。
不过没有结束，在需要使用到新版本 Windows 10 控件的 XAML 文件中，需要添加命名空间前缀：
xmlns:controls="using:Microsoft.UI.Xaml.Controls"
这样才能在 XAML 中使用 Microsoft.UI.Xaml 库中的新控件：
    <controls:NavigationView x:Name="WalterlvDemoView">
        <controls:NavigationView.MenuItems>
            <ListViewItem Content="Home" />
            <ListViewItem Content="Demo" />
            <ListViewItem Content="About" />
            <ListViewItem Content="https://walterlv.github.io/" />
        </controls:NavigationView.MenuItems>
    </controls:NavigationView>
</Grid>
还记得本文开头那张 Visual Studio 的兼容性提示图片吗？使用了 Microsoft.UI.Xaml 库之后，不会再有提示了。这不是欺骗，是真的具备了对早期系统的兼容性。
于是，一些广泛使用的 UWP 应用终于不用各种自己写控件来兼容低版本的 Windows 10 了。
当然除了在 XAML 中，也可以在 C# 代码中使用库中的新 API。
解决意料之外的错误
一切可以那么顺利？不一定，你可能在刚刚把 <XamlControlsResources /> 加入之后，就会发现程序启动即崩溃了……
然后提示：
System.Runtime.InteropServices.COMException
HResult=0x80004005
Message=Error HRESULT E_FAIL has been returned from a call to a COM component.
Source= StackTrace:
不得不说，微软再一次把内部错误暴露了出去。实际的错误原因是 —— 目标 SDK 需要设置为 17134—— 这是必须的！
当然，这个版本号并不是跟随系统的，而是跟随 Microsoft.UI.Xaml 库的。库如果更新有新系统的控件，那么你更新库之后就需要再次更新目标 SDK 版本了。
本文会经常更新，请阅读原文： https://walterlv.com/post/getting-started-with-microsoft-ui-xaml.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。
                C#实现操作Windows窗口句柄：遍历、查找窗体和控件【窗口句柄最全总结之一】
            C#对Windows窗口或窗口句柄的操作，都是通过 P/Invoke Win32 API 实现的，DllImport引入Windows API操作窗口(句柄)，可以实现枚举已打开的窗口、向窗口...
                WindowsXamlHost：在 WPF 中使用 UWP 的控件（Windows Community Toolkit）
            原文 WindowsXamlHost：在 WPF 中使用 UWP 的控件（Windows Community Toolkit）
Windows Community Toolkit 再次更新到 5.0。
                自动启动 Windows 10 UWP 应用
            原文: https://docs.microsoft.com/zh-cn/windows/uwp/xbox-apps/automate-launching-uwp-apps
开发人员有多种选项可用于实现自动启动通用 Windows 平台 (UWP) 应用。
            原文:UWP 判断windows mobile是使用的实体键还是虚拟按键
最近在写启动屏幕，发现虚拟按钮会挡住，启动屏幕的最下面的元素，大概有50 px。可是有什么办法知道手机是用的实体键还是虚拟按键吗？
                背水一战 Windows 10 (79) - 自定义控件: Layout 系统, 控件模板, 事件处理
            原文:背水一战 Windows 10 (79) - 自定义控件: Layout 系统, 控件模板, 事件处理
[源码下载]
背水一战 Windows 10 (79) - 自定义控件: Layout 系统, 控件模板, 事件处理
作者：webabcd介绍背水一战 Windows 10 之 控件（自...
                背水一战 Windows 10 (77) - 控件（控件基类）: ContentControl, UserControl, Page
            原文:背水一战 Windows 10 (77) - 控件（控件基类）: ContentControl, UserControl, Page
[源码下载]
背水一战 Windows 10 (77) - 控件（控件基类）: ContentControl, UserControl, Page
作者：w...
                背水一战 Windows 10 (76) - 控件（控件基类）: Control - 基础知识, 焦点相关, 运行时获取 ControlTemplate 和 DataTemplate 中的元素
            原文:背水一战 Windows 10 (76) - 控件（控件基类）: Control - 基础知识, 焦点相关, 运行时获取 ControlTemplate 和 DataTemplate 中的元素
[源码下载]
背水一战 Windows 10 (76) - 控件（控件基类）: Control -...
                背水一战 Windows 10 (74) - 控件（控件基类）: UIElement - 与 CanDrag 相关的事件, 与 AllowDrop 相关的事件
            原文:背水一战 Windows 10 (74) - 控件（控件基类）: UIElement - 与 CanDrag 相关的事件, 与 AllowDrop 相关的事件
[源码下载]
背水一战 Windows 10 (74) - 控件（控件基类）: UIElement - 与 CanDrag 相关的事...
                背水一战 Windows 10 (75) - 控件（控件基类）: FrameworkElement - 基础知识, 相关事件, HorizontalAlignment, VerticalAlignment
            原文:背水一战 Windows 10 (75) - 控件（控件基类）: FrameworkElement - 基础知识, 相关事件, HorizontalAlignment, VerticalAlignment
[源码下载]
背水一战 Windows 10 (75) - 控件（控件基类）: Fra...
                背水一战 Windows 10 (73) - 控件（控件基类）: UIElement - 拖放的基本应用, 手动开启 UIElement 的拖放操作
            原文:背水一战 Windows 10 (73) - 控件（控件基类）: UIElement - 拖放的基本应用, 手动开启 UIElement 的拖放操作
[源码下载]
背水一战 Windows 10 (73) - 控件（控件基类）: UIElement - 拖放的基本应用, 手动开启 UIEle...
UWP Windows历史上最漂亮的UWP框架出炉！！！
本框架基于微软的开源项目WTS开发，并在其基础上增加了FDS（流畅设计元素，高光、亚克力等）、多语言系统、沉浸式体验（扩展内容到标题栏）
同时又保留了WTS的强大扩展性，你可以添加你所需要的页面，来快速定制自己个性化的App。