-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathSTBaseConfig.swift
More file actions
112 lines (97 loc) · 4.16 KB
/
STBaseConfig.swift
File metadata and controls
112 lines (97 loc) · 4.16 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
//
// STBaseConfig.swift
// STBaseProject
//
// Created by 寒江孤影 on 2019/03/16.
//
import UIKit
public final class STBaseConfig {
public static let shared: STBaseConfig = STBaseConfig()
private init() {}
/// 设置默认基础配置
/// - 设计基准尺寸：iPhone X (375x812)
/// - 导航栏内容:iOS 标准 44
/// - TabBar 内容:iOS 标准 49
public func applyDefaultConfiguration() {
self.configureInterface(designSize: CGSize(width: 375, height: 812))
}
/// 配置设计基准尺寸
/// - Parameter size: 设计图的基准尺寸，通常为设计稿的尺寸
/// - Note: 传入非法尺寸（宽高<=0）会被忽略。
public func configureDesignSize(_ size: CGSize) {
guard size.width > 0, size.height > 0 else {
STLog("⚠️ STBaseConfig: 设计基准尺寸无效 (\(size))，已忽略")
return
}
STDeviceAdapter.shared.configure(designSize: size)
}
/// 配置自定义导航栏 items 容器高度(navigationBarItemsView)。
/// - Parameter contentHeight: items 容器(title / leftBtn / rightBtn 所在)高度,iOS 标准为 44,设计图常用 50。
/// 整个导航栏总高由 status bar 动态相加得出,可通过 `STDeviceAdapter.navigationBarHeight` 读取。
public func configureNavigationBar(contentHeight: CGFloat) {
guard contentHeight >= 0 else {
STLog("⚠️ STBaseConfig: 导航栏 contentHeight 无效，忽略")
return
}
STDeviceAdapter.shared.configureNavigationBar(contentHeight: contentHeight)
}
/// 配置自定义 TabBar 高度(不含底部安全区)。iOS 标准为 49。
public func configureTabBar(contentHeight: CGFloat) {
guard contentHeight >= 0 else {
STLog("⚠️ STBaseConfig: TabBar contentHeight 无效，忽略")
return
}
STDeviceAdapter.shared.configureTabBar(contentHeight: contentHeight)
}
/// 配置完整的界面尺寸。各 bar 高度传 `nil` 表示使用默认值。
public func configureInterface(
designSize: CGSize,
navigationBarContentHeight: CGFloat? = nil,
tabBarContentHeight: CGFloat? = nil
) {
self.configureDesignSize(designSize)
if let navigationBarContentHeight = navigationBarContentHeight {
self.configureNavigationBar(contentHeight: navigationBarContentHeight)
}
if let tabBarContentHeight = tabBarContentHeight {
self.configureTabBar(contentHeight: tabBarContentHeight)
}
}
/// 使用完整的高度模型配置
public func applyBarHeights(_ configuration: STBarHeightsConfiguration) {
STDeviceAdapter.shared.applyBarHeights(configuration)
}
/// 配置缩放策略（可限制 iPad 等大屏设备的过度放大）
public func configureScaleStrategy(_ strategy: STScaleStrategy) {
STDeviceAdapter.shared.configureScaleStrategy(strategy)
}
/// 配置字体族
public func configureFontFamily(_ config: STFontFamilyConfig) {
STFontManager.shared.configure(fontFamily: config)
}
/// 快速配置 iPhone X 设计基准
public func configureForIPhoneX() {
self.configureInterface(designSize: CGSize(width: 375, height: 812))
}
/// 快速配置 iPhone 14 Pro 设计基准
public func configureForIPhone14Pro() {
self.configureInterface(designSize: CGSize(width: 393, height: 852))
}
/// 启用应用生命周期监控
public func enableAppLifecycleMonitoring(
timeoutInterval: TimeInterval? = nil,
onBackgroundTimeout: ((TimeInterval) -> Void)? = nil,
onDidEnterBackground: (() -> Void)? = nil,
onWillEnterForeground: (() -> Void)? = nil
) {
let manager = STAppLifecycleManager.shared
if let timeoutInterval = timeoutInterval {
manager.backgroundTimeoutInterval = timeoutInterval
}
manager.onBackgroundTimeout = onBackgroundTimeout
manager.onDidEnterBackground = onDidEnterBackground
manager.onWillEnterForeground = onWillEnterForeground
manager.restoreBackgroundTimestampIfNeeded()
manager.start()
}
}