如果你正在將應用程式遷移到 .NET 11,這裡列出的破壞性變更可能會影響你。 變更依技術領域分類,例如 ASP.NET Core 或 Windows Forms。
本文會將每個重大變更分類為「二進位不相容」或「來源不相容」,或分類為「行為變更」:
二進位不相容 ——當對新執行時或元件執行時,現有二進位檔可能會遇到行為上的破壞性變化,例如無法載入或執行,若有此情況,則需重新編譯。
原始碼不相容 ——當使用新的 SDK 或元件重新編譯,或針對新的執行環境時,現有原始碼可能需要修改原始碼才能成功編譯。
行為改變 ——現有程式碼與二進位檔在執行時可能有不同的行為。 如果不需要新的行為,則必須更新並重新編譯現有的程式碼。
備註
本文為進行中的作業。 這並不是 .NET 11 中所有重大變更的完整清單。
ASP.NET Core
容器
| Title | 變更類型 |
|---|---|
| dotnet test 需要在容器中有一個可寫入的 VSTest artifacts 基底目錄 | 行為變更 |
核心 .NET 函式庫
Cryptography
| Title | 變更類型 |
|---|---|
| API 的淘汰 | 來源不相容 |
| Windows 上的複合 ML-DSA 採用原生實作 | 行為變更 |
| DSA 已從 macOS 中移除 | 行為變更 |
| Windows 上的 HKDF 採用 CNG 實作 | 行為變更 |
| Linux AIA 憑證擷取每次鏈結建置僅限兩次擷取 | 行為變更 |
Deployment
| Title | 變更類型 |
|---|---|
| .runtimeconfig.dev.json 中的 configProperties 會覆寫 .runtimeconfig.json | 行為變更 |
擴充功能
Globalization
| Title | 變更類型 |
|---|---|
| 日本曆最小支援日期已修正 | 行為變更 |
Interop
| Title | 變更類型 |
|---|---|
| 原生 AOT 拒絕不可 blittable 的 UnmanagedCallersOnly 簽名 | 行為變更 |
| NativeAOT 在 Unix 上使用 lib 前綴作為原生函式庫輸出 | 行為變更 |
JIT 編譯器
| Title | 變更類型 |
|---|---|
| 浮點數轉換為較小的整數型別時會採用飽和處理 | 行為變更 |
| 最低硬體需求已更新 | 行為變更 |
網路
| Title | 變更類型 |
|---|---|
| HttpClient 高基數計量使用可觀察計數器 | 行為變更 |
| SslStream 伺服器端 AIA 憑證下載預設為停用 | 行為變更 |
.NET MAUI
| Title | 變更類型 |
|---|---|
| Android x86 不支援 | 二進位不相容/行為變動 |
| 行動端程式碼產生方式從 Mono 變為 CoreCLR | 來源不相容/行為變更 |
| CoreCLR 取代了 .NET 行動應用程式的 Mono 執行環境 | 二進位/原始碼不相容/行為改變 |
| CoreCLR 追蹤事件取代了 Mono 追蹤事件 | 二進位/原始碼不相容/行為改變 |
| 行動平台的當機回報行為變更 | 行為變更 |
行動平台上的除錯介面變更成 ICorDebug |
二進位/原始碼不相容/行為改變 |
| 最低 Android API 級別提升至 24 | 行為變更 |
| 行動平台不再支援 Mono 嵌入 API | 二進位/原始碼不相容/行為改變 |
| Mono 專案屬性不再用於設定行動應用程式 | 來源不相容/行為變更 |
| Mono 執行階段設定不再為行動應用程式進行設定 | 行為/來源不相容 |
| UnwindNativeCode 在 Apple 目標平台上不被支援 | 來源不相容/行為變更 |
SDK 和 MSBuild
| Title | 變更類型 |
|---|---|
| dnx scripts 會略過 global.json 的 SDK 選取 | 行為變更 |
| .NET Framework 應用程式的 mono 啟動目標未設定 | 行為變更 |
| NativeAOT CLI 指令處理預設已啟用 | 行為變更 |
| NU1703 會對使用已棄用 MonoAndroid 框架資產的套件提出警告 | 來源不相容 |
| Linux 上的 NuGet 鎖定目錄已移動 | 行為變更 |
| NuGet 套件對於有限制字元的套件 ID 會發出警告 | 行為變更 |
| 還原不會搜尋全域套件資料夾中的更高版本 | 來源不相容 |
| SDK 本地容器執行時選擇偏好平台原生工具 | 行為變更 |
| 模板引擎套件不再支援 netstandard2.0 | 二進位/來源不相容 |
| 模板套件安裝會驗證 NuGet 簽名 | 行為變更 |
| VSTest 移除對 Newtonsoft.Json 的依賴 | 二進位/來源不相容 |