由 布多(budo) 发布于 2020-12-05
LLDark
适用于iOS的强大深色主题框架,快速适配深色模式。
国内用户可以访问这个链接
特性
- 集成简单,只需改动少量代码即可完美适配。
- 高性能,仅在需要更新页面时更新指定页面,有相关缓存策略缩短刷新时长。
- 功能强大,所有使用UIColor、UIImage、CGColor的地方均可完美适配。
- 兼容iOS13以下机型。
- 支持从网络上获取深色主题配置。
- 自动适配启动图为APP当前主题模式。
Demo

用法
前提
配置深色资源:
在工程任意NSObject分类(建议单独新建一个主题分类)中创建+ (NSDictionary<id, id> *)llDarkTheme
类方法,字典的key表示浅色主题下的颜色/图片名称/图片地址,字典的value表示深色主题下的颜色/图片名称/图片地址。可参考样例代码:
+ (NSDictionary<id, id> *)llDarkTheme { return @{ UIColor.whiteColor : kColorRGB(27, 27, 27), kColorRGB(240, 238, 245) : kColorRGB(39, 39, 39), [UIColor colorWithRed:14.0 / 255.0 green:255.0 / 255.0 blue:0.0 alpha:1.0] : [UIColor colorWithRed:0.0 green:14.0 / 255.0 blue:255.0 / 255.0 alpha:1.0], @"background_light" : @"background_dark", @"~/path/background_light.png" : @"~/path/background_dark.png", }; }
|
Tips:
1.不必把所有情况下的颜色/图片都填写进去,对于偶尔或少数使用到的深色颜色可以参考高级用法单独适配。 2.图片名称不用考虑倍图关系;如果填写的是图片路径一定要填写完整的图片路径(包含后缀)。
基本用法
UIColor和CGColor只需要追加.themeColor(nil)即可。
UIImage只需要将imageNamed或imageWithContentsOfFile替换为themeImage即可。
UIColor.redColor; UIColor.redColor.themeColor(nil);
UIColor.redColor.CGColor; UIColor.redColor.themeCGColor(nil);
[UIImage imageNamed:@"lightImageName"]; [UIImage themeImage:@"lightImageName"];
|
Tips:
1.themeImage适配了imageNamed和imageWithContentsOfFile两个方法,可以传递图片名称,也可以传递图片路径。 2.只有适配过的Color和Image在主题切换时才会刷新。
高级用法
1.themeColor()里面的参数如果是具体的Color对象,深色主题则会使用指定的Color对象刷新, 如果是nil则会返回llDarkTheme中配置的深色颜色刷新, 如果llDarkTheme未配置则会返回浅色主题下的颜色。
2.themeCGColor()参数的作用和themeColor()参数作用一样。
3.themeImage()有2个参数,参数可以是图片名称,也可以是图片地址, 第1个参数表示浅色主题下使用的图片(必填), 第2个参数表示深色主题下使用的图片(可以为空), 第2个参数为空的话和themeColor()为空的处理方式一样。
4.appearanceBindUpdater,所有继承自UIView的对象都拥有这个属性, 对象需要刷新时会调用它,可以在这里实现自己的刷新逻辑。 仅在需要刷新时会调用,主题更改不一定需要刷新UI。
5.userInterfaceStyle,类似iOS13系统的overrideUserInterfaceStyle方法, 但是功能比overrideUserInterfaceStyle更加强大, 它支持所有的对象,例如CALayer。 它支持iOS13以下的系统使用。
6.themeDidChange,所有对象都拥有这个属性,作用和ThemeDidChangeNotification一样, themeDidChange会在对象释放时被释放掉, 可以在多个地方使用,不保证回调顺序, 不同于appearanceBindUpdater,只要主题发生改变就会调用themeDidChange。
7.systemThemeDidChange,所有对象都拥有这个属性,作用和SystemThemeDidChangeNotification一样, 释放时机和themeDidChange一样, 可以在多个地方使用,不保证回调顺序, 只要系统主题发生改变就会调用systemThemeDidChange。
8.darkStyle,所有UIImageView对象都拥有这个方法,用于适配没有深色图片的图片对象,例如网络图片。 darkStyle有3个参数,第1个参数决定如何适配深色主题,目前有LLDarkStyleSaturation和LLDarkStyleMask两种, LLDarkStyleMask使用蒙层适配,LLDarkStyleSaturation通过降低原图饱合度适配。 第2个参数决定蒙层透明度/饱合度值,具体使用可看源码注释。 第3个参数可以为nil,使用LLDarkStyleSaturation时需要传递一个唯一字符串当做标识符,通常是图片的url。 样例代码: UIImageView *imageView = [[UIImageView alloc] init]; NSString *url = @"图片URL"; imageView.darkStyle(LLDarkStyleSaturation, 0.2, url);
9.updateDarkTheme:,如果需要运行时修改深色主题配置信息,或者需要从网络上获取深色主题配置信息,可以使用updateDarkTheme:来达到目的。 请确保在第1个UI对象加载前配置好深色主题信息,否则会无效。 样例代码: NSDictionary *darkTheme = @{ UIColor.whiteColor : kColorRGB(27, 27, 27), kColorRGB(240, 238, 245) : kColorRGB(39, 39, 39), [UIColor colorWithRed:14.0 / 255.0 green:255.0 / 255.0 blue:0.0 alpha:1.0] : [UIColor colorWithRed:0.0 green:14.0 / 255.0 blue:255.0 / 255.0 alpha:1.0], @"background_light" : @"background_dark", @"~/path/background_light.png" : @"~/path/background_dark.png", }; [LLDarkSource updateDarkTheme:darkTheme];
10.thirdControlClassName,如果需要支持第3方控件的刷新方法,可以在appearanceBindUpdater中单独实现刷新逻辑,也可以按照如下方法实现刷新逻辑,更加推荐如下方法。 首先需要实现thirdControlClassName这个类方法,并返回一个数组,数组包含第3方控件的类名字符串。 然后实现refresh+类名字符串的对象方法,在方法里实现第3方控件的刷新逻辑,可以参考LLThird.m文件中已经实现的YYLabel的刷新逻辑。 详情可以下载工程查看Demo了解具体实现。
|
高级用法中第8条darkStyle方法的样例图(为了突出效果特意将饱合度和透明度调整的很低):
快速适配
仅需要3步即可快速完美适配深色主题模式,经测试大部分工程都能在0.5天内适配完成,
少量工程1天内适配完成,极少需要1天以上的工作量进行适配。
- 配置深色主题资源,可参考
前提
,也可以参考高级方法9
从网络中获取资源适配。
- 将需要适配的Color和Image适配为主题Color和主题Image,适配方法可参考
基础用法
和高级用法
。
- 运行工程,检查完整性。
Tips:
如果您还需要适配WKWebView
,可以点击链接参考文章进行适配。
安装
CocoaPods
- 将 cocoapods 更新至最新版本。
- 在 Podfile 中添加 pod ‘LLDark’。
- 执行 pod install 或 pod update。
- 导入 <LLDark/LLDark.h>。
手动安装
- 下载 LLDark 文件夹内的所有内容。
- 将 LLDark 工程中的LLDark文件夹添加(拖放)到你的工程。
- 导入 “LLDark.h”。
系统要求
该项目最低支持iOS9.0和Xcode10.0,如果想在更低系统上使用请联系作者。
注意点
- 需要自己监听主题模式修改状态栏颜色。
已知问题
- 需要适配深色主题的图片资源请不要放在Assets.xcassets中,否则可能会获取不到。
- 暂时不支持其他主题模式,后续会支持多种主题自由搭配。
联系作者
如果你有更好的改进,please pull reqeust me
如果你有任何更好的意见,请创建一个Issue
可以通过此邮箱联系作者internetwei@foxmail.com
许可证
LLDark 使用 MIT 许可证,详情见 LICENSE 文件。