Xamarin开启Link Framework SDKs Only编译时出现无法解析引用错误

问题原因 #

选择Link Framework SDKs Only编译模式时，Xamarin链接器会自动移除未被业务代码显式调用的框架SDK程序集成员，你项目中引入的第三方NuGet包依赖的部分SDK代码因为没有被直接调用，会被链接器误裁剪，最终触发引用无法解析的报错，Don't Link模式下不会执行裁剪操作因此编译正常。

解决步骤 #

1. 定位缺失程序集 #

先查看报错信息中Cant resolve the reference后跟随的具体程序集名称，优先针对该程序集配置跳过裁剪规则。

2. 配置程序集跳过链接 #

• 安卓项目：右键项目 → 属性 → 安卓选项 → 链接器，在「跳过链接的程序集」输入框中添加报错的程序集名称，多个程序集用分号分隔。依赖原生绑定的第三方包（如Plugin.FacebookClient、ZXing.Net.Mobile等）优先加入列表测试。
• iOS项目：右键项目 → 属性 → iOS生成 → 链接器，在「忽略的程序集」输入框中添加对应程序集名称。

3. 通用兜底配置（多包依赖问题适用） #

如果无法定位单个报错程序集，可以新增链接器描述文件指定保留所有第三方包的成员，步骤如下：

1. 新建XML文件命名为Linker.xml，放入对应平台项目的根目录，内容示例：

<linker>
  <assembly fullname="Plugin.FacebookClient" preserve="all"/>
  <assembly fullname="Plugin.NFC" preserve="all"/>
  <assembly fullname="Plugin.PushNotification-updated" preserve="all"/>
  <assembly fullname="Rg.Plugins.Popup" preserve="all"/>
  <assembly fullname="SkiaSharp.Views.Forms" preserve="all"/>
  <assembly fullname="sqlite-net-pcl" preserve="all"/>
  <assembly fullname="Xam.Plugin.Badge" preserve="all"/>
  <assembly fullname="Xam.Plugin.Connectivity" preserve="all"/>
  <assembly fullname="Xam.Plugin.Media" preserve="all"/>
  <assembly fullname="Xam.Plugins.Forms.ImageCircle" preserve="all"/>
  <assembly fullname="Xam.Plugins.Settings" preserve="all"/>
  <assembly fullname="Xamarin.Auth" preserve="all"/>
  <assembly fullname="Xamarin.Forms.InputKit" preserve="all"/>
  <assembly fullname="Xamarin.Forms.OpenWhatsApp" preserve="all"/>
  <assembly fullname="ZXing.Net.Mobile" preserve="all"/>
</linker>

2. 配置文件生成操作：
   • 安卓项目：右键Linker.xml → 属性 → 生成操作选择LinkDescription
   • iOS项目：右键Linker.xml → 属性 → 生成操作选择LinkDescription

4. 反射依赖类保留配置 #

Entity Framework、sqlite等依赖反射调用的组件经常会被误裁剪，可以在业务代码中新增无需主动调用的保留方法，显式引用可能被裁剪的类：

// 无需主动调用，仅用于告知链接器保留相关类不被裁剪
private void PreserveReflectionDependencies()
{
    var dummy1 = typeof(System.Data.Services.Client.DataServiceContext);
    var dummy2 = typeof(System.Numerics.Vectors.Vector);
    // 其他有反射调用依赖的类按以上格式添加即可
}

内容的提问来源于stack exchange，提问作者Nicolas Blanco Storz