- clone this repo.
- Simply drop the
Sourcesfolder into your project. - Enjoy！
TLCommon is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'TLCommon'dependencies: [
.package(url: "https://github.com/ysCharles/TLCommon.git", .upToNextMajor(from: "1.7.5"))
]- Constant
import TLCommon
// 屏幕宽度
public let SCREEN_WIDTH : CGFloat
// 屏幕高度
public let SCREEN_HEIGHT : CGFloat
// 屏幕比例
public let SCREEN_SCALE : CGFloat
// 导航条高度
public let NAV_BAR_HEIGHT: CGFloat = UIDevice.haveHomeIndicator ? 88 : 64
// 状态栏高度
public let STATUS_BAR_HEIGHT: CGFloat = UIDevice.haveHomeIndicator ? 44 : 20
/// RGBA 颜色简便获取方法
public let RGBA: (_ red: Int,_ green: Int, _ blue: Int, _ aplpa: CGFloat) -> UIColor
/// RGB 颜色简便获取方法
public let RGB: (_ red: Int,_ green: Int, _ blue: Int) -> UIColor
-
BaseController
BaseNavigationController继承这个类，解决了修改leftBarButtonItem之后系统自带的侧滑返回功能消失的问题。BaseViewController继承这个类，overridepreferredStatusBarStyle改变状态栏颜色 -
Utils
-
LogUtils
public func proLog<T>(_ message: T, file: String = #file, method: String = #function, line: Int = #line) // eg: proLog("Hello World")
-
SandBoxUtils
/// 沙盒中的 Temp 路径 /// 该文件夹下的文件会在 app 退出后自动清除，可用于存放一次性文件 /// - Returns: 目录路径 public static func getTempPath() -> String /// 沙盒跟目录 /// /// - Returns: 目录路径 public static func getSandBoxRoot() -> String /// 沙盒Documents路径 /// 苹果建议将程序中建立的或在程序中浏览到的文件数据保存在该目录下，iTunes备份和恢复的时候会包括此目录,如用户信息等永久性文件; /// - Returns: 目录路径 public static func getDocumentPath() -> String /// 沙盒中Library路径 /// 它包含两个文件夹 caches 和 preferences /// - Returns: 目录路径 public static func getLibraryPath() -> String /// 沙盒中Library/Caches路径 /// 存放缓存文件，iTunes不会备份此目录，此目录下文件不会在应用退出删除，如图片、视频缓存 /// - Returns: 目录路径 public static func getCachesPath() -> String
-
Utils
public struct Utils { /// 检查是否是手机号 默认只做1开头的十一位验证 /// /// - Parameters: /// - mobile: 手机号 /// - regx: 默认nil 验证规则： "^1\\d{10}$" /// - Returns: true: 是 false: 否 public static func isMobile(_ mobile: String?, regx: String? = nil) -> Bool /// 判断字符串是否为空 /// /// - Parameter string: 字符串 /// - Returns: 是否 public static func isEmpty(string : String?) -> Bool /// 检查是否是身份证号 /// /// - Parameter idCard: 身份证号 /// - Returns: true:是 false:不是 public static func isIDCard(_ idCard : String?) -> Bool /// 检查是否是电子邮箱 /// /// - Parameter email: 邮箱 /// - Returns: true:是 false:不是 public static func isEmail(_ email: String?) -> Bool // MARK: - 时间 字符串 转化 /// 转化时间字符串为 Date /// /// - Parameters: /// - dateString: 时间字符串 /// - formatter: 时间格式 /// - Returns: Date public static func date(from dateString: String, formatter: String = "yyyy-MM-dd HH:mm:ss") -> Date? /// 格式化Date 为 String /// /// - Parameters: /// - date: 时间 /// - formatter: 时间格式 /// - Returns: String public static func format(date: Date?, formatter: String = "yyyy年MM月dd日") -> String // MARK:- 从 storyboard 中唤醒 viewcontroller /// 从 storyboard 中唤醒 viewcontroller /// /// - Parameters: /// - storyboardID: viewcontroller 在 storyboard 中的 id /// - fromStoryboard: storyboard 名称 /// - bundle: Bundle 默认为 main /// - Returns: UIviewcontroller public static func getViewController(storyboardID: String, fromStoryboard: String, bundle: Bundle? = nil) -> UIViewController // MARK:- 应用跳转 /// 跳转到App Store，记得将 http:// 替换为 itms:// 或者 itms-apps://： 需要真机调试 /// /// - Parameters: /// - vc: 跳转时所在控制器 /// - url: url /// - Returns: 打开是否成功 @discardableResult public static func openAppStore(vc: UIViewController, url: String) -> Bool /// 拨打电话 ,里面会判断是否需要拨打号码 外部不需要调用判断 需要真机调试 /// /// - Parameters: /// - vc: 拨打电话时所在的控制器 /// - number: 电话号码 /// - Returns: 打开是否成功 @discardableResult public static func callPhone(number: String) -> Bool /// 打开浏览器 真机调试 /// /// - Parameter url: 需要打开的 url /// - Returns: 打开是否成功 @discardableResult public static func openBrowser(url: String) -> Bool // MARK:获取版本信息 /// 获取 app 版本 /// /// - Parameter type: 类型0 = CFBundleShortVersionString 1 = CFBundleVersion 默认获取0 /// - Returns: 版本信息字符串 public static func getVersion(type: Int = 0) -> String
-
-
Extension
-
String
extension String { /// trim 去掉字符串前后的空白字符 public func trim() -> String /// 是否为空（trim 处理后） public var isEmptyByTrim: Bool /// 是否是邮件 public var isEmail: Bool /// md5加密 /// /// - Returns: 加密后数据 public func md5() -> String /// sha1加密 /// /// - Returns: 加密后数据 public func sha1() -> String }
-
UIImage
extension UIImage { /// 调整图像尺寸大小 /// /// - Parameter size: 尺寸 /// - Returns: UIImage public func resize(_ size: CGSize) -> UIImage? }
-
UIView
public extension UIView { /// x public var x: CGFloat { get { return frame.origin.x } set { var tempFrame = frame tempFrame.origin.x = newValue frame = tempFrame } } /// y public var y: CGFloat { get { return frame.origin.y } set { var tempFrame = frame tempFrame.origin.y = newValue frame = tempFrame } } /// height public var height: CGFloat { get { return frame.size.height } set { var tempFrame = frame tempFrame.size.height = newValue frame = tempFrame } } /// width public var width: CGFloat { get { return frame.size.width } set { var tempFrame = frame tempFrame.size.width = newValue frame = tempFrame } } /// size public var size: CGSize { get { return frame.size } set { var tempFrame = frame tempFrame.size = newValue frame = tempFrame } } /// centerX public var centerX: CGFloat { get { return center.x } set { var tempCenter = center tempCenter.x = newValue center = tempCenter } } /// centerY public var centerY: CGFloat { get { return center.y } set { var tempCenter = center tempCenter.y = newValue center = tempCenter } } }
-
UIDevice
extension UIDevice { /// 判断是否有 HomeIndicator public static var haveHomeIndicator: Bool {get} public static var isIphoneX : Bool {get} public static var isIphoneXS : Bool {get} public static var isIphoneXR : Bool {get} public static var isIphoneXSMax : Bool {get} }
-
-
Custom View
class TLTextView : UITextView { /// 设置占位文字 public var placeholder: String? /// 设置占位文字颜色 public var placeholderColor: UIColor? /// 设置文本字体 public override var font: UIFont? /// 设置文本内容 public override var text: String! /// 设置带样式文本内容 public override var attributedText: NSAttributedString! }
TLCommon is available under the MIT license. See the LICENSE file for more info.