WrapperGlobal

public class WrapperGlobal

全局包装器

自定义WrapperGlobal为任意名称(如APP)示例：

public typealias APP = WrapperGlobal

使用示例：

APP.safeString(object)

version
当前框架版本号
Declaration
Swift

public static let version: String

WrapperGlobal

autoload(_:)
自动加载Swift类并调用autoload方法，参数为Class或String
Declaration
Swift

@discardableResult public static func autoload(_ clazz: Any) -> Bool


                    
                    
                    begin(_:)

标记时间调试开始

Declaration

Swift

public static func begin(_ name: String = "")

Parameters


                                name

调试标签，默认空字符串


                    
                    
                    end(_:)

标记时间调试结束并打印消耗时间

Declaration

Swift

@discardableResult
public static func end(_ name: String = "") -> TimeInterval

Parameters


                                name

调试标签，默认空字符串

Return Value

消耗时间


                    
                    
                    verbose(group:_:_:function:file:line:)

记录详细日志

Declaration

Swift

public static func verbose(
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    debug(group:_:_:function:file:line:)

记录调试日志

Declaration

Swift

public static func debug(
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    info(group:_:_:function:file:line:)

记录信息日志

Declaration

Swift

public static func info(
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    warn(group:_:_:function:file:line:)

记录警告日志

Declaration

Swift

public static func warn(
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    error(group:_:_:function:file:line:)

记录错误日志

Declaration

Swift

public static func error(
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    log(type:group:_:_:function:file:line:)

记录类型日志

Declaration

Swift

public static func log(
    type: LogType,
    group: String = "",
    _ format: String,
    _ arguments: CVarArg...,
    function: String = #function,
    file: String = #file,
    line: Int = #line
)

Parameters

`type`	日志类型
`group`	日志分组，默认空
`format`	格式化字符串
`arguments`	可变参数列表，可不传
`file`	文件名，默认传参
`function`	方法名，默认传参
`line`	行数，默认传参


                    
                    
                    mediator

中间件快速访问

Declaration

Swift

public static let mediator: Mediator.Type


                    
                    
                    plugin

插件快速访问

Declaration

Swift

public static let plugin: PluginManager.Type

router
路由快速访问
Declaration
Swift

public static let router: Router.Type


                    
                    
                    safeString(_:)

安全字符串，不为nil

Declaration

Swift

public static func safeString(_ value: Any?) -> String


                    
                    
                    safeNumber(_:)

安全数字，不为nil

Declaration

Swift

public static func safeNumber(_ value: Any?) -> NSNumber


                    
                    
                    safeInt(_:)

安全Int，不为nil

Declaration

Swift

public static func safeInt(_ value: Any?) -> Int


                    
                    
                    safeBool(_:)

安全Bool，不为nil

Declaration

Swift

public static func safeBool(_ value: Any?) -> Bool


                    
                    
                    safeFloat(_:)

安全Float，不为nil

Declaration

Swift

public static func safeFloat(_ value: Any?) -> Float


                    
                    
                    safeDouble(_:)

安全Double，不为nil

Declaration

Swift

public static func safeDouble(_ value: Any?) -> Double

safeURL(_:)
安全URL，不为nil，不兼容文件路径(需fileURLWithPath)
Declaration
Swift

public static func safeURL(_ value: Any?) -> URL


                    
                    
                    safeValue(_:)

获取安全值

Declaration

Swift

public static func safeValue<T>(_ value: T?) -> T where T : BasicType


                    
                    
                    isNotEmpty(_:)

判断是否不为空

Declaration

Swift

public static func isNotEmpty<T>(_ value: T?) -> Bool where T : BasicType

isNil(_:)
判断是否为nil，兼容嵌套Optional
Declaration
Swift

public static func isNil(_ value: Any?) -> Bool
image(_:bundle:)
根据名称加载UIImage，优先加载图片文件(无缓存)，文件不存在时尝试系统imageNamed方式(有缓存)
Declaration
Swift

public static func image(_ named: String, bundle: Bundle? = nil) -> UIImage?

UIApplication

isDebug
是否是调试模式
Declaration
Swift

public static var isDebug: Bool { get }

UIDevice


                    
                    
                    isSimulator

是否是模拟器

Declaration

Swift

public static var isSimulator: Bool { get }


                    
                    
                    isIphone

是否是iPhone设备

Declaration

Swift

public static var isIphone: Bool { get }

isIpod
是否是iPod设备
Declaration
Swift

public static var isIpod: Bool { get }
isIpad
是否是iPad设备
Declaration
Swift

public static var isIpad: Bool { get }
isMac
是否是Mac设备
Declaration
Swift

public static var isMac: Bool { get }


                    
                    
                    iosVersion

iOS系统版本

Declaration

Swift

public static var iosVersion: Double { get }


                    
                    
                    isIos(_:)

是否是指定iOS主版本

Declaration

Swift

public static func isIos(_ version: Int) -> Bool

isIosLater(_:)
是否是大于等于指定iOS主版本
Declaration
Swift

public static func isIosLater(_ version: Int) -> Bool
deviceSize
设备尺寸，跟横竖屏无关
Declaration
Swift

public static var deviceSize: CGSize { get }
deviceWidth
设备宽度，跟横竖屏无关
Declaration
Swift

public static var deviceWidth: CGFloat { get }
deviceHeight
设备高度，跟横竖屏无关
Declaration
Swift

public static var deviceHeight: CGFloat { get }
deviceResolution
设备分辨率，跟横竖屏无关
Declaration
Swift

public static var deviceResolution: CGSize { get }
isDeviceLandscape
设备是否横屏，无论支不支持横屏
Declaration
Swift

public static var isDeviceLandscape: Bool { get }

UIScreen


                    
                    
                    screenSize

屏幕尺寸

Declaration

Swift

public static var screenSize: CGSize { get }


                    
                    
                    screenWidth

屏幕宽度

Declaration

Swift

public static var screenWidth: CGFloat { get }


                    
                    
                    screenHeight

屏幕高度

Declaration

Swift

public static var screenHeight: CGFloat { get }


                    
                    
                    screenScale

屏幕像素比例

Declaration

Swift

public static var screenScale: CGFloat { get }

isScreenInch(_:)
判断屏幕英寸，需同步适配新机型
Declaration
Swift

public static func isScreenInch(_ inch: ScreenInch) -> Bool


                    
                    
                    isInterfaceLandscape

界面是否横屏

Declaration

Swift

public static var isInterfaceLandscape: Bool { get }


                    
                    
                    isNotchedScreen

是否是全面屏屏幕

Declaration

Swift

@MainActor
public static var isNotchedScreen: Bool { get }


                    
                    
                    isDynamicIsland

是否是灵动岛屏幕

Declaration

Swift

@MainActor
public static var isDynamicIsland: Bool { get }


                    
                    
                    pixelOne

屏幕一像素的大小

Declaration

Swift

public static var pixelOne: CGFloat { get }

pointHalf
屏幕半个点的大小，区别于pixelOne，2x屏为1像素，3x屏为2像素
Declaration
Swift

public static var pointHalf: CGFloat { get }


                    
                    
                    safeAreaInsets

屏幕安全区域距离

Declaration

Swift

@MainActor
public static var safeAreaInsets: UIEdgeInsets { get }

statusBarHeight
状态栏高度，与是否隐藏无关
Declaration
Swift

@MainActor public static var statusBarHeight: CGFloat { get }
navigationBarHeight
导航栏高度，与是否隐藏无关
Declaration
Swift

@MainActor public static var navigationBarHeight: CGFloat { get }
topBarHeight
顶部栏高度，包含状态栏、导航栏，与是否隐藏无关
Declaration
Swift

@MainActor public static var topBarHeight: CGFloat { get }
tabBarHeight
标签栏高度，与是否隐藏无关
Declaration
Swift

@MainActor public static var tabBarHeight: CGFloat { get }
toolBarHeight
工具栏高度，与是否隐藏无关
Declaration
Swift

@MainActor public static var toolBarHeight: CGFloat { get }
referenceWidth
当前等比例缩放参考设计图宽度，默认375
Declaration
Swift

public static var referenceWidth: CGFloat { get }
referenceHeight
当前等比例缩放参考设计图高度，默认812
Declaration
Swift

public static var referenceHeight: CGFloat { get }
relativeScale
当前屏幕宽度缩放比例
Declaration
Swift

public static var relativeScale: CGFloat { get }
relativeHeightScale
当前屏幕高度缩放比例
Declaration
Swift

public static var relativeHeightScale: CGFloat { get }


                    
                    
                    relative(_:flat:)

获取相对设计图宽度等比例缩放值

Declaration

Swift

public static func relative(_ value: CGFloat, flat: Bool = false) -> CGFloat


                    
                    
                    relative(_:flat:)

获取相对设计图等比例缩放size

Declaration

Swift

public static func relative(_ size: CGSize, flat: Bool = false) -> CGSize


                    
                    
                    relative(_:flat:)

获取相对设计图等比例缩放point

Declaration

Swift

public static func relative(_ point: CGPoint, flat: Bool = false) -> CGPoint


                    
                    
                    relative(_:flat:)

获取相对设计图等比例缩放rect

Declaration

Swift

public static func relative(_ rect: CGRect, flat: Bool = false) -> CGRect


                    
                    
                    relative(_:flat:)

获取相对设计图等比例缩放insets

Declaration

Swift

public static func relative(_ insets: UIEdgeInsets, flat: Bool = false) -> UIEdgeInsets

fixed(_:flat:)
获取相对设计图宽度等比例缩放时的固定宽度值
Declaration
Swift

public static func fixed(_ value: CGFloat, flat: Bool = false) -> CGFloat
fixed(_:flat:)
获取相对设计图等比例缩放时的固定size
Declaration
Swift

public static func fixed(_ size: CGSize, flat: Bool = false) -> CGSize


                    
                    
                    fixed(_:flat:)

获取相对设计图等比例缩放时的固定point

Declaration

Swift

public static func fixed(_ point: CGPoint, flat: Bool = false) -> CGPoint

fixed(_:flat:)
获取相对设计图等比例缩放时的固定rect
Declaration
Swift

public static func fixed(_ rect: CGRect, flat: Bool = false) -> CGRect


                    
                    
                    fixed(_:flat:)

获取相对设计图等比例缩放时的固定insets

Declaration

Swift

public static func fixed(_ insets: UIEdgeInsets, flat: Bool = false) -> UIEdgeInsets


                    
                    
                    relativeHeight(_:flat:)

获取相对设计图高度等比例缩放值

Declaration

Swift

public static func relativeHeight(_ value: CGFloat, flat: Bool = false) -> CGFloat

fixedHeight(_:flat:)
获取相对设计图高度等比例缩放时的固定高度值
Declaration
Swift

public static func fixedHeight(_ value: CGFloat, flat: Bool = false) -> CGFloat
flat(_:scale:)
基于指定的倍数(0取当前设备)，对传进来的floatValue进行像素取整
Declaration
Swift

public static func flat(_ value: CGFloat, scale: CGFloat = 0) -> CGFloat
flat(_:scale:)
基于指定的倍数(0取当前设备)，对传进来的size进行像素取整
Declaration
Swift

public static func flat(_ size: CGSize, scale: CGFloat = 0) -> CGSize
flat(_:scale:)
基于指定的倍数(0取当前设备)，对传进来的point进行像素取整
Declaration
Swift

public static func flat(_ point: CGPoint, scale: CGFloat = 0) -> CGPoint
flat(_:scale:)
基于指定的倍数(0取当前设备)，对传进来的rect进行像素取整
Declaration
Swift

public static func flat(_ rect: CGRect, scale: CGFloat = 0) -> CGRect
flat(_:scale:)
基于指定的倍数(0取当前设备)，对传进来的insets进行像素取整
Declaration
Swift

public static func flat(_ insets: UIEdgeInsets, scale: CGFloat = 0) -> UIEdgeInsets

WrapperGlobal


                    
                    
                    register(_:)

注册自定义Codable解码转换器

Declaration

Swift

public static func register(_ decodingConverter: CodableDecodingConverter)

Parameters


                                decodingConverter

解码转换器


                    
                    
                    synchronized(_:closure:)

通用互斥锁方法

Declaration

Swift

public static func synchronized(_ object: Any, closure: () -> Void)


                    
                    
                    synchronized(_:closure:)

通用互斥锁方法，返回指定对象

Declaration

Swift

public static func synchronized<T>(_ object: Any, closure: () -> T) -> T


                    
                    
                    dispatchOnce(_:closure:)

同一个token仅执行一次block，全局范围

Declaration

Swift

public static func dispatchOnce(
    _ token: AnyHashable,
    closure: () -> Void
)


                    
                    
                    localized(_:_:)

读取本地化字符串

Declaration

Swift

public static func localized(_ key: String, _ table: String? = nil) -> String

Parameters

`key`	本地化键名
`table`	本地化表名，默认Localizable.strings

Return Value

本地化字符串


                    
                    
                    color(_:_:)

从16进制创建UIColor

Declaration

Swift

public static func color(_ hex: Int, _ alpha: CGFloat = 1.0) -> UIColor

Parameters

`hex`	十六进制值，格式0xFFFFFF
`alpha`	透明度可选，默认1.0

Return Value

UIColor


                    
                    
                    color(_:_:_:_:)

从RGB创建UIColor

Declaration

Swift

public static func color(_ red: CGFloat, _ green: CGFloat, _ blue: CGFloat, _ alpha: CGFloat = 1.0) -> UIColor

Parameters

`red`	红色值
`green`	绿色值
`blue`	蓝色值
`alpha`	透明度可选，默认1.0

Return Value

UIColor


                    
                    
                    font(_:_:autoScale:)

快速创建系统字体，自动等比例缩放

Declaration

Swift

public static func font(_ size: CGFloat, _ weight: UIFont.Weight = .regular, autoScale: Bool? = nil) -> UIFont

Parameters

`size`	字体字号
`weight`	字重可选，默认Regular
`autoScale`	是否自动等比例缩放，默认全局配置

Return Value

UIFont


                    
                    
                    icon(_:_:)

快速创建图标对象

Declaration

Swift

public static func icon(_ named: String, _ size: CGFloat) -> Icon?

Parameters

`named`	图标名称
`size`	图标大小

Return Value

FWIcon对象


                    
                    
                    iconImage(_:_:)

快速创建图标图像

Declaration

Swift

public static func iconImage(_ name: String, _ size: CGFloat) -> UIImage?

Parameters

`name`	图标名称
`size`	图片大小

Return Value

UIImage对象