[原创]aot 中Rd.xml 文件格式语法中文说明以及处理错误的实战案例

最新推荐文章于 2023-11-21 08:01:47 发布
最新推荐文章于 2023-11-21 08:01:47 发布
阅读量981 收藏
点赞数 1
文章标签： xml microsoft .net javascript java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u010042660/article/details/127362695
版权

Rd.xml 文件格式

CoreRT 提前编译器通过编译应用程序入口点及其传递依赖项来发现要编译的方法和要生成的类型。如果应用程序使用反射，编译器可能会丢失类型。有关该问题的更多信息，请参阅AOT 模式中的反射。可以补充一个 rd.xml 文件来帮助 ILCompiler 找到应该分析的类型。该文件与 .NET Native 使用的 rd.xml 文件类似，但更受限制。

最小的 Rd.xml 配置

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="mscorlib" />
  </Application>
</Directives>

ILCompiler 支持 2 个顶级指令Application或Library. 现在它们都可以互换使用，只需定义实际装配配置发生的区域。您可以在指令中放置多个<Assembly>标签<Application>以单独配置每个程序集。

装配指令

有 3 种形式可以配置组件

  • 仅模块元数据；
  • 所有类型;
  • 模块元数据和选定类型。

模块元数据只需要<Assembly>带有程序集短名称的简单标记。

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="mscorlib" />
  </Application>
</Directives>

程序集中的所有类型都需要添加Dynamic带有 value 的属性Required All。注意：这是此属性的唯一可用值。

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="mscorlib" Dynamic="Required All" />
  </Application>
</Directives>

请注意，如果您在程序集中有泛型类型，则生成的代码中不会出现特定的实例化，如果您需要包含一个，那么您应该使用嵌套<Type>标记包含这些实例化。

模块元数据和选定类型选项基于仅模块元数据模式，其中添加了<Type>标签<Assembly>。

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="MonoGame.Framework">
      <Type Name="Microsoft.Xna.Framework.Content.ListReader`1[[System.Char,mscorlib]]" Dynamic="Required All" />
    </Assembly>
  </Application>
</Directives>

类型指令。

类型指令提供了一种指定所需类型的方法。开发人员在这里有两个选择：

  • 采取所有类型方法；
  • 选择应该植根的方法。

采用所有类型方法：

<Type Name="Microsoft.Xna.Framework.Content.ListReader`1[[System.Char,mscorlib]]" Dynamic="Required All" />

示例如何指定类型名

// just int
System.Int32
// string[]
System.String[]
// string[][]
System.String[][]
// string[,]
System.String[,]
// List<int>
System.Collections.Generic.List`1[[System.Int32,System.Private.CoreLib]]
// Dictionary<int, string>.KeyCollection - notice all the generic arguments go to the nested type
System.Collections.Generic.Dictionary`2+KeyCollection[[System.Int32,System.Private.CoreLib],[System.String,System.Private.CoreLib]]

请注意，将泛型类型放在此处可能没有意义，因为代码是通过泛型类型的特定实例化生成的。无效场景示例：

// List<T>
System.Collections.Generic.List`1

要选择应植根的方法，请添加嵌套<Method>标签。

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="System.Private.CoreLib">
      <Type Name="System.Collections.Generic.Dictionary`2[[System.Int32,System.Private.CoreLib],[System.String,System.Private.CoreLib]]">
        <Method Name="EnsureCapacity" />
      </Type>
    </Assembly>
  </Application>
</Directives>

<Parameter>或者，如果您只想要特定的重载，您可以指定可选标签。例如：

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="System.Private.CoreLib">
      <Type Name="System.Collections.Generic.Dictionary`2[[System.Int32,System.Private.CoreLib],[System.String,System.Private.CoreLib]]">
        <Method Name="EnsureCapacity">
          <Parameter Name="System.Int32, System.Private.CoreLib" />
        </Method>
      </Type>
    </Assembly>
  </Application>
</Directives>

或者如果你想实例化泛型方法，你可以通过<GenericArgument>.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <Assembly Name="System.Private.CoreLib">
      <Type Name="System.Array">
        <Method Name="Empty">
          <GenericArgument Name="System.Int32, System.Private.CoreLib" />
        </Method>
      </Type>
    </Assembly>
  </Application>
</Directives>

请注意，方法通过它们的方法名称和参数来区分。返回值的类型未在方法签名中使用。

生根结构编组数据

该Type指令还支持一个MarshalStructure属性。唯一受支持的MarshalStructure值为Required All。指定MarshalStructure="Required All"将确保预先生成结构编组数据结构。

这可以修复如下代码：

using System;
using System.Runtime.InteropServices;

Console.WriteLine(GetTypeSize(typeof(MyClass)));

// This is in a separate method since the compiler would be able to analyze `Marshal.SizeOf(typeof(MyClass))`,
// but since a method call is involved, the compiler will lose track of the specific type.
static int GetTypeSize(Type t) => Marshal.SizeOf(t);

[StructLayout(LayoutKind.Sequential)]
public class MyClass
{
    public string Field;
}

上面的代码会抛出“System.Runtime.InteropServices.MissingInteropDataException：MyClass 缺少结构编组数据。要启用结构编组数据，请将 MarshalStructure 指令添加到应用程序 rd.xml 文件。”。要修复此异常，可以使用以下 RD.XML：

<Directives>
  <Application>
    <Assembly Name="repro">
      <Type Name="MyClass" MarshalStructure="Required All" />
    </Assembly>
  </Application>
</Directives>

生根委托编组数据

与上面的结构编组数据类似，该Type指令也支持MarshalDelegate属性。唯一受支持的MarshalDelegate值为Required All。指定MarshalDelegate="Required All"将确保预生成委托编组数据结构。

<Directives>
  <Application>
    <Assembly Name="repro">
      <Type Name="MyDelegate" MarshalDelegate="Required All" />
    </Assembly>
  </Application>
</Directives>

MyDelegate上面的 XML 将强制为assembly中的委托类型生成委托编组数据repro。

https://github.com/dotnet/runtimelab/issues/2037

https://github.com/dotnet/runtimelab/issues/702#issuecomment-1279622783

假设错误如下，

System.Reflection.MissingMetadataException: 'System.Text.Json.Serialization.Converters.IEnumerableOfTConverter<System.Collections.Generic.IEnumerable<Swashbuckle.AspNetCore.SwaggerUI.UrlDescriptor>,Swashbuckle.AspNetCore.SwaggerUI.UrlDescriptor>' is missing metadat

拆开理解

image.png

那么语法是：

xxx

实战2 错误

Connection id "0HMLEANFSAK03", Request id"0HMLEANFSAK03:00000004": An unhandled exception was thrownby the application.System.Reflection.MissingMetadataException: 'System.Text.Json.Serialization.Converters.EnumConverter<Swashbuckle.AspNetCore.SwaggerUI.ModelRendering>' is missing metadata. For more information, please visit http://go.microsoft.com/fwlink/?LinkID=392859
提取错误类

System.Text.Json.Serialization.Converters.EnumConverter<Swashbuckle.AspNetCore.SwaggerUI.ModelRendering>

对应的是:<Type Name="System.Text.Json.Serialization.Converters.EnumConverter`1[[Swashbuckle.AspNetCore.SwaggerUI.UrlDescriptor,Swashbuckle.AspNetCore.SwaggerUI]]" Dynamic="Required All" />

aot文件生效的定义

<ItemGroup>
  <RdXmlFile Include="Properties\Default.rd.xml" />
 </ItemGroup>

补充

<Type Name="System.Text.Json.Serialization.Converters.IEnumerableOfTConverter`2[[System.Collections.Generic.IEnumerable`1[[Swashbuckle.AspNetCore.SwaggerUI.UrlDescriptor,Swashbuckle.AspNetCore.SwaggerUI]],mscorlib],[Swashbuckle.AspNetCore.SwaggerUI.UrlDescriptor,Swashbuckle.AspNetCore.SwaggerUI]]"  Dynamic="Required All" />
            <Type Name="System.Text.Json.Serialization.Converters.EnumConverter`1[[Swashbuckle.AspNetCore.SwaggerUI.ModelRendering,Swashbuckle.AspNetCore.SwaggerUI]]" Dynamic="Required All" />
            <Type Name="System.Text.Json.Serialization.Metadata.JsonPropertyInfo`1[[Swashbuckle.AspNetCore.SwaggerUI.DocExpansion,Swashbuckle.AspNetCore.SwaggerUI]]" Dynamic="Required All" />
            <Type Name="System.Text.Json.Serialization.Metadata.JsonPropertyInfo`1[[System.Nullable`1[[System.Int32,mscorlib]],mscorlib]]" Dynamic="Required All" />
            <Type Name="System.Text.Json.Serialization.Converters.NullableConverter`1[[System.Int32,mscorlib]]" Dynamic="Required All" />

2022-10-17

根据运行报错的信息直接复制进来加上[]然后指定 程序集就知道如何编写rd.xml了

辅助编写文档http://go.microsoft.com/fwlink/?LinkID=392859

.net7.0预览版r2配置aot

7.0 r2 支持如下这样配置 而老版本6.0不支持builder.Services.AddControllers().AddJsonOptions(options => options.JsonSerializerOptions.AddContext<MyJsonContext>());

7.0需要删除<PackageReference Include="Microsoft.DotNet.ILCompiler;" Version="7.0.0-*" />
改用 属性启动。
加入如下字段:<PublishAot>true</PublishAot>

<PropertyGroup>
        <PublishAot>true</PublishAot>
        <TargetFramework>net7.0</TargetFramework>
        <Nullable>enable</Nullable>
        <ImplicitUsings>enable</ImplicitUsings>
        <GenerateDocumentationFile>True</GenerateDocumentationFile>
        <Platforms>AnyCPU;x64;ARM64;ARM32</Platforms>
        <PlatformTarget>AnyCPU</PlatformTarget>
        <ErrorReport>send</ErrorReport>
        <IsPackable>false</IsPackable>
        <GeneratePackageOnBuild>False
<PropertyGroup>

7.0的web core api似乎不支持http:*:端口号了，否则提示不支持的url,
7.0目前需要预览版开发工具才能切换，而且切换后 正式版本开发工具将无法打开，因为不兼容修改后的applaunch.jsonhttps://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/
兼容性https://learn.microsoft.com/en-us/dotnet/core/deploying/trimming/incompatibilities

优化体积https://learn.microsoft.com/en-us/dotnet/core/deploying/trimming/trimming-options?pivots=dotnet-7-0
.net7的重大变化https://learn.microsoft.com/en-us/dotnet/core/compatibility/7.0?source=recommendations

image.png

| Assembly.CodeBase | 引发PlatformNotSupportedException。 |
| Assembly.EscapedCodeBase | 引发PlatformNotSupportedException。 |
| Assembly.GetFile | 抛出IOException。 |
| Assembly.GetFiles | 抛出IOException。 |
| Assembly.Location | 返回一个空字符串。 |
| AssemblyName.CodeBase | 退货null。 |
| AssemblyName.EscapedCodeBase | 退货null。 |
| Module.FullyQualifiedName | 返回值为 的字符串<Unknown>或引发异常。 |
| Marshal.GetHINSTANCE | 返回 -1。 |
| Module.Name | 返回值为 的字符串<Unknown>。 |

修复常见场景的建议：

吉凶以情迁
关注
corert-samples：整理一些库使用corert编译时用到的rd.xml
02-25
例如，如果一个库使用了某些不能被CoreRT自动处理的特性或API，那么就需要在rd.xml中显式声明这些依赖，以确保编译成功。 "SignalRDemo"可能是一个使用ASP.NET Core SignalR的示例，SignalR是一个实时通信框架，...
福建澳泰AOT仪表说明书.xdf
11-16
福建澳泰AOT仪表说明书.xdf
读取XML 文件 - Read xml file
aplo23496的博客
12-06 362
public string getReproTid() { string path = AppcompatExtend.AppcompatExtend.ProgramFiles + @"\GFI\WebMonitor\Data\Reports.xml"; // file path if (!File.Exists(path))...
xml的基础格式详解
KevinSilent的博客
09-01 1482
1.1xml的文件结构 文件头和文件体两大结构 文件头：由xml生命和dtd文件类型声明组成。其中dtd文件类型声明是可以省略的。 例如： <?xml version="1.0" encoding="gb2312"?> 其中： “<?”代表一条指令的开始，“?>”代表一条指令的结束； “xml”代表此文件是XML文件； “ version=“1.0” ”代表此文件用的是XM...
.Net 7 Native AOT 单文件 无依赖 跨平台
foreverhot1019的博客
11-29 3676
.Net AOT link.exe不是内部或外部命令
.NET Core跨平台的奥秘[下篇]：全新的布局
过客2019
09-14 704
从本质上讲，按照CLI规范设计的.NET从其出生的那一刻就具有跨平台的基因，这与Java别无二致。由于采用了统一的中间语言，微软只需要针对不同的平台设计不同的虚拟机（运行时）就能弥合不同操作系统与处理器架构之间的差异，但是“理想很丰满，现实很骨感”。在过去十多年中，微软将.NET引入到了各个不同的应用领域，表面上看起来似乎欣欣向荣，但是由于采用完全独立的多目标框架的设计思路，导致针对多目标框架的代码平台只能通过PCL（参考《.NET Core跨平台的奥秘[中篇]：复用之殇》）这种“妥协”的方式来解决。如果依
子类型JSON序列化 mscorlib vs System.Private.CoreLib
xhydongda的博客
08-23 961
问题 如果你需要支持子类反序列化，那么需要用到Newtonsoft.json，并设置 JsonSerializerSettings settings = new JsonSerializerSettings { TypeNameHandling = TypeNameHandling.All } 此时，所生成的 json 字符串在 .net framework(或mono) 与 .net core 之间不能通用。反...
Angular-aot-loader.zip
09-18
Angular-aot-loader.zip,[已弃用]Web包的提前编译器。[已弃用]AOT加载程序,Angularjs于2016年发布，是Angularjs的重写版。它专注于良好的移动开发、模块化和改进的依赖注入。angular的设计目的是全面解决开发人员的...
.NET Core单文件发布静态编译AOT CoreRT的方法详解
01-03
前言 本文主要介绍的是关于.NET Core单文件发布静态编译AOT CoreRT，将.NET Core应用打包成一个可执行文件并包含运行时。 支持Windows, MacOS and Linux x64 w/ RyuJIT codegen。 示例项目： ...下面来实际体验。...
Angular-angular2-aot-webpack.zip
09-18
Angular-angular2-aot-webpack.zip,angular aot（提前）离线编译示例与webpack angular aot（提前）离线编译示例与webpack,Angularjs于2016年发布，是Angularjs的重写版。它专注于良好的移动开发、模块化和改进的...
FreeSql/FreeRedis/FreeScheduler 完成 .NET 8.0 AOT 测试 & 经验分享
最新发布
farway000的博客
11-21 341
2023年11月15日，对 .NET 的开发圈是一个重大的日子，.net 8.0正式版发布。圈内已经预热了有半个月有余，性能不断超越，开发体验越来越完美，早在.net 5.0的时候就各种吹风Aot编译，直到6.0 7.0使用仍然比较麻烦，我个人比较期待本次更新的aot体验。有的群友几个小时都等不了啦，半夜就开始更新预览版，我是等到第二天早上正式布发布才开始的，开机第一件事情下载.net8.0 SD...
记一次 .NET 某流媒体独角兽 API 句柄泄漏分析
一线码农的专栏
08-30 515
一：背景 1. 讲故事 上上周有位朋友找到我，说他的程序CPU和句柄都在不断的增长，无回头趋势，查了好些天也没什么进展，特加wx寻求帮助，截图如下： 看的出来这位朋友也是非常郁闷，出问题还出两个，气人哈，关于 cpu 爆高的问题我准备单独用一篇文章去侦读，这篇就先聊聊 句柄泄漏 的问题，毕竟写了20多篇，也是第一次聊到 handle 泄露，有点意思哈。 2. 什么是句柄 我个人理解的句柄：就是在托管层持有了一个对非托管层资源的引用，有了这个引用，我们就可以强制回收非托管资源，那什么是非托管资源？ 我个人
C# Int ToString 方法原理
杨义权的博客
12-02 1817
过程 平时候我们声明一个整数，ToString的时候是发生什么了呢 1 调用 使用示例，声明整数a,b static void Main(string[] args) { int a = 10; int b = -10; System.Diagnostics.Debug.WriteLine(a.ToString()); System.Diagnostics.Debug.WriteLine(b.ToString());
.net core跨平台的实现
qq_37112587的博客
07-03 952
.net core一、.net framework二、.net framework下不同平台间的代码复用2.1 源代码复用2.2 程序集复用2.3 PCL 一、.net framework .net framework由以下两部分构成 common language runtime(CLR) 公共语言的运行环境，相当于java中的虚拟机 为托管程序提供执行环境，内存管理、垃圾回收等 framework class library(FCL) 由以下两部分构成 basic class librar
Centos7 Process terminated. Infinite recursion during resource lookup within System.Private.CoreLib
qq_32109957的博客
03-22 771
[root@das-aiot ~]# dotnet --info Process terminated. Infinite recursion during resource lookup within System.Private.CoreLib. This may be a bug in System.Private.CoreLib, or potentially in certain extensibility points such as assembly resolve events or Cu
ASP.NET Core 配置分步指南
Cool2Feel的博客
07-22 395
如果您不熟悉 ASP.NET Core 开发，您会注意到的前几件事之一是旧的 web.config 或 app.config 文件在 ASP.NET Core 项目中不再可用。 ASP.NET Core 中的配置是使用一个或多个配置提供程序执行的。有配置提供程序可以从几乎任何地方读取配置，例如文件，例如JSON、INI 或 XML、环境变量、Azure 密钥保管库、命令行参数等以及更多来源。本教程是分步指南，向您展示如何在各种文件（如 JSON、INI 或 XML）中配置应用程序设置，以及如何从应用程序..
NET8 ORM 使用AOT SqlSugar
jhl52771的专栏
11-17 1290
NET AOT8 基本上能够免强使用了, SqlSugar ORM也支持了CRUD 能在AOT下运行了。
.NET Core单文件发布静态编译AOT CoreRT
weixin_33850015的博客
01-14 346
.NET Core单文件发布静态编译AOT CoreRT，将.NET Core应用打包成一个可执行文件并包含运行时。 支持Windows, MacOS and Linux x64 w/ RyuJIT codegen。 示例项目： https://github.com/dotnet/corert/tree/master/samples/WebApi 下面来实际体验。 首先确保安装C++编译环境，以及...
我没有使用AOT报错java.lang.NoClassDefFoundError: org/springframework/aot/AotDetector
10-09
这个错误是由于缺少 `org.springframework.aot.AotDetector` 类引起的。这个类是 Spring Framework 的 AOT 编译器的一部分，它用于检测是否启用了 AOT 编译。出现该错误可能是因为项目中缺少了 Spring AOT 编译器的相关依赖。 要解决这个问题，您可以尝试以下步骤： 1. 确保项目中包含了正确的 Spring AOT 编译器的依赖。您可以在项目的构建文件（如 Maven 的 pom.xml 或 Gradle 的 build.gradle）中添加相应的依赖。 2. 如果您已经添加了依赖但仍然遇到该错误，请尝试清除项目的缓存和重新构建，以确保依赖正确加载。 3. 如果以上步骤都没有解决问题，您可以检查您的项目配置和依赖是否正确，并确保您使用的是兼容版本的 Spring Framework。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值