无论是在编写适用于 Windows 10 的新 Windows 应用,还是在迁移现有的 Windows 应用商店应用,都可以按照同一套过程操作。 若要创建的.NET 本机应用,请执行以下步骤:
-
开发面向 Windows 10 的通用 Windows 平台 (UWP) 应用,测试应用的调试版本以确保其正常工作。
-
手动解决丢失的元数据,并重复步骤 3,直到所有问题都得到解决为止。
Note: 如果要将现有 Windows 应用商店应用程序迁移到.NET Native,请确保查看Windows 应用商店应用迁移到.NET Native。
步骤 1:开发和测试 UWP 应用的调试版本
不管是开发新的应用还是迁移现有应用,均遵循用于任何 Windows 应用的同一流程进行操作。
-
通过使用针对 Visual C# 或 Visual Basic 的通用 Windows 应用模板,在 Visual Studio 中创建新的 UWP 项目。 默认情况下,所有 UWP 应用程序均以 CoreCLR 为目标,且其发布版本通过使用 .NET Native 工具链进行编译。
-
请注意,使用 .NET Native 工具链和不使用它来编译 UWP 应用项目之间存在一些已知的兼容性问题。 有关更多信息,请参阅 迁移指南 。
现在,您可以编写C#或 Visual Basic 代码针对.NET Native 运行在本地系统上 (或在模拟器中) 的图面区域。
Important: 开发你的应用时,在代码中用任何序列化或反射时都应提起注意。
默认情况下,调试版本中都是 JIT 编译,以启用快速 F5 部署,而发布版本编译使用.NET Native 的预编译技术。 这意味着在使用 .NET Native 工具链来编译应用的调试版本之前,应生成和测试它们以确保其正常工作。
步骤 2:处理额外的反射和序列化用法
创建运行时指令文件 Default.rd.xml 时,会将其自动添加到项目中。 如果在 C# 中进行开发,则该文件位于项目的 “属性” 文件夹中。 如果在 Visual Basic 中进行开发,则该文件位于项目的 “我的项目” 文件夹中。
Note: 有关提供为何需要运行时指令文件的背景的 .NET 本机编译过程的概述,请参阅 .NET 本机和编译。
运行时指令文件用于定义应用在运行时所需的元数据。 某些情况下,文件的默认版本可能是够用的。 然而,一些依赖于序列化或反射的代码可能需要运行时指令文件中的其他条目。
序列化
有两类序列化程序,并且每一类可能都要求在运行时指令文件中有额外的条目:
-
非基于反射的序列化程序。 在 .NET Framework 类库中找到的序列化程序,比如 xref:System.Runtime.Serialization.DataContractSerializer\ xref:System.Runtime.Serialization.Json.DataContractJsonSerializer和 xref:System.Xml.Serialization.XmlSerializer 类,不依赖反射。 然而,它们需要在基于对象的基础生成的代码得到序列化或反序列化。 有关更多信息,请参阅 Serialization and Metadata中的“Microsoft 序列化程序”部分。
-
第三方序列化程序。 第三方序列化程序库(其中最常见的是 Newtonsoft JSON 序列化程序)通常是基于反射的并且需要在 *.rd.xml 文件中有条目以支持对象序列化和反序列化。 有关更多信息,请参阅 Serialization and Metadata中的“第三方序列化程序”部分。
依赖反射的方法
在某些情况下,代码中对反射的使用是不明显的。 一些常见的 API 或编程模式不被视为是反射 API 的一部分,但依赖反射成功执行。 这包括以下类型实例化和方法构造方法:
-
xref:System.Type.MakeGenericType*?displayProperty=nameWithType 方法
-
xref:System.Array.CreateInstance*?displayProperty=nameWithType 和 xref:System.Type.MakeArrayType*?displayProperty=nameWithType 方法
-
xref:System.Reflection.MethodInfo.MakeGenericMethod*?displayProperty=nameWithType 方法。
有关详细信息,请参阅 APIs That Rely on Reflection。
Note: 运行时指令文件中使用的类型名称必须是完全限定的。 例如,该文件必须指定“System.String”而不是“String”。
步骤 3:部署和测试您的应用程序的发布版本
在更新运行时指令文件之后,你可以重新生成和部署应用的发布版本。 .NET Native 二进制文件位于目录的 ILC.out 子目录中,此目录是在“编译”选项卡下,项目的“属性”对话框的“生成输出路径”文本框中指定的。不在这个文件夹下的二进制代码还没有使用 .NET Native 进行汇编。 彻底测试你的应用,并在其各个目标平台上测试所有方案(包括失败方案)。
如果您的应用程序不正常 (尤其是在情况下它将引发丢失元数据异常或MissingInteropDataException在运行时异常),按照下一步中的说明部分中,步骤 4:手动解决丢失的元数据。 启用最可能的异常可能会帮助发现这些 bug。
您的应用程序时已经测试并调试调试版本,并且确信已消除丢失元数据异常并MissingInteropDataException异常,应测试你的应用作为优化的.NET Native 应用。 为此,请将活动项目配置从“调试”改为“发布”。
步骤 4:手动解决丢失的元数据
您会遇到与.NET Native,在桌面上不会遇到的最常见失败是一个运行时丢失元数据异常, MissingInteropDataException,或MissingRuntimeArtifactException异常。 在某些情况下,元数据的丢失在不可预测的行为中或甚至在应用失败的情况下可以自行显露。 此部分讨论了你该如何通过将指令添加到运行时指令文件来调试和解决这些异常。 有关运行时指令的格式信息,请参阅运行时指令 (rd.xml) 配置文件参考。 添加运行时指令后,应该再次部署并测试应用并解决任何新的 MissingMetadataException、 MissingInteropDataException 和 MissingRuntimeArtifactException 异常,直到不再遇到任何异常为止。
Tip: 在更高级别上指定你的运行时指令,使你的应用能够适应代码变化。 我们推荐在命名空间和类型级别而不在成员级别添加运行时指令。 注意,你可能需要在弹性和编译时间较长的较大二进制代码之间做一个权衡。
当处理一个丢失元数据异常时,请考虑以下问题:
-
应用在发生异常之前正在执行什么操作?
- 例如,它是正在绑定、序列化或反序列化数据?还是正在直接使用反射 API?
-
这是一个孤立情形吗?或者你是否认为针对其他类型时也会遇到同样的问题?
- 例如,当在应用的对象模型中序列化一个类型时,引发了 丢失元数据异常 异常。 如果你知道其他要得到序列化的类型,可以同时为这些类型(或者为它们包含的命名空间,这要视代码的组织情况而定)添加运行指令。
-
你可以重写代码,不让它使用反射吗?
-
例如,当你知道使用什么类型时代码是否使用了
dynamic关键字? -
当有更好的选择时,代码是否调用了一个依赖反射的方法?
-
Note: 有关处理源于反射和桌面应用程序和.NET Native 中的元数据可用性之间的差异的问题的其他信息,请参阅依赖于反射的 Api。
要了解处理在检测应用的过程中发生的异常和其他问题的特定实例,请参阅:
请参阅
- 运行时指令 (rd.xml) 配置文件参考
- .NET native 安装和配置
- .NET Native 和编译
- 反射和 .NET Native
- 依赖反射的 API
- Serialization and Metadata(序列化和元数据)
- 将 Windows 应用商店应用迁移到 .NET Native
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
