ASP.NET Core 對原生 AOT 的支援

作者 Mitch Denny

在 ASP.NET Core 中發布並部署原生提前(AOT)應用程式有多項好處:

  • 將磁碟占用空間降到最低。 當你使用 Native AOT 發佈應用程式時,該程序會產生一個可執行檔案。 執行檔僅包含支援應用程式所需的外部相依程式碼。 可執行檔大小減少可能導致:

    • 較小的容器映像,例如在容器化部署案例中。
    • 部署時間因映像較小而減少。
  • 啟動時間縮短。 原生的 AOT 應用程式啟動時間較短,這能實現:

    • 讓應用程式更快地處理請求。
    • 改進部署,容器協調器管理從一個應用程式版本過渡到另一個版本。
  • 降低記憶體需求。 原生的 AOT 應用程式可能需要較少記憶體,這取決於應用程式所做的工作。 減少的記憶體使用量可能會導致更大的部署密度和改善的可擴縮性。

以下圖表展示了各範本應用程式的基準測試結果。 該基準測試比較了預編譯發佈的應用程式(橘色條)、精簡執行時的應用程式(綠色條)和未精簡執行時的應用程式(黃色條)的效能。 測試顯示,原生 AOT 應用程式在應用程式大小、記憶體使用率及啟動時間上都更低。

圖表顯示應用程式大小、記憶體用量與啟動時間指標的比較。圖表比較了已發行的原生 AOT 應用程式、修剪後的執行階段應用程式,以及未修剪的執行階段應用程式。

本文說明 ASP.NET Core 中原生 AOT 應用程式的支援,包括發佈與部署的概述。

關於 ASP.NET Core Blazor WebAssembly 原生 AOT 指引,該指引可作為本文指引的補充或取代,請參見 ASP.NET Core Blazor WebAssembly 建置工具與預先(AOT)編譯。

檢視 ASP.NET Core 與原生 AOT 相容性

目前,並非 ASP.NET Core 中的所有功能都與原生 AOT 相容。

下表總結了 ASP.NET Core 與 Native AOT 的功能相容性。

功能 支援 部分支援 不支援
Blazor Server ❌
CORS ✔️
gRPC ✔️
HealthChecks ✔️
HTTP 記錄 ✔️
JWT 認證 ✔️
在地化 ✔️
精簡 API ✔️
MVC ❌
OData ❌
其他驗證 ❌
OutputCaching ✔️
速率限制 ✔️
RequestDecompression (請求解壓縮) ✔️
回應緩存 ✔️
回應壓縮 ✔️
重寫 ✔️
工作階段 ❌
SignalR ✔️
水療 ❌
StaticFiles ✔️
WebSocket ✔️

有關限制的詳細資訊,請參閱:

在原生 AOT 部署模式下驗證應用程式

當你轉換到 Native AOT 部署模型時,徹底測試應用程式非常重要。 測試已部署的 AOT 應用程式,確認功能與未修剪且即時編譯(JIT)應用程式相同。

在建立應用程式時,請檢視並修正任何AOT警告。 一個在發佈時會發出 AOT警告 的應用程式可能無法正常運作。 如果發佈時沒有發出AOT警告,你可以預期已發佈的AOT應用程式會和未修剪且經過JIT編譯的應用程式一樣運作。

發佈原生的 AOT 應用程式(PublishAot)

請使用 PublishAot MSBuild 屬性,為您的應用程式啟用 Native AOT。 下列範例展示如何在專案檔中啟用原生 AOT:

<PropertyGroup>
  <PublishAot>true</PublishAot>
</PropertyGroup>

此 PublishAot 特性在發佈過程中支援原生 AOT 編譯,並在建置與編輯過程中進行動態程式碼使用分析。 使用 Native AOT 發佈的專案在本地執行時會實作 JIT 編譯。

AOT 應用程式與 JIT 編譯的應用程式有下列差異:

  • 與原生 AOT 不相容的功能會停用,並在執行階段擲回例外狀況。
  • 系統會啟用來源分析器,以醒目提示與原生 AOT 不相容的程式碼。 在發佈時,會再次分析整個應用程式 (包括 NuGet 套件) 是否相容。

原生 AOT 分析包含所有應用程式程式碼及應用程式依賴的函式庫。 檢閱原生 AOT 警告並採取更正步驟。 最好經常發佈應用程式,以在開發生命週期早期發現問題。

在 .NET 8 及更新版本中,以下 ASP.NET Core 應用程式類型支援原生 AOT:

檢視 Web API(原生 AOT)範本

ASP.NET Core Web API(原生 AOT)模板(簡稱 webapiaot)會建立啟用 AOT 的專案。 此範本與標準 Web API 專案範本的不同之處如下:

  • 只使用最低限度的 API,因為 MVC 尚未與原生 AOT 相容。
  • 利用 CreateSlimBuilder() API 確保預設只啟用必要功能,將應用程式部署規模降到最低。
  • 設定為僅在 HTTP 上監聽。 HTTPS 流量通常由雲端原生部署中的入口服務處理。
  • 不包含在 IIS 或 IIS Express 下執行的啟動設定檔。
  • 建立一個 .http 檔案 ,並設定了範例 HTTP 請求,可以傳送給應用程式的端點。
  • 包含範例 Todo API,而不是天氣預報範例。
  • 如PublishAot,將該屬性加入專案檔案。
  • 啟用 JSON 序列化程式來源產生器。 來源產生器是用來在建置階段產生序列化程式碼,這是原生 AOT 編譯所需的字碼。

JSON 序列化程式碼更新(Program.cs)

Program.cs檔案中的程式碼經過修改,以支援 JSON 序列化原始碼產生。

以下片段展示了程式碼的變更:

using MyFirstAotWebApi;
+using System.Text.Json.Serialization;

-var builder = WebApplication.CreateBuilder();
+var builder = WebApplication.CreateSlimBuilder(args);

+builder.Services.ConfigureHttpJsonOptions(options =>
+{
+  options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
+});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

+[JsonSerializable(typeof(Todo[]))]
+internal partial class AppJsonSerializerContext : JsonSerializerContext
+{
+
+}

如果你不修改程式碼,可以用 System.Text.Json 反射來序列化和反序列化 JSON。 原生 AOT 不支援反射。

如需詳細資訊,請參閱

啟動設定檔的程式碼變更(launchSettings.json)

Web API(原生 AOT)範本會建立一個 launchSettings.json 檔案。 與標準啟動檔案不同,產生的檔案不包含該 iisSettings 區段或 IIS Express 個人檔案。

以下片段顯示排除區段(紅色):

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
-  "iisSettings": {
-     "windowsAuthentication": false,
-     "anonymousAuthentication": true,
-     "iisExpress": {
-       "applicationUrl": "http://localhost:11152",
-       "sslPort": 0
-     }
-   },
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "todos",
      "applicationUrl": "http://localhost:5102",
        "environmentVariables": {
          "ASPNETCORE_ENVIRONMENT": "Development"
        }
      },
-     "IIS Express": {
-       "commandName": "IISExpress",
-       "launchBrowser": true,
-       "launchUrl": "todos",
-      "environmentVariables": {
-       "ASPNETCORE_ENVIRONMENT": "Development"
-      }
-    }
  }
}

CreateSlimBuilder() 要求將應用程式預設值降至最低

Web API(原生 AOT)範本使用方法CreateSlimBuilder()而不是方法CreateBuilder()。

using System.Text.Json.Serialization;
using MyFirstAotWebApi;

var builder = WebApplication.CreateSlimBuilder(args);
builder.Logging.AddConsole();

builder.Services.ConfigureHttpJsonOptions(options =>
{
    options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

[JsonSerializable(typeof(Todo[]))]
internal partial class AppJsonSerializerContext : JsonSerializerContext
{
}

CreateSlimBuilder 方法會使用執行應用程式所需的最少 ASP.NET Core 功能來初始化 WebApplicationBuilder。

如前所述,此 CreateSlimBuilder 方法不支援 HTTPS 或 HTTP/3。 在 TLS 終止 Proxy 後面執行的應用程式通常不需要這些通訊協定。 如需範例,請參閱 TLS 終止和端對端 TLS 搭配應用程式閘道。 你可以透過呼叫 builder.WebHost.UseKestrelHttpsConfiguration 方法來啟用 HTTPS,或透過呼叫 builder.WebHost.UseQuic 方法來啟用 HTTP/3。

比較 CreateSlimBuilder() 和 CreateBuilder()

此 CreateSlimBuilder 方法提供對部分應用程式功能的存取,這些功能與 CreateBuilder 方法相關聯。 如前所述,Web API(原生 AOT) 模板呼叫 CreateSlimBuilder 來初始化 WebApplicationBuilder,因此建構者只使用執行應用程式所需的最低限度 ASP.NET Core功能。

這兩種方法都具備高效開發體驗所需的功能:

  • appsettings.json 和 appsettings.{EnvironmentName}.json 檔案的設定
  • 使用者秘密設定
  • 控制台日誌記錄
  • 記錄設定

包含最少的功能對於修剪以及 AOT 都有益處。 如需詳細資訊,請參閱修剪獨立式部署及可執行檔。

如果你偏好使用省略所有功能的建構器,請參考 WebApplication.CreateEmptyBuilder 方法。

CreateSlimBuilder 中不可用的功能

此 CreateSlimBuilder 方法 不 提供以下功能,而以下功能可在 CreateBuilder 中取得:

欲了解更多詳細資訊,請參閱 Comparing WebApplication.CreateBuilder 與 CreateSlimBuilder 的比較

使用源產生器並避免反射

在 Native AOT 發佈過程中,任何未使用的程式碼都會被刪除。 因此,應用程式無法在執行時使用無界反射。 你可以使用源碼生成器來產生程式碼,這樣可以避免使用反射機制。 在某些情況下,即使不需要生成器,源代碼生成器也會輸出為預先編譯優化的程式碼。

  • 要查看產生的原始碼,請將 EmitCompilerGeneratedFiles 屬性加入應用程式專案(.csproj)檔案中:

    <Project Sdk="Microsoft.NET.Sdk.Web">
    
       <PropertyGroup>
         <!-- Other properties omitted for brevity -->
         <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
       </PropertyGroup>
    
    </Project>
    
  • 要查看產生的程式碼,執行指令 dotnet build 。 指令會編譯原始碼檔案,並產生執行應用程式所需的中間檔案。 輸出包含一個包含 obj/Debug/<.NET version>/generated/ 目錄,包含所有專案產生的檔案。

  • 要準備應用程式部署,請執行該 dotnet publish 指令。 指令會編譯原始檔案並產生部署應用程式所需的所有檔案。 它會將產生的組件傳送給原生 IL 編譯器,該編譯器產生原生執行檔。 原生可執行檔包含原生機器碼。

使用內建 AOT 的函式庫

許多 ASP.NET Core 專案中使用的熱門函式庫,目前在整合到針對原生 AOT 的專案時會有一些相容性問題,例如:

  • 利用反射來檢視並發現類型
  • 執行時有條件地載入函式庫
  • 即時產生程式碼以實作功能

使用這些動態功能的函式庫需要更新才能與 Native AOT 相容。 市面上有多種工具可用於套用必要的更新,例如 Roslyn 源產生器。

希望支持 Native AOT 的圖書館作者,鼓勵閱讀以下文章:

使用 Minimal API 處理 JSON 負載

Minimal API 框架透過使用 System.Text.Json 優化接收和返回 JSON 資載的過程。

所有在 HTTP 主體中傳送或從請求代表回傳的類型,必須在 Minimal API 應用程式的 JsonSerializerContext 實例上進行配置。 該實例必須註冊到 ASP.NET Core 依賴注入系統中:

using System.Text.Json.Serialization;
using MyFirstAotWebApi;

var builder = WebApplication.CreateSlimBuilder(args);
builder.Logging.AddConsole();

builder.Services.ConfigureHttpJsonOptions(options =>
{
    options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

[JsonSerializable(typeof(Todo[]))]
internal partial class AppJsonSerializerContext : JsonSerializerContext
{
}

代理上未綁定在主體上的參數 不需要 可序列化。 例如,查詢字串參數可以是一個富物件型態,實作 IParsable<T>。

public class Todo
{
    public int Id { get; set; }
    public string? Title { get; set; }
    public DateOnly? DueBy { get; set; }
    public bool IsComplete { get; set; }
}

static class TodoGenerator
{
    private static readonly (string[] Prefixes, string[] Suffixes)[] _parts = new[]
        {
            (new[] { "Walk the", "Feed the" }, new[] { "dog", "cat", "goat" }),
            (new[] { "Do the", "Put away the" }, new[] { "groceries", "dishes", "laundry" }),
            (new[] { "Clean the" }, new[] { "bathroom", "pool", "blinds", "car" })
        };
    // Remaining code omitted for brevity.

檢閱已知問題

若要回報或檢視 ASP.NET Core 中原生 AOT 支援的問題,請參見 GitHub/dotnet/core/issues #8288)。

.NET 8 引進了 .NET 原生事先編譯(AOT)的支援。

為何搭配 ASP.NET Core 使用原生 AOT

發佈和部署原生 AOT 應用程式可提供下列優勢:

  • 最小化磁碟佔用:使用 Native AOT 發佈時,會產生一個僅包含支援程式所需的外部相依程式碼的單一執行檔。 減少的可執行檔案大小可能會導致:
    • 較小的容器映像,例如在容器化部署案例中。
    • 部署時間因映像較小而減少。
  • 啟動時間縮短:原生 AOT 應用程式可以顯示較短的啟動時間,也就是說
    • 應用程式已準備好更快速地處理請求。
    • 改善的部署,其中容器協調器需要管理從應用程式某個版本到另一個版本的轉換。
  • 記憶體需求減少:原生 AOT 應用程式的記憶體需求可能會降低,這取決於應用程式所執行的工作量。 減少的記憶體使用量可能會導致更大的部署密度和改善的可擴縮性。

範本應用程式是在基準實驗室中執行,以比較下列應用程式的效能:AOT 發佈的應用程式、修剪的執行階段應用程式,以及未修剪的執行階段應用程式。 下表顯示基準測試的結果:

圖表顯示AOT發佈應用程式、已裁剪執行時應用與未修剪執行時應用的應用程式大小、記憶體使用量及啟動時間指標的比較。

上圖顯示原生 AOT 具有較低的應用程式大小、記憶體使用量和啟動時間。

ASP.NET Core 與原生 AOT 相容性

目前,並非 ASP.NET Core 中的所有功能都與原生 AOT 相容。 下表總結了 ASP.NET Core 與 Native AOT 的功能相容性。

功能 完全支援 部分支持 不支援
gRPC 完全支援
精簡 API 部分支援
MVC 不支援
Blazor Server 不支援
SignalR 不支援
JWT 認證 完全支援
其他驗證 不支援
CORS 完全支援
HealthChecks 完全支援
HTTP 記錄 完全支援
在地化 完全支援
OutputCaching 完全支援
速率限制 完全支援
RequestDecompression (請求解壓縮) 完全支援
回應緩存 完全支援
回應壓縮 完全支援
重寫 完全支援
工作階段 不支援
水療 不支援
StaticFiles 完全支援
WebSocket 完全支援

有關限制的詳細資訊,請參閱:

移至原生 AOT 部署模型時,請務必徹底測試應用程式。 應該測試已部署的 AOT 應用程式,以確保其功能與完整版本和 JIT 編譯的應用程式相比並未發生變化。 建置應用程式時,請檢閱並更正 AOT 警告。 在發佈期間發出 AOT 警告的應用程式可能無法正常運作。 如果在發佈時未發出 AOT 警告,則發佈的 AOT 應用程式應與未修剪且 JIT 編譯的應用程式運作相同。

原生 AOT 發佈

原生 AOT 是使用 PublishAot MSBuild 屬性啟用的。 下列範例展示如何在專案檔中啟用原生 AOT:

<PropertyGroup>
  <PublishAot>true</PublishAot>
</PropertyGroup>

此設定會在發佈期間啟用原生 AOT 編譯,並在建置和編輯期間啟用動態程式碼使用量分析。 在本機執行時,使用原生 AOT 發佈的專案會使用 JIT 編譯。 AOT 應用程式與 JIT 編譯的應用程式有下列差異:

  • 與原生 AOT 不相容的功能會停用,並在執行階段擲回例外狀況。
  • 系統會啟用來源分析器,以醒目提示與原生 AOT 不相容的程式碼。 在發佈時,會再次分析整個應用程式 (包括 NuGet 套件) 是否相容。

原生 AOT 分析包含應用程式的所有程式碼,以及應用程式依賴的程式庫。 檢閱原生 AOT 警告並採取更正步驟。 最好經常發佈應用程式,以在開發生命週期早期發現問題。

在 .NET 8 中,下列 ASP.NET Core 應用程式類型支援原生 AOT:

Web API (原生 AOT) 範本

ASP.NET Core Web API (原生 AOT) 範本 (簡稱為 webapiaot) 會建立已啟用 AOT 的專案。 此範本在下列方式中與 Web API 專案範本不同:

  • 只使用最低限度的 API,因為 MVC 尚未與原生 AOT 相容。
  • 使用 CreateSlimBuilder() API 來確保預設只會啟用基本功能,從而將應用程式的部署大小降至最低。
  • 設定為只接聽 HTTP,因為 HTTPS 流量通常是由雲端原生部署中的輸入服務處理。
  • 不包含在 IIS 或 IIS Express 下執行的啟動設定檔。
  • 建立一個使用範例 HTTP 要求所設定的 .http 檔案,這些要求可以傳送至應用程式的端點。
  • 包含範例 Todo API,而不是天氣預報範例。
  • 將 PublishAot 新增至專案檔,如本文稍早所示。
  • 啟用 JSON 序列化程式來源產生器。 來源產生器是用來在建置階段產生序列化程式碼,這是原生 AOT 編譯所需的字碼。

對於支援來源生成的更改

下列範例會顯示新增至 Program.cs 檔案的程式碼,即可支援 JSON 序列化來源產生:

using MyFirstAotWebApi;
+using System.Text.Json.Serialization;

-var builder = WebApplication.CreateBuilder();
+var builder = WebApplication.CreateSlimBuilder(args);

+builder.Services.ConfigureHttpJsonOptions(options =>
+{
+  options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
+});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

+[JsonSerializable(typeof(Todo[]))]
+internal partial class AppJsonSerializerContext : JsonSerializerContext
+{
+
+}

若少了這組新增的程式碼,System.Text.Json 就會使用反映來將 JSON 序列化並還原序列化。 原生 AOT 不支援反射。

如需詳細資訊,請參閱

launchSettings.json 的變更

由 launchSettings.json 範本所建立的 檔案已移除 iisSettings 區段和 IIS Express 設定檔:

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
-  "iisSettings": {
-     "windowsAuthentication": false,
-     "anonymousAuthentication": true,
-     "iisExpress": {
-       "applicationUrl": "http://localhost:11152",
-       "sslPort": 0
-     }
-   },
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "todos",
      "applicationUrl": "http://localhost:5102",
        "environmentVariables": {
          "ASPNETCORE_ENVIRONMENT": "Development"
        }
      },
-     "IIS Express": {
-       "commandName": "IISExpress",
-       "launchBrowser": true,
-       "launchUrl": "todos",
-      "environmentVariables": {
-       "ASPNETCORE_ENVIRONMENT": "Development"
-      }
-    }
  }
}

CreateSlimBuilder 方法

此範本會使用 CreateSlimBuilder() 方法,而不是 CreateBuilder() 方法。

using System.Text.Json.Serialization;
using MyFirstAotWebApi;

var builder = WebApplication.CreateSlimBuilder(args);
builder.Logging.AddConsole();

builder.Services.ConfigureHttpJsonOptions(options =>
{
    options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

[JsonSerializable(typeof(Todo[]))]
internal partial class AppJsonSerializerContext : JsonSerializerContext
{
}

CreateSlimBuilder 方法會使用執行應用程式所需的最少 ASP.NET Core 功能來初始化 WebApplicationBuilder。

如先前所述,CreateSlimBuilder 方法不包含 HTTPS 或 HTTP/3 的支援。 在 TLS 終止 Proxy 後面執行的應用程式通常不需要這些通訊協定。 如需範例,請參閱 TLS 終止和端對端 TLS 搭配應用程式閘道。 您可以透過呼叫 builder.WebHost.UseKestrelHttpsConfiguration 來啟用 HTTPS,並透過呼叫 builder.WebHost.UseQuic 來啟用 HTTP/3。

CreateSlimBuilder vs CreateBuilder

CreateSlimBuilder 方法不支援 CreateBuilder 方法所支援的下列功能:

CreateSlimBuilder 方法包含有效開發體驗所需的下列功能:

  • 適用於 appsettings.json 和 appsettings.{EnvironmentName}.json 的 JSON 檔案設定
  • 使用者密鑰設定配置。
  • 主控台日誌輸出。
  • 記錄設定。

有關省略上述功能的建立器,請參閱 CreateEmptyBuilder 方法。

包含最少的功能對於修剪以及 AOT 都有益處。 如需詳細資訊,請參閱修剪獨立式部署及可執行檔。

如需詳細資訊,請參閱比較 WebApplication.CreateBuilder 與 CreateSlimBuilder

來源產生器

因為未使用的程式碼會在原生 AOT 發佈期間進行修剪,因此在執行階段應用程式無法使用無限制的反射。 原始碼產生器用於產生可避免反射需求的程式碼。 在某些情況下,即使不需要產生器,來源產生器仍會產生針對 AOT 最佳化的程式碼。

若要檢視產生的原始程式碼,請將 EmitCompilerGeneratedFiles 屬性新增至應用程式的 .csproj 檔案,如下列範例所示:

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

  <PropertyGroup>
    <!-- Other properties omitted for brevity -->
    <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
  </PropertyGroup>

</Project>

執行 dotnet build 命令以查看產生的程式碼。 輸出包括 obj/Debug/net8.0/generated/ 目錄,其中包含針對專案產生的所有檔案。

dotnet publish 命令也會編譯來源檔案,並產生已編譯的檔案。 此外,dotnet publish 也會將產生的組件傳遞至原生 IL 編譯器。 IL 編譯器會產生原生可執行檔。 原生可執行檔包含原生機器碼。

使用內建 AOT 的函式庫

許多 ASP.NET Core 專案中使用的熱門函式庫,目前在整合到針對原生 AOT 的專案時會有一些相容性問題,例如:

  • 利用反射來檢視並發現類型
  • 執行時有條件地載入函式庫
  • 即時產生程式碼以實作功能

使用這些動態功能的函式庫需要更新才能與 Native AOT 相容。 市面上有多種工具可用於套用必要的更新,例如 Roslyn 源產生器。

希望支持 Native AOT 的圖書館作者,鼓勵閱讀以下文章:

最小 API 和 JSON 負載

最小 API 框架已針對使用 System.Text.Json 接收和傳回 JSON 負載進行優化。 System.Text.Json:

在 Minimal APIs 應用程式中,所有作為 HTTP 本文一部分傳輸,或從要求委派傳回的型別,都必須設定於透過 ASP.NET Core 相依性插入註冊的 JsonSerializerContext 上:

using System.Text.Json.Serialization;
using MyFirstAotWebApi;

var builder = WebApplication.CreateSlimBuilder(args);
builder.Logging.AddConsole();

builder.Services.ConfigureHttpJsonOptions(options =>
{
    options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
});

var app = builder.Build();

var sampleTodos = TodoGenerator.GenerateTodos().ToArray();

var todosApi = app.MapGroup("/todos");
todosApi.MapGet("/", () => sampleTodos);
todosApi.MapGet("/{id}", (int id) =>
    sampleTodos.FirstOrDefault(a => a.Id == id) is { } todo
        ? Results.Ok(todo)
        : Results.NotFound());

app.Run();

[JsonSerializable(typeof(Todo[]))]
internal partial class AppJsonSerializerContext : JsonSerializerContext
{
}

在上述醒目提示的程式碼中:

未繫結至委派主體且不需要進行序列化的參數。 例如,屬於豐富物件類型並實作 IParsable<T> 的查詢字串參數。

public class Todo
{
    public int Id { get; set; }
    public string? Title { get; set; }
    public DateOnly? DueBy { get; set; }
    public bool IsComplete { get; set; }
}

static class TodoGenerator
{
    private static readonly (string[] Prefixes, string[] Suffixes)[] _parts = new[]
        {
            (new[] { "Walk the", "Feed the" }, new[] { "dog", "cat", "goat" }),
            (new[] { "Do the", "Put away the" }, new[] { "groceries", "dishes", "laundry" }),
            (new[] { "Clean the" }, new[] { "bathroom", "pool", "blinds", "car" })
        };
    // Remaining code omitted for brevity.

已知問題

請參閱此 GitHub 問題,以報告或檢閱 ASP.NET Core 中原生 AOT 支援的問題。

另請參閱