ObjC协议中参数名称缩短的规则是什么？

Question

我有以下问题： 我有快速实现的 ObjC 协议：

// ObjC protocol

@protocol PhonebookSomeEventCallback

- (void)onEvent:(nonnull NSUUID *)outUserId
   someNumValue:(int32_t)someNumValue
   lotOfPersons:(nonnull NSArray<PhonebookPerson *> *)lotOfPersons;

@end
//=====================================
// Swift impl
class PhonebookSomeEventCallbackImpl: PhonebookSomeEventCallback
{
    public func onEvent(_ outUserId: UUID,someNumValue: Int32,lotOfPersons: [PhonebookPerson])
    {
    }
}

构建失败并出现以下错误：

 error: instance method 'onEvent(_:someNumValue:lotOfPersons:)' has different argument labels from those required by protocol 'PhonebookSomeEventCallback' ('onEvent(_:someNumValue:lotOf:)')
    public func onEvent(_ outUserId: UUID,someNumValue: Int32,lotOfPersons: [PhonebookPerson])
                ^
                                                              lotOf 
Phonebook.PhonebookSomeEventCallback:3:10: note: requirement 'onEvent(_:someNumValue:lotOf:)' declared here
    func onEvent(_ outUserId: UUID, someNumValue: Int32, lotOf lotOfPersons: [PhonebookPerson])
         ^
/Users/g.a.igumnov/work/mobile/phonebook/controller/mobile-app/x86_64/subprojects/controller/service-sbis-phonebook/phonebook/djinni/swift/phonebook/PhonebookSomeEventEvent.swift:32:17: error: 'onEvent(_:someNumValue:lotOfPersons:)' has been renamed to 'onEvent(_:someNumValue:lotOf:)'
    public func onEvent(_ outUserId: UUID,someNumValue: Int32,lotOfPersons: [PhonebookPerson])
                ^
                                                              lotOf 
Phonebook.PhonebookSomeEventCallback:5:10: note: 'onEvent(_:someNumValue:lotOfPersons:)' was obsoleted in Swift 3
    func onEvent(_ outUserId: UUID, someNumValue: Int32, lotOfPersons: [PhonebookPerson])

通过实验，我发现了以下原则 如果参数名称以关键字之一结尾（'of'、'with'、'by'、'from'、'on' - 我找到的那些）后跟类型名称（或其中的一部分，我有类 PhonebookPerson，但只有 Person 有效）数组的复数形式和非数组的单数形式，类型名称从参数名称中删除。

我有两个问题

1. 是否有任何关于这种黑魔法的文档？
2. 除了不写此类名称之外，还有什么正确的方法可以避免这种情况？

Answer 1

我将您的协议放在我的测试项目中，并使用快捷方式让 xcode 自动生成协议功能，这就是它所做的

class PhonebookSomeEventCallbackImpl: PhonebookSomeEventCallback
{
    // I replaced the PhonebookPerson with UIView
    //
    // Also, ou can use auto-generation by complying with the protocol, compiling
    // and then pressing cmd+option+ctrl + F to have it generate the function
    func onEvent(_ outUserId: UUID, someNumValue: Int32, lotOfPersons: [UIView]) {
        <#code#>
    }

}

排除我对 UIView 的替换，您似乎在做正确的事情。

看起来你做的一切都是正确的，它如何将 obj-c 函数转换为 swift 并没有什么黑魔法。第一项没有参数名称，所有其他参数名称应为 1-1。

附：也可以在编译错误弹出后使用快捷方式自动生成函数