将Swift项目转换为易于使用的Cocoapods框架

时间:2018-05-14 13:10:55

标签: ios swift cocoa-touch cocoapods swift-framework

所以我需要一些帮助,因为我无法解决这个问题,并且已经花了很多时间在它上面而没有任何结果。我在互联网上找到的大部分内容都是关于如何将快速项目转换为框架,但我的问题不是项目本身或cocoapods,而是关于我应该如何做什么开发人员可以访问

所以我构建了一个Swift框架,你可以找到here ,它是用UICollectionView构建的,带有自定义flowlayout并且侧面滑动功能。

问题是因为我不知道如何让开发人员轻松使用它,我想让它的行为像UICollectionView那样您需要实现自定义委托和数据源,而不必使用默认的UICollectionViewDelegateUICollectionViewDatasource,因此我可以过滤掉会导致意外行为的事情,或者只是保持简单。

那么这里有什么好方法呢?我正在考虑可能会对UICollectionView进行子类化,因此人们不必使用UICollectionView(因为这可能会让人感到困惑),而VerticalCardSwiperView则具有相同的功能行为,但有点受限。我不知道这是否是正确的做法。

任何提示,见解或好的例子都将深表感谢!

编辑1:我更新了项目,因此它已经具有框架结构,我只需要弄清楚我将如何向开发人员提供对自定义部件的访问权。

编辑2:我得到了一个答案,但我认为这个问题可能很容易被误解。目标是使其行为和行为像UICollectionView(与代表,数据源,...)但更有限,我想知道如何实现这一点,如果它甚至是可能。

编辑3:好吧,我大部分都在工作,我会在这里留下一个链接到Github的链接,所以需要类似东西的人可以自己检查一下。从本质上讲,我所做的是自定义VerticalCardSwiperDelegateVerticalCardSwiperDatasource,如下所示:

/// 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类中:

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并将其作为参数传递(因为它基本上是UICollectionView的子类对于委托/数据源函数,它们执行相同的操作,只是具有不同的名称,这对开发人员来说更容易理解。希望这有助于其他人。另外,如果您有更好的方法,请告诉我。

1 个答案:

答案 0 :(得分:3)

看起来很棒!

我想说,如果您想公开UICollectionView,请按照UITableView跟随UIScrollView子类代理的方法。

protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
  // ...

您也可以分别在UICollectionViewDelegateUICollectionViewDataSource个委托中继承VerticalCardSwiperDelegateVerticalCardSwiperDataSource,以达到同样的效果。 (如果你认为这样做是有道理的。)

protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
  // ...

也就是说,您的组件非常具体,可能会暴露底层的UICollectionView可能会导致问题。在这里,我将锁定所有实现细节,并一直使它VerticalCardSwiper。这使您可以灵活地完成基础架构的更改。

例如,在您的代理中,您将传回VerticalCardSwiper而不是基础组件..

func cardForItemAt(verticalCardSwiper: VerticalCardSwiper, cardForItemAt index: Int) -> CardCell {
  // ...

通常,您希望将公开的界面保持尽可能小。这是为了帮助指导开发人员(需要学习的东西较少),而不是为了维护和提出问题。

对公共接口的一些评论会有所帮助。我很高兴我可以命令 - alt-click获得一些提示。你已经完成了这个。