DKNightVersion 的实现 --- 如何为 iOS 应用添加夜间模式
在很多重阅读或者需要在夜间观看的软件其实都会把夜间模式当做一个 App 所需要具备的特性. 而如何在不改变原有的架构, 甚至不改变原有的代码的基础上, 就能为应用优雅地添加夜间模式就成为一个在很多应用开发的过程中不得不面对的一个问题.
就是以上事情的驱动, 使我思考如何才能使用一种优雅并且简洁的方法解决这一问题.
而 DKNightVersion 就是我带来的解决方案.
到目前为止, 这个框架的大部分的工作都已经完成了, 或许它现在不够完善, 不过我会持续地维护这个框架, 帮助饱受实现夜间模式之苦的工程师们解决这个坑的一逼的需求.
实现
现在我也终于有时间来水一水写一篇博客来说一下这个框架是如何实现夜间模式的, 它都有哪些特性.
在很长的一段时间我都在想如何才能在不覆写 UIKit
控件的基础上, 为 iOS App 添加夜间模式. 而 objc/runtime
为我带来了不覆写 UIKit
就能实现这一目的的希望.
为 UIKit 控件添加 nightColor
属性
因为我们并不会子类化 UIKit 控件, 然后使用 @property
为它的子类添加属性. 而是使用 Objective-C 中神奇的分类(Category) 和 objc/runtime
, 为 UI 系列的控件添加属性.
使用 objc/runtime
为分类添加属性相信很多人都知道而且经常在开发中使用了. 如果不了解的话, 可以看这里.
DKNightVersion 为大多数常用的 color
比如说: backgroundColor
tintColor
都添加了以 night
开头的夜间模式下的颜色, nightBackgroundColor
nightTintColor
.
- (UIColor *)nightBackgroundColor {
return objc_getAssociatedObject(self, &nightBackgroundColorKey) ? :self.backgroundColor);
}
- (void)setNightBackgroundColor:(UIColor *)nightBackgroundColor {
objc_setAssociatedObject(self, &nightBackgroundColorKey, nightBackgroundColor, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
我们创建这个属性以保存夜间模式下的颜色, 这样当应用的主题切换到夜间模式时, 将 nightColor
属性存储的颜色赋值给对应的 color
, 但是这会有一个问题. 当应用重新切换回正常模式时, 我们失去了原有正常模式的 color
.
添加 normalColor
存储颜色
为了解决这一问题, 我们为 UIKit 控件添加了另一个属性 normalColor
来保存正常模式下的颜色.
- (UIColor *)normalBackgroundColor {
return objc_getAssociatedObject(self, &normalBackgroundColorKey);
}
- (void)setNormalBackgroundColor:(UIColor *)normalBackgroundColor {
objc_setAssociatedObject(self, &normalBackgroundColorKey, normalBackgroundColor, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
但是保存这个颜色的时机是非常重要的, 在最开始的时候, 我的选择是直接覆写 setter
方法, 在保存颜色之前存储 normalColor
.
- (void)setBackgroundColor:(UIColor *)backgroundColor {
self.normalBackgroundColor = backgroundColor;
_backgroundColor = backgroundColor;
}
然而这种看似可以运行的 setter
其实会导致视图不会被着色, 设置 color
包括正常的颜色都不会有任何的反应, 反而视图的背景颜色一片漆黑.
由于上面这种方法行不通, 我想换一种方法使用观察者模式来存储 normalColor
, 将实例自己注册为 color
属性的观察者, 当 color
属性变化时, 通知 UIKit 控件本身, 然后, 把属性存到 normalColor
属性中.
然而在什么时候将自己注册为观察者这一问题, 又使我放弃了这一解决方案. 最终选择方法调剂来解决原有 color
的存储问题.
使用方法调剂为原有属性的 setter
方法添加钩子, 在方法调用之前, 将属性存储起来, 用于切换回 normal
模式时, 为属性赋值.
这是要与 setter
调剂的钩子方法:
- (void)hook_setBackgroundColor:(UIColor*)backgroundColor {
if ([DKNightVersionManager currentThemeVersion] == DKThemeVersionNormal) {
[self setNormalBackgroundColor:backgroundColor];
}
[self hook_setBackgroundColor:backgroundColor];
}
如果当前是 normal
模式, 就会存储 color
, 如果不是就会直接赋值, 如果你看不懂为什么这里好像会造成无限递归, 请看这里, 详细的解释了方法调剂是如何使用的.
DKNightVersionManager 实现 color
切换
我们已经为 UIKit 控件添加了 normalColor
和 nightColor
, 接下来我们需要实现 color
在这两者之间的切换, 而这 DKNightVersionManager
就是为了处理模式切换的类.
通过为 DKNightVersionManager
创建一个单例来处理 模式转换
, 使用默认颜色
, 动画时间
等操作.
当调用 DKNightVersionManager
的类方法 nightFalling
或者 dawnComing
时, 我们首先会获取全局的 UIWindow
, 然后通过递归调用 changeColor
方法, 使能够响应 changeColor
方法的视图改变颜色.
- (void)changeColor:(id <DKNightVersionChangeColorProtocol>)object {
if ([object respondsToSelector:@selector(changeColor)]) {
[object changeColor];
}
if ([object respondsToSelector:@selector(subviews)]) {
if (![object subviews]) {
// Basic case, do nothing.
return;
} else {
for (id subview in [object subviews]) {
// recursice darken all the subviews of current view.
[self changeColor:subview];
if ([subview respondsToSelector:@selector(changeColor)]) {
[subview changeColor];
}
}
}
}
}
因为我在这个类中并没有引入 category
, 编译器不知道 id
类型具有这两个方法. 所以我声明了一个协议, 使 changeColor
中的方法来满足两个方法 changeColor
和 subViews
. 不让编译器提示错误.
@protocol DKNightVersionChangeColorProtocol <NSObject>
- (void)changeColor;
- (NSArray *)subviews;
@end
然后让所有的 UIKit 控件遵循这个协议就可以了, 当然我们也可以不显式的遵循这个协议, 只要它能够响应这两个方法也是可以的.
实现默认颜色
我们要在 DKNightVersion 实现默认的夜间模式配色, 以便减少开发者的工作量.
但是因为我们对每种 color
只在父类中实现一次, 这样使得子类能够继承父类的实现, 但是同样不想让 UIKit 系子类继承父类的默认颜色.
- (UIColor *)defaultNightBackgroundColor {
BOOL notUIKitSubclass = [self isKindOfClass:[UIView class]] && ![NSStringFromClass(self.class) hasPrefix:@"UI"];
if ([self isMemberOfClass:[UIView class]] || notUIKitSubclass) {
return UIColorFromRGB(0x343434);
} else {
UIColor *resultColor = self.normalBackgroundColor ?: [UIColor clearColor];
return resultColor;
}
}
通过使用 isMemberOfClass:
方法来判断实例是不是当前类的实例, 而不是该类子类的实例. 然后才会返回默认的颜色. 但是非 UIKit 中的子类是可以继承这个特性的, 所以使用这段代码来判断该实例是否是非 UIKit 的子类:
[self isKindOfClass:[UIView class]] && ![NSStringFromClass(self.class) hasPrefix:@"UI"]
我们通过 NSStringFromClass(self.class) hasPrefix:@"UI"
巧妙地达到这一目的.
使用 erb
生成 Objective-C 代码
这个框架大多数的工作都是重复的, 但是我并不想为每一个类重复编写近乎相同的代码, 这样的代码十分不易阅读和维护, 所以使用了 erb
文件, 来为生成的 Objective-C 代码提供模板, 只将元数据进行解析然后传入每一个模板, 动态生成所有的代码, 再通过另一个脚本将所有的文件加入目录中.
DKNightVersion 的实现并不复杂. 它不仅使用了 erb
和 Ruby 脚本来减少了大量的工作量, 而且使用了 objc/runtime
的特性来魔改 UIKit 组件, 达到为 iOS 应用添加夜间模式的效果.
DKNightVersion 的实现 --- 如何为 iOS 应用添加夜间模式的更多相关文章
- Xamarin SQLite教程Xamarin.iOS项目添加引用
Xamarin SQLite教程Xamarin.iOS项目添加引用 使用直接方式访问SQLite数据库,需要将System.Data和Mono.Data.SQlite库导入到创建的项目中.下面将分别讲 ...
- iOS mac添加证书 不能修改“System Roots”钥匙串错误
iOS mac添加证书 不能修改“System Roots”钥匙串错误 如图: 解决方式: 打开钥匙串---登录---,直接把证书拖过来 然后,查看--我的证书,里面,找到证书,即可
- iOS Category 添加属性实现原理 - 关联对象
iOS Category 添加属性实现原理 - 关联对象 RunTime为Category动态关联对象 使用RunTime给系统的类添加属性,首先需要了解对象与属性的关系.对象一开始初始化的时候其属性 ...
- 安卓&IOS 手机添加O365 邮箱账户
手机添加O365 邮件账户 一.Android手机添加O365邮件账户 1. 找到手机上“电子邮件” 2. 打开设置 3. 点击添加账户 4. 选择“Exchange” 5. 输入O365的邮箱账户和 ...
- iOS 设计模式之工厂模式
iOS 设计模式之工厂模式 分类: 设计模式2014-02-10 18:05 11020人阅读 评论(2) 收藏 举报 ios设计模式 工厂模式我的理解是:他就是为了创建对象的 创建对象的时候,我们一 ...
- ios xmpp开发应用后台模式接收聊天信息处理方案
ios xmpp开发应用后台模式接收聊天信息 最近在使用xmppframwork来实现一个聊天应用,碰到了一个问题,应用进入后台以后,就接收不到消息了: 怎么样才能使应用被切到后台时,应用中的网络连接 ...
- DKNightVersion的基本使用(夜间模式)
DKNightVersion下载地址: https://github.com/Draveness/DKNightVersion 基本原理就是利用一个单例对象来存储颜色, 然后通过runtime中的ob ...
- Android源码分析(十)-----关机菜单中如何添加飞行模式选项
一:关机菜单添加飞行模式选项 源码路径:frameworks/base/core/res/res/values/config.xml 增加<item>airplane</item&g ...
- MUI - myStorage在ios safari无痕浏览模式下的解决方案
myStorage在ios safari无痕浏览模式下的解决方案 今天看到了这个帖子LocalStorage 在 Private Browsing 下的一个限制, 吓尿了,如果用户开启了无痕浏览,ap ...
随机推荐
- 编写高质量JS代码的68个有效方法(十三)
No.61.不要阻塞I/O事件队列 Tips: 异步API使用回调函数来延缓处理代价高昂的操作以避免阻塞主应用程序 JavaScript并发的接收事件,但会使用一个事件队列按序地处理事件处理程序 在应 ...
- 二、中间件(middleware)
1. 中间件(middleware) Django中的中间件主要实现一些附加功能,在request被用户handler处理前,以及用户handler处理后生存的response进行处理.因此 ...
- 移动端前端常见的触摸相关事件touch、tap、swipe等整理
前端的很多事件在PC端和浏览器端可公用,但有些事件却只在移动端产生,如触摸相关的事件 本文整理了移动端常见的一些事件,包括原生支持的click.touch.tap.swipe事件,也有定义型的gest ...
- spring.Net之Ioc在MVC中的使用
1.引入dll Common.Logging.dll Spring.Core.dll Spring.Web.dll Spring.Web.Extensions.dll Spring.Web.Mvc4. ...
- JS浏览器全屏
//全屏 function fullScreen() { var el = document.documentElement; var rfs = el.requestFullScreen || el ...
- jquery ajax跨域访问webservice配置
1.webservice方法 [System.Web.Script.Services.ScriptService] public class TestService : System.Web.Serv ...
- C#十五子游戏
using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; usin ...
- web ppt
先记录,以后再试试 https://github.com/gnab/remark/wiki http://segmentfault.com/blog/sweetdum/1190000000484121 ...
- 一些java的书籍
netty in action 中文版:http://pan.baidu.com/s/1pLnEKZL spring security-3.0.1:http://pan.baidu.com/s/1bp ...
- linux下基本命令总结
基本linux命令的使用方法及实例,总结一些常用的命令: 一.创建文件和目录命令:mkdir touch(vim用得较多) 1)mdkir创建一个目录,创建多目录格式 mkdir –p a/{a,b ...