iOS13-应用适配暗黑模式

1.环境

Xcode11 正式版
iOS13 beta版本
Mac系统: 10.15 beta版本

2.原理

• 将同一个资源，创建出两种模式的样式。系统根据当前选择的样式，自动获取该样式的资源。
• 每次系统更新样式时，应用会调用当前所有存在的元素调用对应的一些重新方法，进行重绘视图，可以在对应的方法做相应的改动

3.资源适配

• 1.创建一个Assets文件（或在现有的Assets文件中）
• 2.新建一个图片资源文件（或者颜色资源文件、或者其他资源文件）
• 3.选中该资源文件， 打开 Xcode ->View ->Inspectors ->Show Attributes Inspectors （或者Option+Command+4）视图，将 Apperances 选项 改为Any，Dark
  图一

• 4.执行完第三步，资源文件将会有多个容器框，分别为 Any Apperance 和 Dark Apperance. Any Apperance 应用于默认情况（Unspecified）与高亮情况（Light）， Dark Apperance 应用于暗黑模式（Dark）

  
  图二
• 代码默认执行时，就可以正常通过名字使用了，系统会根据当前模式自动获取对应的资源文件

4. UIColor 适配

iOS13之前的UIColor 只能返回一种特定的颜色，iOS13及其以后可以返回动态的颜色
UIColor增加了两个初始化方法，使用以下方法可以创建动态UIColor
注:一个是类方法，一个是实例方法，两个方法如下：

+ (UIColor *)colorWithDynamicProvider:(UIColor * (^)(UITraitCollection *traitCollection))dynamicProvider API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(watchos);
- (UIColor *)initWithDynamicProvider:(UIColor * (^)(UITraitCollection *traitCollection))dynamicProvider API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(watchos);

• 方法需要传一个block
• 当系统在LightModel 跟DarkMode中进行切换的时候，会立刻回调这个方法（应用不管处于前台还是后台）
• block中返回当前的traitCollection对象，我们根据它的属性userInterfaceStyle 判断当前的显示模式,block中返回对应模式下的color
  UIUserInterfaceStyle 枚举类型如下：

typedef NS_ENUM(NSInteger, UIUserInterfaceStyle) {
    UIUserInterfaceStyleUnspecified,
    UIUserInterfaceStyleLight,
    UIUserInterfaceStyleDark,
}

示例代码🌰

-(void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection {
    NSLog(@"traitCollectionDidChange");
   //创建动态 color
    UIColor *color = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
        if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
            return [UIColor darkGrayColor];
        } else {
            return [UIColor redColor];
        }

    }];
    self.view.backgroundColor = color;

}

5.CGColor 适配

iOS13后，UIColor能够表示动态颜色，但是CGColor依然只能表示一种颜色，那么对于CALayer等对象如何适配暗黑模式呢?
有几下三种方式进行表示

方法如下：

-(void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection {
    NSLog(@"traitCollectionDidChange");
    if (@available(iOS 13.0, *)) {
        //创建动态 bgColor
        UIColor *bgColor = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
            if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
                return [UIColor blackColor];
            } else {
                return [UIColor whiteColor];
            }
        }];
        self.view.backgroundColor = bgColor;
        //创建动态 layerColor
        UIColor *layerColor = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
            if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
                return [UIColor darkGrayColor];
            } else {
                return [UIColor redColor];
            }
        }];
        //改变layer 颜色
            //1.方法一
        //    UIColor *resolveColor = [layerColor resolvedColorWithTraitCollection:self.traitCollection];
        //    layer.backgroundColor = resolveColor.CGColor;
            //2.方法二
        //    [self.traitCollection performAsCurrentTraitCollection:^{
        //        UIColor *resolveColor = [layerColor resolvedColorWithTraitCollection:self.traitCollection];
        //        layer.backgroundColor = resolveColor.CGColor;
        //    }];
            //3.方法三
            layer.backgroundColor = layerColor.CGColor;
    } else {
        NSLog(@"不是iOS13 所以不需要暗黑模式");
    }
}

6.更新方法

当用户更改外观时，系统会通知所有window与View需要更新样式，在此过程中iOS会触发以下方法, 完整的触发方法文档

UIView:中可以调用如下方法进行更改

traitCollectionDidChange(_:)
layoutSubviews()
draw(_:)
updateConstraints()
tintColorDidChange()

UIViewController:中可以调用如下方法进行更改

traitCollectionDidChange(_:)
updateViewConstraints()
viewWillLayoutSubviews()
viewDidLayoutSubviews()

UIPresentationController:中可以调用如下方法进行更改

traitCollectionDidChange(_:)
containerViewWillLayoutSubviews()
containerViewDidLayoutSubviews()

7.暗黑适配几种情况

1> 默认情况下应用不做任何处理是需要跟随手机系统做暗黑适配
2> 如果整个应用中坚持是Light 或者Dark模式，需要在info.plist
中 添加 UIUserInterfaceStyle 为 Light 或者Dark
3> 部分UIView / UIViewcontroller / UIWindow 不跟随手机暗黑适配

a.UIViewController与UIView 都新增一个属性 -overrideUserInterfaceStyle
b.将 -overrideUserInterfaceStyle 设置为对应的模式，则强制限制该元素与其子元素以设置的模式进行展示，不跟随系统模式改变进行改变
c.-overrideUserInterfaceStyle影响范围

设置 ViewController 的该属性， 将会影响视图控制器的视图和子视图控制器采用该样式，不影响弹出的vc
设置 View 的该属性， 将会影响视图及其所有子视图采用该样式
设置 Window 的该属性， 将会影响窗口中的所有内容都采用样式，包括根视图控制器和在该窗口中显示内容的所有演示控制器（UIPresentationController）

/*
* When set on an ordinary `UIView`:
 * - This property affects only the traits of this view and its subviews.
 * - It does not affect any view controllers, or any subviews that are owned by different view controllers.
 *
 * When set on a `UIWindow`:
 * - This property affects the `rootViewController` and thus the entire view controller and view hierarchy.
 * - It also affects presentations that happen inside the window.
 */
@property (nonatomic) UIUserInterfaceStyle overrideUserInterfaceStyle API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(watchos);

8.模式切换打印

模式切换时自动打印log，就不需要我们一次又一次的执行po命令了
在Xcode菜单栏Product->Scheme->Edit Scheme
选择Run->Arguments->Arguments Passed On Launch
添加以下命令即可
-UITraitCollectionChangeLoggingEnabled YES

图三

当切换模式就会在控制台打印出信息，信息如下：

图四

9.资料借鉴

demo: https://github.com/sisios/DarkModel.git
WWDC视频：https://developer.apple.com/videos/play/wwdc2019/214/
https://www.jianshu.com/p/7925bd51d2d6
https://www.jianshu.com/p/e6616e44cf60

10.项目实战：

我们项目用的DKNightVersion三方适配夜间模式，为了更好的兼容iOS13暗黑模式，我在第一个页签的viewcontroller的重写*-(void)traitCollectionDidChange:(UITraitCollection )previousTraitCollection方法

• 当app被杀死，修改暗黑模式后，重启app

-(void)applicationDidFinishLaunching:(UIApplication *)application {
    //暗黑模式
    if (@available(iOS 13.0, *)) {
        UIUserInterfaceStyle style = UITraitCollection.currentTraitCollection.userInterfaceStyle;
        if (style == UIUserInterfaceStyleDark) {
            [[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"showNightMode"];
           
            [self.dk_manager nightFalling];
        } else {
            [[NSUserDefaults standardUserDefaults] setBool:NO forKey:@"showNightMode"];
            [self.dk_manager dawnComing];
        }
    } else {
        NSLog(@"不是iOS13，不需要暗黑模式");
    }
}

• 当app处于active（前台或者后台）

//暗黑模式
-(void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection {
    NSLog(@"traitCollectionDidChange");
   //创建动态 color
    if (@available(iOS 13.0, *)) {
        UIColor *color = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
            if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
                [[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"showNightMode"];
                
                [self.dk_manager nightFalling];
                return [UIColor blackColor];
            } else {
                [[NSUserDefaults standardUserDefaults] setBool:NO forKey:@"showNightMode"];
                
                [self.dk_manager dawnComing];
                return [UIColor whiteColor];
            }
        }];
        self.view.backgroundColor = color;
    } else {
        NSLog(@"不是iOS13版本不需要暗黑模式");
    }

}

以上就是我总记得iOS13适配暗黑模式的总结，如有错误，不吝赐教！