MAUI绑定iOS委托类时实例化失败，寻求解决方法

API 探路者

2026-7-9

解决iOS框架绑定MAUI时委托实例化错误的思路

核心问题分析

你遇到的错误根源是对C#继承规则的误解：原生协议WYSSignatureProcessDelegate继承了NSObjectProtocol，要求遵循该协议的类必须是NSObject子类。C#中继承NSObject类 + 实现协议接口属于单继承+多接口实现，完全符合语法规范，并非你以为的“多继承”。直接继承绑定生成的协议接口会导致原生侧无法识别实例，从而抛出类未加载的错误。

具体解决方案

1. 保留Sharpie生成的绑定代码

绑定代码无需修改，它已正确映射原生协议：

// @protocol WYSSignatureProcessDelegate <NSObject>
[Protocol]
[BaseType (typeof(NSObject))]
interface WYSSignatureProcessDelegate
{
    // @required -(void)documentPreparedForSignature:(NSData * _Nonnull)documentDigest withReason:(NSString * _Nonnull)reason;
    [Abstract]
    [Export ("documentPreparedForSignature:withReason:")]
    void DocumentPreparedForSignature (NSData documentDigest, string reason);
}

2. 修正C#委托实现类

改为继承NSObject并实现协议接口，同时保留[Export]属性让原生识别协议方法：

private class SignatureProcessDelegate : NSObject, WYSSignatureProcessDelegate
{
    public event EventHandler<IDocumentPreparedEventArgs> DocumentPreparedEventHandler;

    [Export("documentPreparedForSignature:withReason:")]
    public void DocumentPreparedForSignature(NSData documentDigest, string reason)
    {
        // 将NSData转换为Stream供上层业务逻辑使用
        using var stream = documentDigest.AsStream();
        DocumentPreparedEventHandler?.Invoke(this, new DocumentPreparedEventArgs(stream, reason));
    }
}