使用步骤
首先，请先确认你希望以什么样的形式封装你的主题对象，以 QMUI Demo 为例，每个主题对应一个配置表，每个配置表均为一个 NSObject<QDThemeProtocol> * 类型。
然后，在尽量早的时机初始化 QMUIThemeManager，以保证其他使用颜色、图片的地方能获取到正确的值。
QMUI Demo 中选择的时机是:application:didFinishLaunchingWithOptions:。
- 先注册主题监听，在回调里将主题持久化存储（存到数据库或者 NSUserDefaults），避免启动过程中主题发生变化时读取到错误的值
[[NSNotificationCenter defaultCenter]
addObserver:self
selector:@selector(handleThemeDidChangeNotification:)
name:QMUIThemeDidChangeNotification
object:nil];
- 然后设置用于生成主题的 block，在需要的时候 QMUIThemeManager 会通过这个 block 得到一个主题对象
QMUIThemeManager.sharedInstance.themeGenerator = ^__kindof NSObject * _Nonnull(NSString * _Nonnull identifier) {
if ([identifier isEqualToString:@"Default"]) return QMUIConfigurationTemplate.new;
if ([identifier isEqualToString:@"Dark"]) return QMUIConfigurationTemplateDark.new;
return nil;
};
- 再针对 iOS 13 开启自动响应系统的 Dark Mode 切换// 如果不需要兼容 iOS 13 Dark Mode，则不需要这一段代码
if (@available(iOS 13.0, *)) {
// 先通过这个 block 来决定当系统的 Dark Mode 发生切换时，要如何映射到业务的主题
QMUIThemeManager.sharedInstance.identifierForTrait = ^__kindof NSObject<NSCopying> * _Nonnull(UITraitCollection * _Nonnull trait) {
if (trait.userInterfaceStyle == UIUserInterfaceStyleDark) {
return @"Dark";// 表示当检测到系统开启了 Dark Mode 时，将主题自动切换到 Dark
}
return @"Default";
};
// 然后让 QMUIThemeManager 自动响应系统的 Dark Mode 切换
QMUIThemeManager.sharedInstance.respondsSystemStyleAutomatically = YES;
}
做完以上的初始化配置后，剩下的就是业务界面的适配了，按照上文提到的，将 color、image、effect 都换成对应的动态对象。
view.backgroundColor = [UIColor qmui_colorWithThemeProvider:^UIColor * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, __kindof NSObject * _Nullable theme) { return [identifier isEqualToString:@"Dark"] ? UIColor.blackColor : UIColor.whiteColor;}];
layer.backgroundColor = [UIColor qmui_colorWithThemeProvider:^UIColor * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, __kindof NSObject * _Nullable theme) { return [identifier isEqualToString:@"Dark"] ? UIColor.blackColor : UIColor.whiteColor;}].CGColor;
imageView.image = [UIImage qmui_imageWithThemeProvider:^UIImage * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, NSObject<QDThemeProtocol> *theme) { return [UIImage imageNamed:[identifier isEqualToString:@"Dark"] ? @"image_dark" : @"image_default"];}];
visualEffectView.effect = [UIVisualEffect qmui_effectWithThemeProvider:^UIVisualEffect * _Nonnull(__kindof QMUIThemeManager * _Nonnull manager, NSString * _Nullable identifier, NSObject<QDThemeProtocol> *theme) { return [UIBlurEffect effectWithStyle:[identifier isEqualToString:@"Dark"] ? UIBlurEffectStyleDark : UIBlurEffectStyleLight];}];
通常来说，一个项目里的颜色、模糊效果一般都只有可枚举的固定的几个，建议将这些颜色、模糊效果缓存起来（使用 static 变量，或者用一个单例去保存，可参考 QDThemeManager），这样可以大大减少代码量，也不需要去记住创建动态对象的语法。
// 适当做一些抽取，就可以减少大量的代码
view.backgroundColor = UIColor.qd_backgroundColor;
layer.backgroundColor = UIColor.qd_separatorColor.CGColor;
visualEffectView.effect = UIVisualEffect.qd_standardBlurEffect;
到此大部分界面已经可以兼容，而对于自定义的 View 组件，它们的自定义属性需要在主题切换时被刷新，则可参照下方来注册属性给 QMUIThemeManager。
@implementation CustomView
- (instancetype)initWithFrame:(CGRect)frame {
if (self = [super initWithFrame:frame]) {
// ...
// 将组件里的样式定义为 property，然后通过 qmui_registerThemeColorProperties: 注册给 QMUIThemeManager，这样当主题发生变化时，会遍历整个界面的所有 view，重新设置被注册的属性
[self qmui_registerThemeColorProperties:@[NSStringFromSelector(@selector(borderColor)),
NSStringFromSelector(@selector(contentImage)),
NSStringFromSelector(@selector(backgroundEffect))]];
}
return self;
}
@end
如果上述提供的功能仍未能满足业务的需求，也可直接重写
UIView/UIViewController 的 qmui_themeDidChangeByManager:identifier:theme: 方法，在内部写自己的逻辑。
至此整个 App 的主题实现和 Dark Mode 兼容工作就全部完成了。
至于主题的切换，如果 App 只是兼容 iOS 13 Dark Mode，则不需要理会这一点，如果 App 里有提供主动切换主题的操作给用户，则可参照以下代码：
QMUIThemeManager.sharedInstance.currentThemeIdentifier = @"Dark";
// 切换到名为 Dark 的主题// 或
QMUIThemeManager.sharedInstance.currentTheme = darkTheme;
// 切换到 darkTheme 主题对象
网友评论