将 Swift 项目转换为易于使用的 Cocoapods 框架
Converting Swift project into an easy-to-use framework for Cocoapods
所以我需要一些帮助，因为我真的想不通并且已经花了很多时间没有任何结果。我在互联网上找到的大部分内容都是关于如何将 swift 项目转换为框架，但我的问题不是项目本身或 cocoapods，而是关于 如何以及我应该做什么开发人员可以访问。
所以我构建了一个 Swift 框架， 你可以找到 here，它是用 UICollectionView 和自定义 [=14] 构建的=] 和侧滑功能。
问题 是我不知道如何让开发人员更容易使用它，我想让它表现得像 UICollectionView您需要在其中实现自定义委托和数据源，而不必使用默认的 UICollectionViewDelegate 和 UICollectionViewDatasource，这样我就可以过滤掉会导致意外行为的事情，或者让事情变得简单。
那么什么是好的方法呢？我正在考虑可能 classing UICollectionView 这样人们就不必使用 UICollectionView （因为这可能会造成混淆）而是 VerticalCardSwiperView相同的行为，但更有限。我只是不知道这是否是正确的方法。
任何提示、见解或好的例子将不胜感激！
edit 1: 我更新了项目，所以它已经有了框架结构，我只需要弄清楚我将如何向开发人员提供对自定义部分的访问权限.
edit 2: 我得到了一个答案，但我认为这个问题可能很容易被误解。目标是使它的行为和行为像 UICollectionView（具有委托、数据源……）但更受限制，我想知道我如何才能实现这一点，如果可能的话。
edit 3: 好吧，我已经完成大部分工作了，我会在这里给 Github 在线留下一个 link 以便需要的人类似的东西可以自己查一下。本质上，我所做的是自定义 VerticalCardSwiperDelegate 和 VerticalCardSwiperDatasource，如下所示：
/// This datasource is used for providing data to the `VerticalCardSwiper`.
public protocol VerticalCardSwiperDatasource: class {
/**
Sets the number of cards for the `UICollectionView` inside the VerticalCardSwiperController.
- parameter verticalCardSwiperView: The `VerticalCardSwiperView` where we set the amount of cards.
- returns: an `Int` with the amount of cards we want to show.
*/
func numberOfCards(verticalCardSwiperView: VerticalCardSwiperView) -> Int
/**
Asks your data source object for the cell that corresponds to the specified item in the `VerticalCardSwiper`.
Your implementation of this method is responsible for creating, configuring, and returning the appropriate `CardCell` for the given item.
- parameter verticalCardSwiperView: The `VerticalCardSwiperView` that will display the `CardCell`.
- parameter index: The that the `CardCell` should be shown at.
- returns: A CardCell object. The default value is an empty CardCell object.
*/
func cardForItemAt(verticalCardSwiperView: VerticalCardSwiperView, cardForItemAt index: Int) -> CardCell
}
然后我将它们连接到 VerticalCardSwiper class:
public func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
return datasource?.numberOfCards(verticalCardSwiperView: verticalCardSwiperView) ?? 0
}
public func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
return (datasource?.cardForItemAt(verticalCardSwiperView: verticalCardSwiperView, cardForItemAt: indexPath.row))!
}
最后，我刚刚将 UICollectionView 转换为 VerticalCardSwiperView 并将其作为参数传递（因为它基本上是 class 的子class UICollectionView 它做同样的事情，只是有一个不同的名字，这对开发人员来说更容易理解）对于 delegate/datasource 函数。希望这可以帮助别人。另外，如果你有更好的方法，请告诉我。
看起来很棒！
我想说的是，如果您想公开 UICollectionView，请遵循 UITableView 以及 UIScrollView 子类代表的方法。
protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
// ...
您还可以在 VerticalCardSwiperDelegate 和 VerticalCardSwiperDataSource 委托中分别子类化 UICollectionViewDelegate 和 UICollectionViewDataSource，以获得相同的效果。 （如果您认为这样做有意义。）
protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
// ...
就是说，您的组件非常具体，暴露底层的 UICollectionView 可能会导致问题。在这里，我将锁定所有实现细节并使其一直 VerticalCardSwiper 。这使您可以灵活地完成底层架构的更改。
例如，在您的委托中，您将传回 VerticalCardSwiper 而不是底层组件..
func cardForItemAt(verticalCardSwiper: VerticalCardSwiper, cardForItemAt index: Int) -> CardCell {
// ...
通常，您希望暴露的界面尽可能小。这是为了帮助指导开发人员（要学的东西更少），也减少了您维护和回答问题的时间。
对 public 界面的一些评论会有所帮助。当我可以按住 command-alt-click 以获得一些提示时，我很高兴。 你已经做到了。
所以我需要一些帮助，因为我真的想不通并且已经花了很多时间没有任何结果。我在互联网上找到的大部分内容都是关于如何将 swift 项目转换为框架，但我的问题不是项目本身或 cocoapods，而是关于 如何以及我应该做什么开发人员可以访问。
所以我构建了一个 Swift 框架， 你可以找到 here，它是用 UICollectionView 和自定义 [=14] 构建的=] 和侧滑功能。
问题 是我不知道如何让开发人员更容易使用它，我想让它表现得像 UICollectionView您需要在其中实现自定义委托和数据源，而不必使用默认的 UICollectionViewDelegate 和 UICollectionViewDatasource，这样我就可以过滤掉会导致意外行为的事情，或者让事情变得简单。
那么什么是好的方法呢？我正在考虑可能 classing UICollectionView 这样人们就不必使用 UICollectionView （因为这可能会造成混淆）而是 VerticalCardSwiperView相同的行为，但更有限。我只是不知道这是否是正确的方法。
任何提示、见解或好的例子将不胜感激！
edit 1: 我更新了项目，所以它已经有了框架结构，我只需要弄清楚我将如何向开发人员提供对自定义部分的访问权限.
edit 2: 我得到了一个答案，但我认为这个问题可能很容易被误解。目标是使它的行为和行为像 UICollectionView（具有委托、数据源……）但更受限制，我想知道我如何才能实现这一点，如果可能的话。
edit 3: 好吧，我已经完成大部分工作了，我会在这里给 Github 在线留下一个 link 以便需要的人类似的东西可以自己查一下。本质上，我所做的是自定义 VerticalCardSwiperDelegate 和 VerticalCardSwiperDatasource，如下所示：
/// This datasource is used for providing data to the `VerticalCardSwiper`.
public protocol VerticalCardSwiperDatasource: class {
/**
Sets the number of cards for the `UICollectionView` inside the VerticalCardSwiperController.
- parameter verticalCardSwiperView: The `VerticalCardSwiperView` where we set the amount of cards.
- returns: an `Int` with the amount of cards we want to show.
*/
func numberOfCards(verticalCardSwiperView: VerticalCardSwiperView) -> Int
/**
Asks your data source object for the cell that corresponds to the specified item in the `VerticalCardSwiper`.
Your implementation of this method is responsible for creating, configuring, and returning the appropriate `CardCell` for the given item.
- parameter verticalCardSwiperView: The `VerticalCardSwiperView` that will display the `CardCell`.
- parameter index: The that the `CardCell` should be shown at.
- returns: A CardCell object. The default value is an empty CardCell object.
*/
func cardForItemAt(verticalCardSwiperView: VerticalCardSwiperView, cardForItemAt index: Int) -> CardCell
}
然后我将它们连接到 VerticalCardSwiper class:
public func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
return datasource?.numberOfCards(verticalCardSwiperView: verticalCardSwiperView) ?? 0
}
public func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
return (datasource?.cardForItemAt(verticalCardSwiperView: verticalCardSwiperView, cardForItemAt: indexPath.row))!
}
最后，我刚刚将 UICollectionView 转换为 VerticalCardSwiperView 并将其作为参数传递（因为它基本上是 class 的子class UICollectionView 它做同样的事情，只是有一个不同的名字，这对开发人员来说更容易理解）对于 delegate/datasource 函数。希望这可以帮助别人。另外，如果你有更好的方法，请告诉我。
看起来很棒！
我想说的是，如果您想公开 UICollectionView，请遵循 UITableView 以及 UIScrollView 子类代表的方法。
protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
// ...
您还可以在 VerticalCardSwiperDelegate 和 VerticalCardSwiperDataSource 委托中分别子类化 UICollectionViewDelegate 和 UICollectionViewDataSource，以获得相同的效果。 （如果您认为这样做有意义。）
protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
// ...
就是说，您的组件非常具体，暴露底层的 UICollectionView 可能会导致问题。在这里，我将锁定所有实现细节并使其一直 VerticalCardSwiper 。这使您可以灵活地完成底层架构的更改。
例如，在您的委托中，您将传回 VerticalCardSwiper 而不是底层组件..
func cardForItemAt(verticalCardSwiper: VerticalCardSwiper, cardForItemAt index: Int) -> CardCell {
// ...
通常，您希望暴露的界面尽可能小。这是为了帮助指导开发人员（要学的东西更少），也减少了您维护和回答问题的时间。
对 public 界面的一些评论会有所帮助。当我可以按住 command-alt-click 以获得一些提示时，我很高兴。 你已经做到了。