ActivityIndicatorView 开源项目教程

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

ActivityIndicatorView 项目的目录结构如下：

ActivityIndicatorView/
├── ActivityIndicatorView
│   ├── ActivityIndicatorView.swift
│   ├── IndicatorType.swift
│   ├── Indicators
│   │   ├── Arcs.swift
│   │   ├── Default.swift
│   │   ├── FlickeringDots.swift
│   │   ├── RotatingDots.swift
│   │   └── RotatingShapes.swift
│   └── Views
│       └── ActivityIndicatorView.swift
├── ActivityIndicatorViewExample
│   ├── ActivityIndicatorViewExampleApp.swift
│   ├── ContentView.swift
│   └── Preview Content
│       └── PreviewAssets.xcassets
├── .gitignore
├── .swiftpm
├── .travis.yml
├── LICENSE
├── README.md
└── Package.swift

目录结构介绍

• ActivityIndicatorView: 核心代码目录，包含主要的 SwiftUI 文件和指示器类型文件。

  • ActivityIndicatorView.swift: 主视图文件，定义了 ActivityIndicatorView 的基本结构和行为。
  • IndicatorType.swift: 定义了不同类型的指示器。
  • Indicators: 包含各种指示器的具体实现。
    • Arcs.swift: 弧形指示器实现。
    • Default.swift: 默认指示器实现。
    • FlickeringDots.swift: 闪烁点指示器实现。
    • RotatingDots.swift: 旋转点指示器实现。
    • RotatingShapes.swift: 旋转形状指示器实现。
  • Views: 包含视图相关的文件。
    • ActivityIndicatorView.swift: 视图的具体实现。

• ActivityIndicatorViewExample: 示例项目目录，包含示例应用的代码和资源。

  • ActivityIndicatorViewExampleApp.swift: 示例应用的入口文件。
  • ContentView.swift: 示例应用的主视图文件。
  • Preview Content: 预览内容目录，包含预览资源。
    • PreviewAssets.xcassets: 预览资源文件。

• .gitignore: Git 忽略文件配置。

• .swiftpm: Swift 包管理器配置文件。

• .travis.yml: Travis CI 配置文件。

• LICENSE: 项目许可证文件。

• README.md: 项目说明文档。

• Package.swift: Swift 包管理器配置文件。

2. 项目的启动文件介绍

ActivityIndicatorViewExampleApp.swift

import SwiftUI

@main
struct ActivityIndicatorViewExampleApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

文件介绍

• ActivityIndicatorViewExampleApp.swift: 这是示例应用的入口文件，使用 @main 标记，表示这是应用的启动点。
• ActivityIndicatorViewExampleApp: 定义了应用的主体结构，包含一个 WindowGroup，其中包含 ContentView，即应用的主视图。

3. 项目的配置文件介绍

Package.swift

// swift-tools-version:5.3
import PackageDescription

let package = Package(
    name: "ActivityIndicatorView",
    platforms: [
        .iOS(.v13),
        .macOS(.v10_15),
        .tvOS(.v13),
        .watchOS(.v6)
    ],
    products: [
        .library(
            name: "ActivityIndicatorView",
            targets: ["ActivityIndicatorView"]
        )
    ],
    dependencies: [],
    targets: [
        .target(
            name: "ActivityIndicatorView",
            dependencies: []
        ),
        .testTarget(
            name: "ActivityIndicatorViewTests",
            dependencies: ["ActivityIndicatorView"]
        )
    ]
)

文件介绍

• Package.swift: 这是 Swift 包管理器的配置文件，定义了项目的名称、支持的平台、产品、依赖和目标。
• name: 项目名称。
• platforms: 支持的平台，包括 iOS、macOS、tvOS 和 watchOS。
• products: 定义了项目的产品，即库 `