HDSwiftCommonTools
是 HDCommonTools 的 Swift 版本，集成了简单高效的功能，将常用功能集合起来。目前仍在完善中，也可以直接使用 HDCommonTools 的 OC 版本
一、导入项目
通过cocoapods导入
pod 'HDSwiftCommonTools'
通过文件导入
下载项目，将项目文件下的 HDSwiftCommonTools 文件夹中的内容导入项目即可
二、API 列表
已有数据类型操作可通过 .hd 语法进行，其他操作可通过 HDCommonTools.shared 单例使用。
- 单例和
.hd语法使用无区别，单例会更统一简单，.hd语法的好处是无需在使用地方导入。
import HDSwiftCommonTools
UI相关
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func getCurrentNormalWindow() | 获取当前的NormalWindow | HDCommonTools.shared.getCurrentNormalWindow() |
| func getCurrentVC() | 获取当前的ViewController | HDCommonTools.shared.getCurrentVC() |
| func getImage(color: UIColor) | 通过颜色生成一张纯色背景图 | HDCommonTools.shared.getImage(color: UIColor.red) 或者 UIImage.hd.getImage(color: UIColor.red) |
| func getLinearGradientImage(colors: [UIColor], directionType: HDGradientDirection, size: CGSize = CGSize(width: 100, height: 100)) | 生成线性渐变的图片 | HDCommonTools.shared.getLinearGradientImage(colors: [UIColor.red, UIColor.black, UIColor.blue] 或者 UIImage.hd.getLinearGradientImage(colors: [UIColor.red, UIColor.black, UIColor.blue], directionType: .leftToRight) |
| func getRadialGradientImage(colors: [UIColor], raduis: CGFloat, size: CGSize = CGSize(width: 100, height: 100)) | 生成角度渐变的图片 | HDCommonTools.shared.getRadialGradientImage(colors: [UIColor.red, UIColor.black, UIColor.blue], raduis: 45) 或者 UIImage.hd.getRadialGradientImage(colors: [UIColor.red, UIColor.black, UIColor.blue], raduis: 45) |
| func getColor(hexString: String, alpha: CGFloat = 1.0) | 通过十六进制字符串获取颜色 | UIColor(hexString: "#FFFFFF") 或者 UIColor.hd.color(hexString: "#FFFFFF") |
| func UIColor(hexValue: Int, darkHexValue: Int = 0x333333, alpha: Float = 1.0, darkAlpha: Float = 1.0) | 通过十六进制获取颜色 | UIColor(hexValue: 0xffffff) 或者 UIColor.hd.color(hexValue: 0xffffff) |
| UIScreenWidth | 屏幕宽度 | |
| UIScreenHeight | 屏幕高度 | |
| HD_StatusBar_Height | 状态栏高度 | |
| func HD_Default_NavigationBar_Height(vc: UIViewController? = nil) | 导航栏高度 | HD_Default_NavigationBar_Height() |
| func func HD_Default_Tabbar_Height(vc: UIViewController? = nil) | tabbar高度 | HD_Default_Tabbar_Height() |
| func addLayerShadow(color: UIColor, offset: CGSize, radius: CGFloat, cornerRadius: CGFloat? = nil) | 为view添加阴影 | view.hd.addLayerShadow(color: UIColor.black, offset: CGSize(width: 2, height: 0), radius: 10) |
| func setFrame(x: CGFloat? = nil, y: CGFloat? = nil, width: CGFloat? = nil, height: CGFloat? = nil) | view单独设置Frame的某个值 | view.hd.setFrame(x: 10) |
系统和软件信息
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func getAppVersionString() | 获取软件版本 | HDCommonTools.shared.getAppVersionString() |
| func getAppBuildVersionString() | 获取软件构建版本 | HDCommonTools.shared.getAppBuildVersionString() |
| func getIOSVersionString() | 获取系统的iOS版本 | HDCommonTools.shared.getIOSVersionString() |
| func getIOSLanguageStr() | 获取系统语言 | HDCommonTools.shared.getIOSLanguageStr() |
| func getBundleIdentifier() | 获取软件Bundle Identifier | HDCommonTools.shared.getBundleIdentifier() |
| func getSystemHardware() | 获取本机机型标识 | HDCommonTools.shared.getSystemHardware() |
| func getSystemUpTime() | 获取本机上次重启时间 | HDCommonTools.shared.getSystemUpTime() |
| func getIDFAString(idfvIfFailed: Bool = true) | 模拟软件唯一标示 | HDCommonTools.shared.getIDFAString() |
| func getMacAddress() | 获取手机WIFI的MAC地址，需要开启Access WiFi information | HDCommonTools.shared.getMacAddress() |
| func openSystemSetting() | 打开系统设置 | HDCommonTools.shared.openSystemSetting() |
| func openAppStorePage(openType: HDOpenAppStoreType, appleID: String) | 打开软件对应的App Store页面 | HDCommonTools.shared.openAppStorePage(openType: .app, appleID: "1123211") |
| func openAppStoreReviewPage(openType: HDOpenAppStoreType, appleID: String = "") | 打开软件对应评分页面 | HDCommonTools.shared.openAppStoreReviewPage(openType: .app) |
软件权限
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func requestPermission(type: HDPermissionType, complete: @escaping ((HDPermissionStatus) -> Void)) | 请求权限 | HDCommonTools.shared.requestPermission(type: .notification) { (status) in print("权限设置回调", status) } |
| func checkPermission(type: HDPermissionType, complete: @escaping ((HDPermissionStatus) -> Void)) | 检测软件权限 | HDCommonTools.shared.checkPermission(type: .notification) { (status) in print("当前权限状态", status) } |
多媒体操作
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func getVideoDuration(videoURL: URL) -> Double | 获取指定视频时长，单位秒 | HDCommonTools.shared.getVideoDuration(videoURL: URL(fileURLWithPath: path)) |
| func getVideoSize(videoURL: URL) | 获取指定视频分辨率，支持本地或网络地址 | HDCommonTools.shared.getVideoSize(videoURL: URL(fileURLWithPath: path)) |
| func playMusic(url: URL?, repeated: Bool = false, audioSessionCategory: AVAudioSession.Category = AVAudioSession.Category.playback) | 播放音乐 | HDCommonTools.shared.playMusic(url: url, repeated: false) |
| func stopMusic() | 关闭音乐播放 | HDCommonTools.shared.stopMusic() |
| func playEffect(url: URL?, vibrate: Bool = false) | 播放音效，静音模式下不会播放音效 | HDCommonTools.shared.playEffect(url: url, vibrate: true) |
| func startVibrate(repeated: Bool = false) | 开始震动 | HDCommonTools.shared.startVibrate() |
| func stopVibrate() | 结束震动 | HDCommonTools.shared.stopVibrate() |
文件操作
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func getFileDirectory(type: HDFileDirectoryType) | 获取文件夹路径 | HDCommonTools.shared.getFileDirectory(type: .documents) |
| func createFileDirectory(in type: HDFileDirectoryType, directoryName: String) | 在指定文件夹中创建子文件夹 | HDCommonTools.shared.createFileDirectory(in: .documents, directoryName: "filePath") |
| func getFileSize(filePath: URL) | 获取指定文件的大小 | HDCommonTools.shared.getFileSize(filePath: url) |
| func getFileDirectorySize(fileDirectoryPth: URL) | 获取指定文件夹的大小 | HDCommonTools.shared.getFileDirectorySize(fileDirectoryPth: url) |
其他
| 名称 | 功能说明 | 示例 |
|---|---|---|
| func compare(anotherDate: Date, ignoreTime: Bool = false) | 比较日期，设置是否忽略时间 | Date().hd.compare(anotherDate: date) |
| func subString(rang: NSRange) | 截取字符串 | string.hd.subString(range: NSRange(location: 2, length: 5)) |
| func unicodeDecode() | unicode转中文 | "\u54c8\u54c8\u54c8".hd.unicodeDecode() |
| func unicodeEncode() | 字符串转unicode | "哈哈是电话费".hd.unicodeEncode() |
| func base64Decode(lowercase: Bool = true) | base64解码 | "5ZOI5ZOI5piv55S16K+d6LS5".hd.base64Decode() |
| func aes256Decrypt(password: String, ivString: String = "abcdefghijklmnop") | aes256解密 | string.hd.aes256Decrypt(password: "password") |
| func aes256Encrypt(password: String, ivString: String = "abcdefghijklmnop") | aes256加密 | string.hd.aes256Encrypt(password: "password") |
| func encryptString(encryType: HDEncryType, lowercase: Bool = true) | 字符串加密 | string.hd.encryptString(encryType: HDEncryType.md5) 支持md5/sha1/sha224/sha256/sha384/sha512/base64加密 |
三、其他
欢迎交流，互相学习