Xamarin.iOS绑定第三方框架后单例属性始终为空，求解决

问题描述 #

已成功构建第三方Swift框架的Xamarin.iOS绑定：使用Objective Sharpie生成绑定代码后，做了移除验证属性、添加类名等修改，项目编译正常。但调用框架中NokeDeviceManager类的单例实例时始终为空，导致应用崩溃。在Swift测试项目中通过CocoaPod引入该框架，所有功能正常，调试仅输出单例为空，无其他有效日志。

已执行操作：

• 为Swift类添加@objc修饰
• 使用Objective Sharpie生成ApiDefinition.cs和StructsAndEnums.cs，配合第三方.framework库
• 构建iOS绑定项目并生成DLL
• 调用NokeDeviceManager.Shared时始终返回空

绑定代码中生成的单例属性如下：

[BindingImpl(BindingImplOptions.GeneratedCode | BindingImplOptions.Optimizable)]
public static NokeDeviceManager Shared
{
[Export("shared")]
get
{
return Runtime.GetNSObject(Messaging.NativeHandle_objc_msgSend(class_ptr, Selector.GetHandle("shared")));
}
}

排查与解决方案 #

1. 确认Swift单例的Objective-C暴露名称 #

Swift静态属性默认暴露给Objective-C的选择器可能与预期不符，需确保单例属性被正确标记：

• 若Swift单例定义为：

  @objcMembers
  class NokeDeviceManager: NSObject {
      static let shared = NokeDeviceManager()
      // 其他代码
  }
  

  默认暴露的选择器可能是sharedInstance而非shared，需显式指定@objc修饰单例属性：

  @objcMembers
  class NokeDeviceManager: NSObject {
      @objc static let shared = NokeDeviceManager()
      // 其他代码
  }
  

  或者自定义Objective-C选择器名称：

  @objcMembers
  class NokeDeviceManager: NSObject {
      static let shared = NokeDeviceManager()
      @objc(shared) static var objcShared: NokeDeviceManager {
          return shared
      }
  }
  

2. 验证绑定代码的选择器匹配 #

使用nm命令检查.framework库中的符号，确认实际选择器名称：

nm -gU /path/to/NokeDeviceManager.framework/NokeDeviceManager | grep shared

若输出显示选择器为sharedInstance，则需修改绑定代码的Export属性：

[Export("sharedInstance")]

3. 确认绑定类的基类正确性 #

NokeDeviceManager必须继承自NSObject，未继承的Swift类即使添加@objc也无法被Xamarin正确绑定，检查Swift类定义是否符合：

class NokeDeviceManager: NSObject {
    // 类实现
}

4. 检查绑定项目的链接配置 #

在Xamarin.iOS绑定项目中：

• 将.framework文件的Build Action设置为ObjcBindingNativeLibrary
• 若框架包含C++代码，需将IsCxx属性设为True
• 确认.csproj文件中的配置：

<ItemGroup>
  <ObjcBindingNativeLibrary Include="NokeDeviceManager.framework">
    <IsCxx>False</IsCxx>
    <Kind>Framework</Kind>
  </ObjcBindingNativeLibrary>
</ItemGroup>

5. 排查单例初始化逻辑 #

确认Swift单例的初始化方法无异步操作或依赖未满足的条件，在Swift测试项目中验证单例是否能立即返回有效实例，排除延迟初始化导致的nil返回。

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