距離Azure Functions OpenAPI Extension的預覽版釋出已有一年的時間,今天,我們很開心地宣佈它已經正式釋出了!該版本支援.NET Core 2.1 (LTS)、3.1 (LTS)、.NET 5 和 .NET 6 (LTS)的同時,它還支援Azure Functions執行時的程式內和程式外工作執行緒。
接下來,讓我們看看如何在 Visual Studio 2022 中使用 .NET 6 中的 OpenAPI extension建立函式應用。
In-Process Worker
在Visual Studio 2022中,你可以使用In-Process Worker在 .NET中建立函式應用:
選擇.NET 6→選擇左側選單的"Http trigger with OpenAPI"→在Authorization level中選擇“Function”即可開始建立。
你可以看到有幾個decorator以OpenApi
開頭。由於此擴充套件的更新Visual Studio專案模板尚未釋出,因此現在需要更新 OpenApi extension。選擇Solution Explorer中的"Dependencies" 選單,然後點選"Manage NuGet Packages..." 選單。將現有的Microsoft.Azure.WebJobs.Extensions.OpenApi
package更新為1.0.0
。更新後,重建專案並通過單擊頂部的“除錯”按鈕執行函式應用程式。
Out-of-Process Worker
在 Visual Studio 2022 中,您還可以使用Out-of-Process Worker在.NET中建立函式應用。由於此擴充套件的更新Visual Studio專案模板尚未推出,您現在需要使用現有的 HTTP觸發器並新增NuGet package。建立方式如下:
新增 NuGet Package Microsoft.Azure.Functions.Worker.Extensions.OpenApi
。安裝後,更新 Program.cs
以啟用擴充套件。刪除ConfigureFunctionsWorkerDefaults()
,並新增 ConfigureFunctionsWorkerDefaults(worker =>worker.UseNewtonsoftJson())
和 ConfigureOpenApi()
。然後,將OpenAPI相關decorator新增到函式應用尾端。完成更新後,通過單擊頂部的“除錯”按鈕重建專案並執行函式應用程式。
從 .NET Core 3.1或.NET 5遷移至 .NET 6
只需更新.csproj
檔案,package版本以及目標框架。然後將Azure Functions相關的NuGet packages更新至最新版本,包括OpenAPI extension。重新構建專案,單擊頂部的“除錯”按鈕執行函式應用程式。接下來,開啟Web瀏覽器進入http://localhost:7071/api/swa...,你就可以看到Swagger UI頁面了。
更多細化的操作步驟請掃描二維碼檢視