PTBaseKit

Thinker系列项目通用模块，适用于Thinker开发的iOS客户端全系列项目。

Install:

pod 'PTBaseKit', :git => 'https://github.com/p36348/PTBaseKit.git'

CssKit

用运算符"+"、"+="把CssKit对象添加给UIKit组件，

传统UILabel赋值:

let customLabel: UILabel = UILabel()
customLabel.font = 13.customFont
customLabel.textColor = UIColor.tk.main
customLabel.text = "custom label"

使用CssKit赋值:

let customLabel: UILabel = UILabel() + 13.customFont.css + UIColor.tk.main.textColorCss + "custom label".css

或者:

let customLabel: UILabel = UILabel()
customLabel += 13.customFont.css
customLabel += UIColor.tk.main.textColorCss
customLabel += "custom label".css

BaseController

作为项目所有界面控制器的基类，有以下主要作用：

• 部分情景下，一个界面会有较多UI元素，某些旧设备在navigate或者present的过程中会有些许卡顿，BaseController把viewDidLoad函数做了拆分，分别是performPreSetup和performPreSetup，其中前者在viewDidLoad函数中同步调用，而后者则是通过RunLoop特性延迟了调用，调用时机就是界面转场动画完结之时。
• 为了方便配合RxSwift框架使用，集成了用于管理DisposeBag的功能：
  • 函数disposed(by:identifier:)
    • 把Observable的销毁绑定到BaseController上，在deinit的时候，BaseController内部会自己销毁绑定的订阅
  • 函数dispose(identifier:)
    • 当部分订阅需要提前手动销毁时，调用此函数。
• 大部分情况下我们需要创建的页面都是功能雷同的，因此项目中只有少数界面是通过定义一个新的类型来实现，取而代之是使用静态函数去创建一个BaseController的实例。通过此模块对BaseController封装的接口可以在静态函数中实现大部分我们需要做的适配。这样做可以大大减少重复代码，可以把同一业务模块的代码放在同一个文件中。MapController.swift文件中有一个例子：

func createMapController() -> UIViewController {
    let controller = BaseController()

    let mapAdapter: MapAdapter = createDefaultMapAdapter()

    mapAdapter
        .didUpdateUserLocation
        .take(1)
        .subscribe(onNext: { $0.adapter.moveCenter(to: $0.location) })
        .disposed(by: controller)

    mapAdapter
        .didTapAtLocation
        .subscribe(onNext: { $0.adapter.moveCenter(to: $0.location) })
        .disposed(by: controller)

    mapAdapter
        .didIdleAtLocation
        .subscribe()
        .disposed(by: controller)

    controller.rx.viewDidLoad
        .subscribe(onNext: { (_controller) in
            _controller.view.addSubview(mapAdapter.map.viewValue)
            mapAdapter.map.viewValue.snp.makeConstraints {$0.edges.equalToSuperview()}
        })
        .disposed(by: controller)

    controller.rx.viewDidAppear
        .subscribe(onNext: { (_controller) in
            mapAdapter.enable(false)
        })
        .disposed(by: controller)

    controller.rx.viewDidDisappear
        .subscribe(onNext: { (_controller) in
            mapAdapter.enable(true)
        })
        .disposed(by: controller)

    return controller
}

func createDefaultMapAdapter() -> MapAdapter {
    return GoogleMapsAdapter(googleApiKey: "yourKey",
                             defaultLocation: CLLocationCoordinate2D(latitude: 1.420612, longitude: 103.862463))
}

ListController

目前Thinker的项目使用了UITableView和UICollectionView实现列表界面。为了方便快捷，本模块预先封装了基础的列表功能和配置入口，并根据MVVM设计模式做了协议规定：

• 抽象协议ListController
  • 声明了列表界面必需具备的行为reload和loadMore函数。
  • 泛型声明列表View类型，列表数据ViewModel类型。
• Section作为ListController的data单位
• Cell作为Section的data单位

而实际上开发中真正用到的是以下两个类型：

1. CommonTableController
2. IGListViewController

CommonTableController

• 使用者需要创建一个UITableView列表界面的时候可以直接使用CommonTableController, 它提供的接口可以应付大部分使用场景. 这样有利于避免创建多个ViewController带来的维护高成本和低代码复用。
• 专注SectionViewModel/TableCellViewModel的产生和变化，它们以数组的形式传入CommonTableController, 根据数组中元素顺序的不同，CommonTableController的显示内容就会有相应变化。
• 它的 数据加载逻辑/组件加载逻辑/组件刷新逻辑 都通过了验证。
• 提供简单的配置函数来给使用者对页面的顶部和底部添加UI组件，以及数据为空时候的UI提示。

UIKitTableController.swift文件中有一个调用CommonTableController的例子:

CommonTableController()
 .setBackgroungColor(UIColor.tk.background)
 .setAutoLoading(false)
 .setupHeader(someHeaderView)
 .setupFooter(someFooterView)
 .setupTableView(with: .sepratorStyle(.singleLine), .allowMultiSelection(true), .automaticallyAdjustsScrollViewInsets(false))
 .setupEmptyPlaceHolder(image: UIImage(named: "empty_tips"), title: "No data yet".attributed())
 .performWhenReload { (_table) in
   Observable.just(fakeFetchData())
     .subscribeOn(ConcurrentDispatchQueueScheduler(qos: DispatchQoS.default))
     .observeOn(MainScheduler.asyncInstance)
     .subscribe(onNext: { _table.reload(withSectionViewModels: $0) })
     .disposed(by: _table)
 }
 .performWhenLoadMore { (_table) in
   Observable.just(fakeFetchData())
     .subscribeOn(ConcurrentDispatchQueueScheduler(qos: DispatchQoS.default))
     .observeOn(MainScheduler.asyncInstance)
     .subscribe(onNext: { _table.loadMore(withSectionViewModels: $0, isLast: true) })
     .disposed(by: _table)
}

其中performWhenReload和performWhenLoadMore分别用于传入加载操作, 需要调用者自己结束加载. 回调闭包中有一个参数正是CommonTableController本身.例子中使用了RxSwift三方框架配合展示了这个加载过程, fakeFetchData替代了项目中的网络请求以及Model->ViewModel的操作, 实际上thinker的项目中就是按照这个方式实现, 实现这一步操作的是各个业务模块对应的Service.

CommonTableCell

CommonTableCell是在TableController协议基础上实现的一个UITableViewCell子类, 根据thinker项目总结而来.

• 它已经几乎兼容thinker目前所有列表的显示需要, 订单, 用户信息, 活动, 设置, 消息等。

• 只需要传入不同的参数来创建ViewModel, 并传入CommonTableController，就可以得到各种自适应高度的界面，这个高度是其ViewModel初始化的时候实现的，并不需要使用者自己计算。

• 使用了比较好理解的fram计算来实现layout。 这样除了提供不错的滑动性能， 也让使用者根据项目变更的情况较快修改，比起Texture这种滑动性能极佳可是又难上手的框架，或者直接使用SnapKit来牺牲性能要来得好。

• 由于iOS 12以后增强了Autolayout的性能，日后可以更省心了。: P

  为了遵守高内聚低耦合, 在使用的时候应该把Model->ViewModel这一步操作抽出，不要添加init函数到CommonTableCell的ViewModel代码中。

IGListViewController

顾名思义，用IGListKit封装而来，用来显示比TableView更复杂的混排界面，如：反馈列表。（实际上可以用IGListViewController来替代原来已经实现的CommonTableController）

Reactive extensions

RxSwift框架的核心类型，Thinker项目中大量使用了该框架，此模块对Reactive做了一些常用的封装：

• UIViewController
  • controlEvent(with:)
    • 返回控制器生命周期的事件回调
• UIScrollView+MJRefresh
  • pullToRefresh
    • 下拉刷新事件
  • pullToLoadMore
    • 上拉加载事件
  • refreshing
    • 刷新状态

To be continued...