Swift框架(适用于iOS)中的正确命名空间(或类命名)约定

>如果框架被称为AEConicalGradient,那么它中的类应该叫做ConicalGradientLayer和ConicalGradientView或者只是Layer和View？
>如果框架被称为AELog,并且它也有类也称为AELog和其他类称为Line的一些委托回调正在使用此Line类型,如果您的代码还具有称为Line的定义类型,那么如何实现此委托,因为添加框架名称为方法签名func didLog(line：AELog.Line)中的前缀将使错误’Line’不是“AELog”的成员类型,实际上它不是(它是AELog框架的一部分,但它不是AELog类的成员里面).

阅读更多

在为Swift 3更新我的几个框架时,我对框架类的正确命名约定有很多第二想法,这取决于框架名称本身.

最后我意识到我并没有在不同的框架中使用相同的约定,所以现在我不喜欢这种缺乏一致性.

我会直接跳到我遇到的一些现实世界的例子中：

示例：框架没有一个名为框架名称的类：

框架命名为AEConicalGradient,它由2个公共类组成：

> CALayer子类
> UIView子类

每个这些课程应该是正确的名称？

a)AEConicalGradientLayer和AEConicalGradientView

b)ConicalGradientLayer和ConicalGradientView

c)图层和视图

讨论：

a)我在第一个版本的框架中使用了这两个类,在单个AEConicalGradient.swift文件中.我不喜欢这种方法,我将资源分成多个文件,所以现在我在b)和c)之间考虑.

b)在这种方法中,我喜欢有人可以将这些文件拖入项目(例如,不使用任何依赖管理器)或复制/粘贴代码,并且不会因为清楚的名称而松动上下文(因为清楚的名称),而是在如果您将其视为AEConicalGradient.ConicalGradientLayer和AEConicalGradient.ConicalGradientView,那么它的声音有点重复.

c)AEConicalGradient.Layer和AEConicalGradient.View听起来像我想要的方式,但在另一方面,如果有人拥有自己的Layer或View类,或者如果他们只是拖动文件或复制/粘贴,那么它们更有可能发生冲突代码上下文几乎丢失了(像这样的Layer或View类是什么？).

2.示例：Framework有一个名为框架名称的类：

框架被命名为AELog,它由3个公共类和一个委托协议组成：

>共享实例(并为其委托)
>日志线模型
>配置

讨论：

a)类似于第一个版本框架中的第一个例子,我有一个名为AELog,AELogDelegate,AELogLine和AELogConfig的类 – 所有内部单个AELog.swift文件.

b)在Swift 3的最新更新中,我结束了多个文件和类名：AELog,Line和Config.

那就是当我意识到如果你导入AELog并实现AELogDelegate(它只有func didLog(line：Line))和你已经有一个不同的Line类在你自己的模块中定义,它会产生一个冲突,只能通过重命名一个那两个班级班！

说实话,我真的不明白如何避免这种情况.因为如果您尝试使用委托方法中的命名空间类型,如func didLog(line：AELog.Line),则会收到错误’Line’不是“AELog”的成员类型,但它不是AELog类的成员).

那就是当我开始感到有点担心这个“松散”的命名.对此具体事项有任何建议或意见？

c)本着在1.c)方法中的非常“松散”命名的精神,可以将AELog类重命名为Log,并将AELogDelegate重命名为Delegate？这个修正错误是否在2.b中说明),因为没有类与框架名称相同,因此编译器会在这种情况下识别AELog.Line？

题：
这些方法之一有什么“干净的代码”论证？有没有一个明显的“适当”的方式呢？我在这里缺少一些重要的东西吗？