如何用C#/.NET 9通过NativeAOT生成.a静态库用于XCode项目？

前置准备 #

• 安装最新版.NET 9 SDK，并确保包含NativeAOT及iOS workload：dotnet workload install ios nativeaot
• 确认macOS版本≥Ventura 13.0（对应XCode 14+），且XCode命令行工具已安装：xcode-select --install
• 目标类库需符合NativeAOT限制：禁用动态反射加载、动态代码生成，避免依赖未兼容AOT的NuGet包

编译操作步骤 #

1. 配置项目文件（.csproj） #

必须添加以下核心属性，示例配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net9.0-ios</TargetFramework>
    <NativeAot>true</NativeAot>
    <PublishAot>true</PublishAot>
    <StaticLibrary>true</StaticLibrary>
    <RuntimeIdentifier>ios-arm64</RuntimeIdentifier> <!-- 针对真机；模拟器用ios-x64 -->
    <StripSymbols>true</StripSymbols> <!-- 可选，缩减库体积 -->
  </PropertyGroup>
</Project>

若为跨平台类库，可通过条件属性单独配置iOS编译规则。

2. 执行编译命令 #

在终端运行发布命令：

dotnet publish -c Release -r ios-arm64

编译成功后，静态库文件<项目名>.a会生成在bin/Release/net9.0-ios/ios-arm64/publish目录下，同时同目录会生成配套的头文件<项目名>.h。

常见问题排查 #

• Workload缺失：运行dotnet workload list检查是否存在ios和microsoft.net.native.compiler组件，缺失则重新执行workload安装命令
• 项目属性错误：
  • 必须设置StaticLibrary=true，否则默认生成可执行文件或动态库
  • RuntimeIdentifier需匹配目标架构（真机用ios-arm64，模拟器用ios-x64）
• 代码兼容性问题：
  • 移除Activator.CreateInstance等动态反射调用，必要时用[DynamicDependency]标注依赖项
  • 禁用System.Reflection.Emit相关API
  • 替换未兼容AOT的NuGet包（如用System.Text.Json替代旧版Newtonsoft.Json）
• 输出目录混淆：仅Release模式的publish目录会生成AOT静态库，Debug模式默认不产出AOT产物
• XCode环境问题：确保XCode已打开过（同意许可协议），且xcode-select -p指向正确的XCode路径

XCode集成补充 #

若需同时支持真机和模拟器，可通过lipo合并两个架构的静态库：

lipo -create bin/Release/net9.0-ios/ios-x64/publish/<项目名>.a bin/Release/net9.0-ios/ios-arm64/publish/<项目名>.a -output <项目名>-universal.a

将合并后的通用库和头文件一同导入XCode项目即可调用C#导出的原生方法。

内容的提问来源于stack exchange，提问作者Dokug