如果要将应用迁移到 .NET 11,此处列出的重大更改可能会影响你。 更改按技术领域分组,例如 ASP.NET Core或Windows 窗体。
本文将每个重大变更分类为“二进制不兼容”或“源不兼容”,或者作为“行为更改”:
二进制不兼容 - 针对新的运行时或组件运行时,现有二进制文件在行为上可能会遇到中断性变更,例如无法加载或执行,如果是,则需要重新编译。
源不兼容 - 使用新 SDK 或组件重新编译或面向新运行时时,现有源代码可能需要进行源更改才能成功编译。
行为更改 - 现有代码和二进制文件在运行时的行为可能有所不同。 如果不需要新的行为,则需要更新和重新编译现有代码。
注释
本文是当前正在进行的工作。 这不是.NET 11 中重大更改的完整列表。
ASP.NET Core
容器
| Title | 更改类型 |
|---|---|
| dotnet 测试需要容器中的可写 VSTest 工件基目录 | 行为更改 |
核心.NET库
Cryptography
| Title | 更改类型 |
|---|---|
| API 弃用 | 源代码不兼容 |
| Windows上的复合 ML-DSA 使用本机实现 | 行为更改 |
| DSA 已从 macOS 中移除 | 行为更改 |
| Windows上的 HKDF 使用 CNG 实现 | 行为更改 |
| Linux AIA 证书获取限制为每次构建证书链最多只进行两次 | 行为更改 |
Deployment
| Title | 更改类型 |
|---|---|
| .runtimeconfig.dev.json 中的 configProperties 覆盖 .runtimeconfig.json | 行为更改 |
Extensions
Globalization
| Title | 更改类型 |
|---|---|
| 更正了日本日历支持的最小日期 | 行为更改 |
Interop
| Title | 更改类型 |
|---|---|
| 本机 AOT 拒绝非 blittable UnmanagedCallersOnly 签名 | 行为更改 |
| NativeAOT 对 Unix 上的本机库输出使用 lib 前缀 | 行为更改 |
JIT 编译器
| Title | 更改类型 |
|---|---|
| 浮点数到小型整数类型的转换是饱和的 | 行为更改 |
| 最低硬件要求已更新 | 行为更改 |
网络
| Title | 更改类型 |
|---|---|
| HttpClient 高基数指标使用可观测计数器 | 行为更改 |
| 默认情况下禁用 SslStream 服务器端 AIA 证书下载 | 行为更改 |
.NET MAUI
| Title | 更改类型 |
|---|---|
| 不支持 Android x86 | 二进制不兼容/行为变更 |
| 移动设备上的代码生成从 Mono 更改为 CoreCLR | 源不兼容/行为变更 |
| CoreCLR 取代 Mono,成为 .NET 移动应用的运行时 | 二进制/源不兼容/行为更改 |
| CoreCLR 跟踪事件取代 Mono 跟踪事件 | 二进制/源不兼容/行为更改 |
| 移动平台上的崩溃报告行为更改 | 行为更改 |
移动平台上的调试接口更改为 ICorDebug |
二进制/源不兼容/行为更改 |
| 最低 Android API 级别提高到 24 | 行为更改 |
| 在移动平台上不再支持 Mono 嵌入 API | 二进制/源不兼容/行为更改 |
| Mono 项目属性不再用于配置移动应用 | 源不兼容/行为变更 |
| Mono 运行时设置不再用于配置移动应用 | 行为不兼容/源代码不兼容 |
| Apple 目标不支持 UnwindNativeCode | 源不兼容/行为变更 |
SDK 和 MSBuild
| Title | 更改类型 |
|---|---|
| dnx 脚本绕过 global.json SDK 选择 | 行为更改 |
| Native AOT 发布时跳过完整生成 | 行为更改 |
| 未为 .NET Framework 应用设置 mono 启动目标 | 行为更改 |
| 默认情况下启用 NativeAOT CLI 命令处理 | 行为更改 |
| NU1703 针对使用已弃用 MonoAndroid 框架资产的包发出警告 | 源代码不兼容 |
| NuGet 锁定目录已移至 Linux | 行为更改 |
| NuGet 包针对包含受限字符的包 ID 发出警告 | 行为更改 |
| 恢复不会搜索更高版本的全局包文件夹 | 源代码不兼容 |
| SDK 本地容器运行时选择首选平台原生工具 | 行为更改 |
| 模板引擎包不再支持 netstandard2.0 | 二进制/源代码不兼容 |
| 模板包安装会验证 NuGet 签名 | 行为更改 |
| VSTest 移除对 Newtonsoft.Json 的依赖 | 二进制/源代码不兼容 |