Halo: A Swift repository from zhangzichen

简介

Halo 是我使用 Swift 开发 iOS 应用一年下来所积累的一个工具库（当然也会有些以前 ObjC 的“遗老”），这篇文章中我会简单说明一下自己是如何设计并使用 Halo 的

Halo 的名字取自一款叫做 HALO 的游戏。我比较喜欢这款游戏宏大的背景，所以就叫做这个名字了

Tips

Halo 使用 Swift 编写，仅支持 iOS 平台
我现在使用 CocoaPods 将 Halo 集成进自己的项目（PS: pod search Halo）

链式语法

Halo 中很多方法都是为了实现链式语法，或者带有链式语法的特性

非链式语法：

object.propertyA = valueA
object.propertyB = valueB
object.propertyC = valueC
object.propertyD = valueD

链式语法：

object
	.propertyA(valueA)
	.propertyB(valueB)
	.propertyC(valueC)
	.propertyD(valueD)

效果图：

我这样作的主要原因有：

不喜欢在设置 object 的若干属性时每次都要多写一个 object
可以在 map 等函数中设置属性的同时返回结果

这种方法的基本实现为：

extension Class {
	//	Chainable method of property
	func property(property: propertyType) -> Self {
		self.property = property
		return self
	}
}

Halo 详细介绍

Halo.framework 工程目录如下图：

接下来的时间，我会介绍一下 Source 目录下各个文件实现的主要功能

Swift+Halo

CGFloatable.swift

该文件提供了一个CGFloatable协议，主要是觉得在 Swift 编译器总是认为 "1" 是Int值，和CGFloat数据使用时总会出先编译错误。所以为Int、Double、Float实现了CGFloatable 协议，通过 .f 的形式快速转化为CGFloat（而不是麻烦的 CGFloat(X)）同时在此基础上，使用硬编码对屏幕适配做了一些处理

Print+Halo.swift

通过ccRight、ccWarning、ccError输出表情符号方便调试之后我们可以在控制台输出像这样的东西：

UIKit+Halo

这个目录下的文件以 extension 的形式大量的实现了 UIKit 一些常用控件的链式语法，以方便日常开发的使用

除此之外，还有一些边边角角的东西：

UITableView/UICollectionView 利用泛型快速注册/重用单元格方法
使用 Hex 值初始化 UIColor
UIImage静态模糊
UIView 截屏
文本显示所需高度计算
UIAlertController 封装 ...

KeyboardObserver

实现这个类主要是原来每次在不同 UIViewController 中处理键盘事件，写了很多重复代码，被恶心到了(-_-!)

假设我们需要在 ViewController 类中监听键盘高度，只需要设置（我通常在 viewDidLoad 方法中）：

KeyboardObserver.delegate = self

让 ViewController 实现相关协议：

// MARK: - KeyboardObserverDelegate
extension ViewController : KeyboardObserverDelegate {
	func keyboardWillChangeToHeight(height: CGFloat, duration: NSTimeInterval) {
		//	height 就是键盘即将改变到的高度
	}
}

如果你还想使用 Halo 对 UIScrollView 的拓展，再调用一下 insetBottom() 就可以方便快捷的实现键盘高度变化的响应了~

	func keyboardWillChangeToHeight(height: CGFloat, duration: NSTimeInterval) 
		scrollView.insetBottom(height)
	}

PS：方便归方便，但是这个类的我写的有点乱，有机会一定好好整理一下！

方圆（FangYuan）

Update: 现在方圆在这里

一套微型布局库，使用 UIView.frame 进行布局，功能简单，上手快速！

我是这样想的

任何一个 UIView ，我们知道其在 X 轴上的宽度、<左边-父视图左边>距离、<右边-父视图右边>距离中的任意两者，即可确定UIView.frame.origin.x和UIView.frame.size.width
任何一个 UIView ，我们知道其在 Y 轴上的高度、<上边-父视图上边>距离、<下边-下视图右边>距离中的任意两者，即可确定UIView.frame.origin.y和UIView.frame.size.height
通过前两步，即可确定该 UIView 的 frame
予以实现

简单展示

假设我们想达到这样的需求：

1、testView_A
	距离顶部30，距离右侧30，高度为100，距离左侧30
2、testView_B
	距离 testView_A 的底部 25
	距离 superView 左侧的距离等于 testView_A 距离 superView 左侧的距离
	距离 superView 右侧的距离等于 testView_A 距离 superView 右侧的距离 + 10
	距离 superView 底部的距离等于 30

效果图：

不使用任何第三方布局方式：

class ViewController: UIViewController {

	let testView_A = UILabel()

	let testView_B = UILabel()

	override func viewDidLoad() {
		super.viewDidLoad()
	
		view.addSubview(testView_A)
		view.addSubview(testView_B)
	
		testView_A.text = "testView_A"
		testView_B.text = "testView_B"
	
		var frameA = CGRectZero
		frameA.origin.x = 30
		frameA.origin.y = 30
		frameA.size.width = UIScreen.mainScreen().bounds.size.width - frameA.origin.x - 30
		frameA.size.height = 100
		testView_A.frame = frameA
	
		var frameB = CGRectZero
		frameB.origin.x = testView_A.frame.origin.x
		frameB.origin.y = testView_A.frame.origin.y + testView_A.frame.size.height + 25
		frameB.size.width = UIScreen.mainScreen().bounds.size.width - testView_A.frame.origin.x - (testView_A.superview!.frame.size.width - (testView_A.frame.origin.x + testView_A.frame.size.width)) - 10
		frameB.size.height = UIScreen.mainScreen().bounds.size.height - frameB.origin.y - 30
		testView_B.frame = frameB
	
	
		testView_A.backgroundColor = UIColor.redColor()
		testView_B.backgroundColor = UIColor.blueColor()
	}
}

使用 FangYuan：

import UIKit
import Halo

class ViewController: UIViewController {
	
	let testView_A = UILabel()
	
	let testView_B = UILabel()

	override func viewDidLoad() {
		super.viewDidLoad()
		
		view.addSubview(testView_A)
		view.addSubview(testView_B)
		
		testView_A.text = "testView_A"
		testView_B.text = "testView_B"
		
		//	------- 主要变化 -------
		
		testView_A
			.top(30)
			.right(30)
			.height(100)
			.left(30)
		
		testView_B
			.top(testView_A.chainBottom + 25)
			.left(testView_A.left)
			.right(testView_A.right + 10)
			.bottom(30)
			
		//	---------------------
		
		testView_A.backgroundColor = UIColor.redColor()
		testView_B.backgroundColor = UIColor.blueColor()
	}
}

可以看到 FangYuan 能简化很多代码，就算是和 Masonry 相比，也能省下不少代码，同时也还能实现同样的效果

FangYuan 的缺点

需要知道在UIView.superView存在时才有效
FangYuan 的诸多方法需要在layoutSubviews或viewWillLayoutSubviews调用才能保证随superView.frame的变化而变化，比如上述代码的ViewController外如果嵌套在一个 NavigationController中，会出现这种情况（因为FangYuan的方法写在了viewDidLoad中）：

FangYuan 的使用情况

我在最近的一个项目中，仅仅使用了 Halo.FangYuan 就实现了整个项目的布局😁

如何在你的项目中集成 Halo.framework

CocoaPods（推荐）

直接使用 pod 'Halo'，不要忘记 use_frameworks!~

Carthage

1、直接在Github下载下来整个项目 2、打开终端 3、cd [解压缩后的工程目录] 4、carthage build --no-skip-current 5、在工程目录中 Carthage/Build/iOS/ 中找到 Halo.framework 6、接下来就是将 Halo.framework 集成到你的工程中了，相信大家看到这里，应该都肯定会的吧~

使用 Carthage 上线到 AppStore 时的坑

使用上述方法集成的 Halo.framework 在（且仅在）上传至 AppStore 时会出错，原因是将 Halo.framework 中多余的 Architectures 打包进了索要上传的应用程序包中，解决方案大家可以参照这里或者Stackoverflow

囧，这个分明是我的锅啊，有时间一定解决！

总结

现在

总得来说，Halo.framework 是很多小工具的集合，我本着快捷、高效、代码美观、意义明晰的想法去设计向其中不断整合代码。

平时写项目，写Demo感觉根本离不开~不过，相比于网上知名的第三方库来说，就羸弱很多了😓

将来

最近读了喵神的如何打造一个让人愉快的框架，感觉自己的 Halo 即便仅仅是个人使用，也有很多可以改进的地方，比如：

你还没有对 FangYuan 进行过性能优化啊？
FangYuan 一定要在layoutSubviews或viewWillLayoutSubviews才能保证使用FangYuan的UIView的superView一定存在吗？才能保证任何 frame 变动时，约束都能生效吗？是不是可以利用 runtime 做一些事情呢？
书写链式语法时，在代码自动补齐方面，总是跟 UIKit 原有的属性相冲突，为了快速书写，也为了避免和其他第三方库产生可能的冲突，是不是应该添加前缀？

有机会的话，我一定会不断积累下去的！

zhangzichen/Halo

简介