混合objective-c项目中的Swift“命名空间”不起作用

Posted 2023-02-23

【中文标题】混合objective-c项目中的Swift“命名空间”不起作用

【英文标题】：Swift "namespaces" in mixed objective-c project not working

【发布时间】：2017-09-28 11:28:10

【问题描述】：

我有一个用objective-c编写的自定义框架MyFramework，我在UIColor的objective-c类别中定义了一个方法：

+ (instancetype)my_colorWithRed:(uint8_t)red 
                          green:(uint8_t)green 
                           blue:(uint8_t)blue 
                          alpha:(uint8_t)alpha NS_SWIFT_NAME(init(red:green:blue:alpha:));

我使用 NS_SWIFT_NAME 给它一个正确的 Swift 名称。但是，Swift 名称的声明与 UIColor 中 UIKit 中已经存在的方法相同，即：

init(red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat)

现在，如果我在我的主应用程序中添加一个 Swift 文件——一个链接到 MyFramework 的混合 Objective-c 和 swift 项目——并编写以下内容：

UIColor(red: 1, blue: 0, green: 0, alpha: 1)

调用该方法的UIKit 版本。但如果我写：

MyFramework.UIColor(red: 1, blue: 0, green: 0, alpha: 1)

UIKit 版本的方法仍然被调用。

所以我想知道为什么：

即使方法不明确，在不使用模块名称前缀方法的情况下构建应用程序也不会给我任何警告或错误。我的印象是，如果发生这种情况，我会收到警告。 将MyFramework 指定为方法范围无效。

在 Swift 文件中，我不需要导入 UIKit 或 MyFramework，因为它们已经通过 Swift 桥接头导入；不是直接的，而是通过一些头文件间接导入它们。这可能是导致问题的原因吗？还是因为它是一个混合了 Objective-c 和 Swift 的项目？还是因为这是一个类别上的方法？

更新

来自 Tarun Tyagi 的回答了解了参数类型。 指定类型使其工作：

UIColor(red: UInt8(149), green: UInt8(45), blue: UInt8(152))

这会调用MyFramework 中的方法。这意味着像我最初那样在调用中使用整数：

UIColor(red: 1, blue: 0, green: 0, alpha: 1)

匹配 UIKit 的 init(red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat) 而不是 MyFramework 的 convenience init(red: UInt8, green: UInt8, blue: UInt8)。

如果我创建一个采用 Int 的新类别方法

+ (instancetype)my_colorWithIntRed:(NSInteger)red green:(NSInteger)green blue:(NSInteger)blue alpha:(NSInteger)alpha NS_SWIFT_NAME(init(red:green:blue:alpha:));

然后从主应用调用UIColor(red: 1, blue: 0, green: 0, alpha: 1)，调用匹配该方法。

添加UIKit 或MyFramework 来限定调用没有区别。匹配仅基于参数类型，而不管它定义在哪个模块中。即调用：

UIKit.UIColor(red: 1, blue: 0, green: 0, alpha: 1)

没有报错，MyFramework 中的方法仍然被调用。

如果我在UIColor 的MyFramework 类别中创建一个与UIKit.UIColor 中的完全匹配的初始化器：

+ (instancetype)my_colorWithFloatRed:(CGFloat)red green:(CGFloat)green blue:(CGFloat)blue alpha:(CGFloat)alpha NS_SWIFT_NAME(init(red:green:blue:alpha:));

那么根本就没有生成 Swift 版本。

如果我在 UIColor 的快速扩展中创建相同的方法

@objc public convenience init(red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat) 
    ...

然后我得到一个预期的错误：

带有 Objective-C 选择器 'initWithRed:green:blue:alpha:' 的初始化程序 'init(red:green:blue:alpha:)' 与之前使用相同 Objective-C 选择器的声明冲突

但是当我删除 @obj 以仅使该方法在 Swift 中可用时，我没有收到任何错误，这表明 Swift 允许在由不同模块定义的扩展中具有冲突的方法名称。

所以我从我的主应用程序拨打这个电话：

UIColor(red: CGFloat(0.5), green: CGFloat(0.5), blue: CGFloat(1.0), alpha: CGFloat(1.0))

但我仍然没有得到关于模糊方法的错误，并且调用了 UIKit 版本。此外，符合条件：

MyFramework.UIColor(red: CGFloat(0.5), green: CGFloat(0.5), blue: CGFloat(1.0), alpha: CGFloat(1.0))

再次没有区别。

所以我仍然不明白 Swift 中的隐式命名空间应该如何与扩展一起使用。好像不支持。我阅读了extensions 上的 Swift 编程指南，但没有提及这一点。

【参考方案1】：

在不使用模块名称前缀方法的情况下构建应用程序不会给我任何警告或错误，即使方法不明确。我的印象是，如果发生这种情况，我会收到警告

这看起来像 -

A.要么它应该在 Swift 中翻译成使用UInt8 而不是CGFloat，因此它会根据输入类型而有所不同。

B.或者它不应该允许在NS_SWIFT_NAME 中使用init(red:green:blue:alpha:)，因为它会与已经存在的初始化程序发生冲突。

A 和 B 都没有发生，所以这似乎是一个错误。您应该提交雷达以进一步调查。

指定 MyFramework 来限定方法无效

UIColor 不属于您的自定义框架，您只是在扩展它。唯一地命名方法是您的责任。 一个可能的名称是 my_color(red:green:blue:alpha:) 内 NS_SWIFT_NAME 以使其唯一。

很明显，您的命名 init(red:green:blue:alpha:) 与 UIKit 标准初始化程序冲突，如果您没有收到编译器警告并且能够运行，UIKit 变体将胜过您的自定义变量。

希望对你有帮助。

编辑 1：参考 https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/CustomizingExistingClasses/CustomizingExistingClasses.html

在此处将其添加为屏幕截图，因为链接可能会在将来的修订版中中断。

虽然引用是针对 Objective-C 而不是 Swift 扩展，但这对 UIColor 扩展有效，因为到目前为止所有 UIKit 仍然是 Objective-C。

【讨论】：

您是否引用了来自 Apple 或 Swift 团队的源代码，其中指出扩展中的方法名称必须是唯一的？

@Karmeye 请查看答案中的EDIT 1: Reference。谢谢。

我知道 Objective-c 类别就是这种情况。我专门询问 Swift 扩展。

【参考方案2】：

尝试为您的框架类添加一些独特的前缀。称之为 MyFrameworkUIColor

【讨论】：

可以的。但问题是为什么用模块名称明确限定不调用正确的方法。