Xamarin Forms iOS真机部署问题：Link All触发AutoFac异常/Don't Link无限构建

在为物理iPhone构建部署Xamarin Forms应用时遇到以下矛盾问题：

• Android平台：运行正常
• iOS模拟器：使用"Don't Link"设置可正常运行
• iOS物理设备：
  • 设为"Link All"时，触发AutoFac的NoConstructorFoundException
  • 设为"Don't Link"时，构建陷入无限循环，无法完成部署

已确认AutoFac注册逻辑及依赖项均无问题，需解决如何在"Link All"设置下完成真机部署。

构建警告信息（已翻译） #

/Users/mateusz/shftrun/SHFTRUN/SHFTRUN/SHFTRUN.iOS/obj/iPhone/Debug/device-builds/iphone13.2-16.1.2/mtouch-cache/registrar.m(35506,17): 警告 G3E9910A3: 自动属性合成无法合成协议 'CIPhotoEffect' 中声明的属性 'extrapolate' [-Wobjc-protocol-property-synthesis]
@implementation CoreImage_CIPhotoEffect {
                ^
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS17.0.sdk/System/Library/Frameworks/CoreImage.framework/Headers/CIFilterBuiltins.h:417:30: 备注: 属性在此处声明
  @property (nonatomic) bool extrapolate NS_AVAILABLE(14_0, 17_0);
                             ^
/Users/mateusz/shftrun/SHFTRUN/SHFTRUN/SHFTRUN.iOS/obj/iPhone/Debug/device-builds/iphone13.2-16.1.2/mtouch-cache/registrar.m(35583,1): 备注: 添加 '@synthesize' 指令
@end
^
生成1条警告。

1. 配置链接器保留AutoFac相关类型 #

在iOS项目的Linker.xml文件中添加规则，防止链接器移除AutoFac需要的构造函数和类型：

<linker>
  <assembly fullname="Autofac">
    <type fullname="*" />
  </assembly>
  <!-- 替换为你的业务程序集名称，确保依赖类型不被移除 -->
  <assembly fullname="YourApp.Core">
    <type fullname="*" preserve="all" />
  </assembly>
  <assembly fullname="YourApp.Services">
    <type fullname="*" preserve="all" />
  </assembly>
</linker>

若没有Linker.xml，直接在iOS项目中新建该文件，设置其生成操作为LinkDescription。

2. 使用特性标记保留反射实例化类 #

对于通过AutoFac反射实例化的类，添加[Preserve(AllMembers = true)]特性，强制链接器保留所有成员：

using Xamarin.Forms;

[Preserve(AllMembers = true)]
public class YourService : IYourService
{
    public YourService(ISomeDependency dependency)
    {
        // 构造函数逻辑
    }
}

3. 切换至"Link SDK Assemblies Only"模式 #

如果"Link All"过于激进，可尝试此折中方案：

• 右键iOS项目 → 属性 → iOS生成 → 链接器行为 → 选择"Link SDK Assemblies Only"
  该模式仅链接系统SDK程序集，业务代码不会被裁剪，既能避免构造函数被移除，又可规避"Don't Link"的构建循环问题。

4. 清理并重建项目 #

完成配置后执行以下步骤：

• 清理解决方案：菜单 → 项目 → 清理解决方案
• 删除iOS项目的obj和bin目录
• 重启Visual Studio for Mac或Xcode
• 重新构建并部署到物理设备

5. 处理CoreImage警告（可选） #

当前警告并非问题直接诱因，可通过以下方式消除：

• 在iOS项目的mtouch参数中添加-warnaserror:false，禁止将警告视为错误
• 手动修改CoreImage绑定代码，在CoreImage_CIPhotoEffect实现中添加@synthesize extrapolate;

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