Xamarin.iOS/macOS .NET 10预览版发布：关键特性与升级指南

项目概述

Xamarin.iOS/macOS是微软推出的跨平台移动开发框架，允许开发者使用C#和.NET技术栈构建原生iOS、macOS、tvOS和Mac Catalyst应用。作为.NET生态系统的重要组成部分，该项目持续演进，最新发布的.NET 10预览版带来了多项重要改进。

.NET 10预览版核心特性

1. 默认启用剪裁器警告

在.NET 10中，Xamarin团队决定默认启用剪裁器(trimmer)警告。这一变化源于团队在.NET 9中已修复了基础类库中的所有剪裁器警告，使得开发者现在能够全面处理自己代码中的相关问题。

剪裁器警告有助于识别可能在应用发布时被意外移除的代码，特别是在使用AOT编译或链接器优化时。开发者可以通过在项目文件中添加以下配置来禁用此功能：

<PropertyGroup>
    <SuppressTrimAnalysisWarnings>true</SuppressTrimAnalysisWarnings>
</PropertyGroup>

2. 库项目中的原始资源捆绑

.NET 10改进了库项目中资源文件的处理方式。传统上，库项目中的各种资源文件（如storyboard、xib、plist、png等）会在嵌入前进行处理，这带来了几个限制：

• 必须在Mac上执行构建，因为xib/storyboard编译需要Mac环境
• 需要完整的Apple工具链支持
• 应用构建时无法基于原始资源做出决策

新版本通过默认将原始资源嵌入库中解决了这些问题，开发者可以通过以下配置恢复旧行为：

<PropertyGroup>
    <BundleOriginalResources>false</BundleOriginalResources>
</PropertyGroup>

API增强与改进

1. 多媒体框架更新

• AVFoundation和AVKit框架新增了Xcode 16.2中引入的API
• CoreMedia添加了近期Xcode版本中的新功能接口
• CoreHaptics现在支持macOS平台

2. 文档与代码质量提升

• 改进了bgen工具生成的XML文档传播
• 修复了多处API文档问题
• 优化了NSAttributedString构造函数
• 增强了异常封送处理机制

3. 模板与工具链改进

• 新增了通知内容扩展和通知服务扩展的项目模板
• 改进了工作负载依赖管理
• 优化了注册协议的性能
• 修复了UIImage中的流读取问题

升级与安装指南

要体验.NET 10预览版，开发者需要：

1. 确保已安装.NET SDK 10.0.100预览版
2. 使用以下命令安装所需工作负载：

dotnet workload install ios tvos macos maccatalyst --version 10.0.100-preview.1.25124.2

安装完成后，可通过dotnet workload --info验证已安装的工作负载版本。

性能优化与问题修复

• 修复了UIBarButtonItem中的GC竞争问题
• 改进了arm64架构下的默认剪裁行为
• 优化了Objective-C存根类的注册过程
• 修复了UIApplication的辅助功能实现

总结

Xamarin.iOS/macOS的.NET 10预览版标志着该框架的重要演进，特别是在剪裁器警告和资源处理方面的改进，为开发者提供了更强大的工具和更流畅的开发体验。这些变化不仅提升了开发效率，也为构建更优化的跨平台应用奠定了基础。

开发者可以开始尝试这一预览版，为即将到来的正式发布做好准备，同时团队也欢迎反馈以进一步完善框架功能。