BBSwiftUIKit 开源项目教程

1. 项目的目录结构及介绍

BBSwiftUIKit 项目的目录结构如下：

BBSwiftUIKit/
├── BBSwiftUIKit.xcworkspace
├── BBSwiftUIKit
│   ├── Sources
│   │   └── BBSwiftUIKit
│   │       ├── BBScrollView.swift
│   │       ├── BBTableView.swift
│   │       └── ...
│   ├── BBSwiftUIKitDemo
│   │   ├── ContentView.swift
│   │   └── ...
│   ├── .gitignore
│   ├── BBSwiftUIKit.podspec
│   ├── LICENSE
│   ├── Package.swift
│   └── README.md

目录结构介绍

• BBSwiftUIKit.xcworkspace: Xcode 工作区文件，用于管理和打开项目。
• BBSwiftUIKit: 主项目目录，包含源代码和演示应用。
  • Sources/BBSwiftUIKit: 核心库的源代码文件。
    • BBScrollView.swift: 滚动视图组件。
    • BBTableView.swift: 表格视图组件。
    • ...
  • BBSwiftUIKitDemo: 演示应用的源代码文件。
    • ContentView.swift: 演示应用的主视图文件。
    • ...
  • .gitignore: Git 忽略文件配置。
  • BBSwiftUIKit.podspec: CocoaPods 配置文件。
  • LICENSE: 项目许可证文件。
  • Package.swift: Swift Package Manager 配置文件。
  • README.md: 项目说明文档。

2. 项目的启动文件介绍

BBSwiftUIKit 项目的启动文件位于 BBSwiftUIKitDemo 目录下的 ContentView.swift 文件。

ContentView.swift

import SwiftUI
import BBSwiftUIKit

struct ContentView: View {
    @State var list: [Int] = (0..<50).map { $0 }
    @State var isRefreshing: Bool = false
    @State var isLoadingMore: Bool = false
    @State var isReloadData: Bool = false

    var body: some View {
        BBTableView(list) { i in
            Text("Text\(i)")
                .padding()
                .background(Color.blue)
        }
        .bb_pullDownToRefresh(isRefreshing: $isRefreshing) {
            print("Refresh")
            DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
                self.list = (0..<50).map { $0 }
                self.isRefreshing = false
            }
        }
        .bb_pullUpToLoadMore(bottomSpace: 40) {
            if self.list.count < 100 {
                self.list.append(contentsOf: (50..<100).map { $0 })
            }
        }
    }
}

启动文件介绍

• ContentView.swift: 这是演示应用的主视图文件，展示了如何使用 BBSwiftUIKit 库中的 BBTableView 组件实现上拉加载和下拉刷新功能。
• @State 变量用于管理列表数据和刷新状态。
• BBTableView 组件用于显示列表数据，并通过 bb_pullDownToRefresh 和 bb_pullUpToLoadMore 方法实现刷新和加载更多功能。

3. 项目的配置文件介绍

BBSwiftUIKit 项目的配置文件主要包括 Package.swift 和 BBSwiftUIKit.podspec。

Package.swift

// swift-tools-version:5.3
import PackageDescription

let package = Package(
    name: "BBSwiftUIKit",
    platforms: [
        .iOS(.v13)
    ],
    products: [
        .library(
            name: "BBSwiftUIKit",
            targets: ["BBSwiftUIKit"]
        )
    ],
    dependencies: [],
    targets: [
        .target(
            name: "BBSwiftUIKit",
            dependencies: []
        )