ui-framework

UI 框架约定

框架选择

• 主框架：UIKit（非特殊说明不使用 SwiftUI）
• 布局：SnapKit 自动布局，禁止 frame 硬编码
• 入口：SceneDelegate，无 Storyboard，无 .xib
• 导航：UINavigationController，禁止使用 NavigationStack

---

设计系统

颜色

• 统一从 AppColors.swift 引用，禁止直接写 UIColor(hex:)
• 必须同时定义 Light / Dark 模式色值：

enum AppColors {
    static let primary = UIColor { trait in
        switch trait.userInterfaceStyle {
        case .dark: return UIColor(hex: "#0A84FF")
        default: return UIColor(hex: "#007AFF")
        }
    }
    static let background = UIColor { trait in
        switch trait.userInterfaceStyle {
        case .dark: return UIColor(hex: "#1C1C1E")
        default: return UIColor(hex: "#FFFFFF")
        }
    }
    static let secondaryBackground = UIColor { trait in
        switch trait.userInterfaceStyle {
        case .dark: return UIColor(hex: "#2C2C2E")
        default: return UIColor(hex: "#F2F2F7")
        }
    }
}

字体

• 统一从 AppFonts.swift 引用，使用 SF Pro 系列
• 支持 Dynamic Type：

enum AppFonts {
    static let title1 = UIFont.preferredFont(forTextStyle: .title1)
    static let headline = UIFont.preferredFont(forTextStyle: .headline)
    static let body = UIFont.preferredFont(forTextStyle: .body)
    static let caption = UIFont.preferredFont(forTextStyle: .caption1)

    static func custom(weight: UIFont.Weight, size: CGFloat) -> UIFont {
        let font = UIFont.systemFont(ofSize: size, weight: weight)
        return UIFontMetrics.default.scaledFont(for: font)
    }
}

间距与圆角

• 间距：基于 8pt 基础网格（8 / 16 / 24 / 32）
• 圆角：统一使用 CornerRadius 枚举

enum Layout {
    static let padding8: CGFloat = 8
    static let padding16: CGFloat = 16
    static let padding24: CGFloat = 24
    static let padding32: CGFloat = 32
}

enum CornerRadius: CGFloat {
    case small = 8
    case medium = 12
    case large = 20
}

---

ViewController 规范

基本结构

final class HomeVC: UIViewController {
    private let viewModel: HomeViewModel

    private lazy var collectionView: UICollectionView = {
        let cv = UICollectionView(frame: .zero, collectionViewLayout: createLayout())
        cv.register(Cell.self, forCellWithReuseIdentifier: Cell.reuseID)
        cv.dataSource = self
        cv.delegate = self
        return cv
    }()

    init(viewModel: HomeViewModel) {
        self.viewModel = viewModel
        super.init(nibName: nil, bundle: nil)
    }

    required init?(coder: NSCoder) { fatalError() }

    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
        bindViewModel()
    }

    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        viewModel.loadData()
    }
}