如何将.NET 7.0 WinForm应用编译为原生代码？求详细示例

.NET 7 正式支持 WinForms 应用的原生AOT编译，下面是完整的实现步骤：

1. 确认项目基础 #

确保你的项目是基于 .NET 7.0-windows 的 WinForms 项目。如果是新项目，可以通过以下命令创建：

dotnet new winforms -n WinFormAotDemo -f net7.0-windows

2. 修改项目配置文件（.csproj） #

打开项目的 .csproj 文件，添加原生AOT相关配置：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net7.0-windows</TargetFramework>
    <UseWindowsForms>true</UseWindowsForms>
    <Nullable>enable</Nullable>
    <!-- 开启原生AOT编译 -->
    <PublishAot>true</PublishAot>
    <!-- 指定目标平台（根据需求选择win-x64/win-x86/win-arm64） -->
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <!-- 禁用ReadyToRun（AOT不需要该特性） -->
    <PublishReadyToRun>false</PublishReadyToRun>
    <!-- 可选：生成单文件可执行程序 -->
    <PublishSingleFile>true</PublishSingleFile>
    <SelfContained>true</SelfContained>
  </PropertyGroup>

</Project>

3. 处理AOT反射限制 #

原生AOT不支持未提前声明的反射操作，如果你的WinForms应用使用了反射动态加载控件、类型，需要添加 rd.xml 配置文件来告知AOT编译器保留相关类型：

1. 在项目根目录新建 rd.xml 文件，内容如下：

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
    <!-- 替换为你的项目程序集名称，确保AOT编译器保留所有类型 -->
    <Assembly Name="WinFormAotDemo" Dynamic="Required All" />
    <!-- 如果使用第三方WinForms控件，添加对应的程序集声明 -->
    <!-- <Assembly Name="ThirdPartyControlLib" Dynamic="Required All" /> -->
  </Application>
</Directives>

2. 在 .csproj 中添加该文件的引用，设置为嵌入式资源：

<ItemGroup>
  <EmbeddedResource Include="rd.xml" />
</ItemGroup>

4. 发布原生AOT程序 #

可以通过命令行或者Visual Studio发布：

命令行方式 #

在项目目录下执行：

dotnet publish -c Release

发布完成后，原生可执行文件会生成在 bin/Release/net7.0-windows/win-x64/publish 目录下，直接运行即可，无需依赖.NET运行时。

Visual Studio方式 #

1. 右键项目 → 选择“发布”
2. 选择“文件夹”作为目标，点击“下一步”
3. 在“发布配置”中，设置配置为“Release”，目标运行时选择对应平台（比如win-x64），勾选“生成单文件”和“启用原生AOT发布”
4. 点击“发布”完成编译

注意事项 #

• 部分WinForms特性（如TypeDescriptor动态属性、未声明的反射调用）可能无法在AOT模式下正常工作，需要提前测试并调整代码
• 第三方控件需要确认是否支持原生AOT，若依赖反射则必须在rd.xml中声明对应的程序集
• 发布过程中若出现警告，可根据警告信息补充rd.xml中的类型声明

内容的提问来源于stack exchange，提问作者duy