开源项目 Coordinator 使用教程

开源项目 Coordinator 使用教程

CoordinatorImplementation of Coordinators app design pattern.项目地址:https://gitcode.com/gh_mirrors/co/Coordinator

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

目录结构

Coordinator/
├── Coordinator/
│   ├── AppDelegate.swift
│   ├── SceneDelegate.swift
│   ├── ViewController.swift
│   ├── Coordinator.swift
│   ├── MainCoordinator.swift
│   ├── StoryboardCoordinator.swift
│   └── ViewModel.swift
├── CoordinatorTests/
│   └── CoordinatorTests.swift
├── CoordinatorUITests/
│   └── CoordinatorUITests.swift
├── Coordinator.xcodeproj
│   └── project.pbxproj
├── Coordinator.xcworkspace
│   └── contents.xcworkspacedata
├── Podfile
├── README.md
└── LICENSE

目录介绍

• Coordinator/: 项目的主要代码文件夹，包含应用的主要逻辑和视图控制器。
  • AppDelegate.swift: 应用的入口文件，负责应用的生命周期管理。
  • SceneDelegate.swift: 负责场景的生命周期管理（仅适用于 iOS 13 及以上版本）。
  • ViewController.swift: 示例视图控制器。
  • Coordinator.swift: 定义了 Coordinator 协议。
  • MainCoordinator.swift: 主 Coordinator 实现。
  • StoryboardCoordinator.swift: 使用 Storyboard 的 Coordinator 实现。
  • ViewModel.swift: 示例视图模型。
• CoordinatorTests/: 单元测试文件夹。
• CoordinatorUITests/: UI 测试文件夹。
• Coordinator.xcodeproj: Xcode 项目文件。
• Coordinator.xcworkspace: Xcode 工作区文件。
• Podfile: CocoaPods 依赖管理文件。
• README.md: 项目说明文档。
• LICENSE: 项目许可证。

2. 项目的启动文件介绍

AppDelegate.swift

import UIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?
    var coordinator: MainCoordinator?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 创建窗口
        window = UIWindow(frame: UIScreen.main.bounds)
        
        // 创建主 Coordinator
        let navigationController = UINavigationController()
        coordinator = MainCoordinator(navigationController: navigationController)
        coordinator?.start()
        
        // 设置窗口的根视图控制器并显示
        window?.rootViewController = navigationController
        window?.makeKeyAndVisible()
        
        return true
    }
}

SceneDelegate.swift

import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?
    var coordinator: MainCoordinator?

    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        guard let windowScene = (scene as? UIWindowScene) else { return }
        
        // 创建窗口
        window = UIWindow(windowScene: windowScene)
        
        // 创建主 Coordinator
        let navigationController = UINavigationController()
        coordinator = MainCoordinator(navigationController: navigationController)
        coordinator?.start()
        
        // 设置窗口的根视图控制器并显示
        window?.rootViewController = navigationController
        window?.makeKeyAndVisible()
    }
}

3. 项目的配置文件介绍

Podfile

platform :ios, '13.0'

target 'Coordinator' do
  use_frameworks!

  # Pods for Coordinator
  pod 'Alamofire', '~> 5.4'
  pod 'SnapKit', '~> 5.0'
end

README.md

# Coordinator

A simple implementation of the Coordinator pattern in Swift.

## Features

- Coordinator pattern implementation
- Example view controllers and coordinators
- Integration with Storyboards

## Requirements

- iOS 13.0+
- Xcode 12.0+
- Swift 5.0+

## Installation

### CocoaPods

To integrate Coordinator into your Xcode project using CocoaPods, specify it in your `Podfile`:

CoordinatorImplementation of Coordinators app design pattern.项目地址:https://gitcode.com/gh_mirrors/co/Coordinator