升级NuGet包后Xamarin.iOs项目出现Native linking failed问题求原因及解决方案

常见原因 #

• 升级的NuGet包引入了不兼容的原生库：新包可能包含与现有项目中其他原生库（系统框架、其他NuGet的原生组件）版本冲突、架构不匹配（比如仅支持arm64但项目仍兼容armv7）的二进制文件。
• 包的原生链接配置错误：新包的.targets或.props文件中，可能错误设置了链接器参数，比如强制排除必要符号，或添加了无效的链接标记。
• 项目链接器设置冲突：项目本身的链接器行为（比如启用Link All Assemblies）与新包要求不匹配，导致必要的原生符号被误删。
• 新包依赖的系统框架版本过高：如果新包依赖的iOS系统框架版本高于项目当前部署目标版本，链接时会找不到对应符号。

解决办法 #

• 回退至可用的NuGet版本：先确认是哪个包引发的问题，直接在NuGet管理器中降级该包，验证是否恢复正常，这是最快的临时解决方案。
• 调整项目链接器设置：
  • 在项目属性的iOS Build选项中，将Linker Behavior改为Link Framework SDKs Only（若之前是Link All Assemblies），避免误删必要的原生符号。
  • 创建Linker.xml文件添加保留规则，明确保留新包相关的类型或原生符号，示例：

    <linker>
      <assembly fullname="NewNuGetPackageName">
        <type fullname="*" preserve="all"/>
      </assembly>
    </linker>
    

• 验证原生库兼容性：
  • 查看新包文档，确认其支持的iOS版本与项目Deployment Target是否匹配，不匹配则升级项目部署目标，或更换兼容的包版本。
  • 检查包内原生库的架构，确保与项目Supported Architectures一致（比如项目同时支持arm64和armv7，包也需包含这两种架构的库）。
• 清理并重新构建项目：
  • 执行Clean Solution，删除项目的bin和obj目录，重新还原NuGet包（dotnet restore或通过NuGet管理器还原），最后重新构建。
• 修正包的原生链接参数：
  • 将新包的.nupkg文件改后缀为.zip解压，查看其中的.targets文件，确认是否有错误的AdditionalMtouchArgs设置（比如无效参数或错误的-framework引用），如有则手动修改项目iOS Build中的Additional mtouch arguments来覆盖或修正。

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