ToastUI 项目教程

1. 项目目录结构及介绍

ToastUI 项目的目录结构如下：

ToastUI/
├── CHANGELOG.md
├── LICENSE
├── Package.swift
├── README.md
├── ToastUI.svg
├── Sources/
│   └── ToastUI/
│       ├── Toast.swift
│       ├── ToastView.swift
│       └── ...
├── ToastUISample/
│   ├── ContentView.swift
│   ├── ToastUISampleApp.swift
│   └── ...
└── swiftformat

目录结构介绍：

• CHANGELOG.md: 记录项目的变更日志。
• LICENSE: 项目的开源许可证文件，ToastUI 使用 MIT 许可证。
• Package.swift: Swift 包管理器的配置文件，定义了项目的依赖和目标。
• README.md: 项目的介绍文档，包含项目的概述、使用方法和贡献指南。
• ToastUI.svg: 项目的图标文件。
• Sources/ToastUI/: 包含项目的主要源代码文件，如 Toast.swift 和 ToastView.swift。
• ToastUISample/: 包含项目的示例应用程序代码，如 ContentView.swift 和 ToastUISampleApp.swift。
• swiftformat: 用于代码格式化的配置文件。

2. 项目启动文件介绍

ToastUI 项目的启动文件位于 ToastUISample 目录下，主要文件为 ToastUISampleApp.swift。

ToastUISampleApp.swift

import SwiftUI

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

文件介绍：

• ToastUISampleApp: 这是项目的入口点，使用 @main 属性标记。它定义了一个 App 结构体，包含一个 WindowGroup，其中 ContentView 是应用程序的主视图。

3. 项目的配置文件介绍

ToastUI 项目的主要配置文件是 Package.swift，它定义了项目的依赖和目标。

Package.swift

// swift-tools-version:5.3
import PackageDescription

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

配置文件介绍：

• name: 定义了项目的名称。
• platforms: 指定了项目支持的平台，包括 iOS、macOS、tvOS 和 watchOS。
• products: 定义了项目的产品，这里是一个名为 ToastUI 的库。
• dependencies: 定义了项目的依赖，目前没有外部依赖。
• targets: 定义了项目的构建目标，包括主目标 ToastUI 和测试目标 ToastUITests。

通过以上配置，开发者可以轻松地使用 Swift 包管理器来管理和构建项目。