如何在.NET MAUI iOS应用中添加静态库(.a)及解决编译错误

问题背景 #

尝试在.NET MAUI iOS应用中集成C++静态库，通过DllImport调用原生函数，操作步骤如下：

1. 静态库对应的C++代码：

// add.cpp
extern "C" int add(int a, int b) { return a + b; }

2. 编译生成.a文件的命令：

g++ -c add.cpp -o add.o
ar rcs libadd.a add.o

3. 在MAUI项目的.csproj中添加引用：

<ItemGroup>
   <!-- 其他声明 -->

   <NativeReference Include="Lib/libadd.a">
      <Kind>Static</Kind>
      <ForceLoad>True</ForceLoad>
      <IsCxx>True</IsCxx>
   </NativeReference>
</ItemGroup>

4. C#中调用API：

[DllImport("__Internal", EntryPoint = "add")]
public static extern int add(int a, int b);

编译时出现两类核心错误：

/usr/local/share/dotnet/sdk/8.0.404/Microsoft.Common.CurrentVersion.targets(2303,5): error MSB4803: 任务 "ResolveNativeReference" 在 .NET Core 版本的 MSBuild 中不受支持，请使用 .NET Framework 版本的 MSBuild。

/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net8.0_18.0/18.0.8319/targets/Xamarin.Shared.Sdk.targets(1648,3): error : ld: 为 'iOS-simulator' 构建，但链接的目标文件是为 'iOS' 构建的

环境信息：

• Visual Studio Code: 1.96.2
• macOS: 14.7.1
• Xcode: 16.2
• .NET SDK: 8.0.404

错误修复方案 #

1. 解决MSB4803错误：替换旧的Xamarin引用语法 #

.NET MAUI 不再支持<NativeReference>元素（旧Xamarin语法），需改用.NET MAUI标准的<NativeLibrary>，并限定仅对iOS平台生效：

修改.csproj中的引用配置：

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">
  <NativeLibrary Include="Platforms/iOS/Lib/libadd.a" />
</ItemGroup>

• 增加Condition避免影响Android等其他平台
• <NativeLibrary>是.NET MAUI原生库引用的标准方式

2. 解决架构不匹配错误：编译通用静态库 #

你当前编译的静态库仅针对iOS真机（arm64），但构建目标是iOS模拟器，需编译同时支持真机和模拟器的通用静态库（Fat Library）：

步骤1：分别编译真机和模拟器版本的目标文件

# 编译iOS真机版本（arm64架构）
g++ -c add.cpp -o add-ios.o -target arm64-apple-ios14.0

# 编译Apple Silicon Mac模拟器版本（arm64架构）
g++ -c add.cpp -o add-sim.o -target arm64-apple-ios14.0-simulator

# 若为Intel Mac，编译模拟器版本用：
# g++ -c add.cpp -o add-sim.o -target x86_64-apple-ios14.0-simulator

注意：ios14.0需和MAUI项目中<iOSMinVersion>配置的最低版本一致

步骤2：合并为通用静态库

# 分别打包成静态库
ar rcs libadd-ios.a add-ios.o
ar rcs libadd-sim.a add-sim.o

# 合并为支持多架构的通用库
lipo -create libadd-ios.a libadd-sim.a -output libadd.a

额外优化建议 #

1. 给DllImport添加平台条件编译，避免非iOS平台编译报错：

#if IOS
[DllImport("__Internal", EntryPoint = "add")]
public static extern int add(int a, int b);
#endif

2. 在VS Code中构建时，确保选择的目标平台（模拟器/真机）与当前运行环境匹配

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