iOS 13 DarkMode 暗黑模式

iOS 13终于引来了暗黑模式。

每当新特性的到来，iOS开发者们既紧张又有点小兴奋，怀揣着被虐的心态，让我们来看看暗黑模式到底是个啥。

虽然这是一个设计驱动的需求，但是本着一颗虔诚(暴躁)的心，我们还是要一步步来，“工欲善其事、必先利其器”，搞清楚应该怎么做。

下载 Xcode11，跑起来你的项目。模拟器启动后，在“设置”-“开发者”中打开“Dark Appearance”后，你的项目就自动运行在暗黑模式了。

有些界面会很奇怪，这很正常，可以从一个界面入手，一步步优化它。

UITraitCollection

先来了解下 UITraitCollection。

在 iOS 13 中，我们可以通过 UITraitCollection 来判断当前系统的模式。UIView 和 UIViewController 、UIScreen、UIWindow 都已经遵从了UITraitEnvironment 这个协议，因此这些类都拥有一个叫做 traitCollection 的属性，在这些类中，我们可以这样去判断当前 App 的颜色模式：

BOOL isDark = (self.traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark);

另外，我们还可以通过 UITraitCollection.current 这个属性来获取当前 App 的颜色模式。但是并不是所有的时候获取的都是正确的，只有在下面这些方法中，才可以放心的使用这个属性：

UIView	UIViewController	UIPresentationController
draw()
layoutSubview()	viewWillLayoutSubviews() viewDidLayoutSubviews()	containerViewWillLayoutSubviews() containerViewDidLayoutSubviews()
traitCollectionDidChange() tintColorDidChange()	traitCollectionDidChange()	traitCollectionDidChange()

还没适配完又不想给用户看，可以先暂时全局关闭暗黑模式：
在 Info.plist 文件中，添加 key 为 User Interface Style，类型为 String，value 设置为 Light 即可。

infoplist.png

在 iOS 13中，UIView、UIViewController 、UIWindow 有了一个 overrideUserInterfaceStyle 的新属性，可以覆盖系统的模式。

单个页面或视图关闭暗黑模式，设置 overrideUserInterfaceStyle 为对应的模式，强制限制该视图与其子视图以设置的模式进行展示，不跟随系统模式改变进行改变。

self.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;

设置此属性会影响当前view/viewController/window 以及它下面的任何内容。

如果你希望一个子视图监听系统的模式，请将 overrideUserInterfaceStyle 属性设置为.unspecified。

颜色

系统颜色

在 iOS 13中，苹果引入了全新系统颜色，系统颜色是动态的，会根据当前系统是默认模式还是暗黑模式动态调整颜色。

苹果还提供了一组动态的灰度颜色。

systemcolor.png

语义化颜色

苹果提供了一套根据颜色使用目的而约定颜色命名的语义化颜色。语义化颜色也是动态颜色。

例如系统背景色（SystemBackground）、分割线颜色（SeparatorColor）等等，使用语义化颜色确保你的 App 具有和系统应用高度类似的配色风格。通过使用语义化颜色，可以让你的 App 更加贴近原生体验，这是官方希望达到的最佳体验。

elementcolor.png

以上两种动态颜色，是 iOS 13 才支持的新特性，并且颜色有限，大概率不能满足 App 的使用，继续往下看。

自定义颜色：通过 Assets 配置

在 iOS 11和 Xcode 9 中，我们可以在 Images.xcassets 中添加颜色。

现在我们可以为颜色再配置一个用于暗黑模式的对应的颜色。

assets.png

通过代码自定义颜色

+ (UIColor *)colorWithDynamicProvider:(UIColor * (^)(UITraitCollection *))dynamicProvider;
- (UIColor *)initWithDynamicProvider:(UIColor * (^)(UITraitCollection *))dynamicProvider;

iOS 13 提供了的新方法，可以在 block 中判断 traitCollection.userInterfaceStyle，根据系统模式设置返回的颜色。

+(UIColor *)generateDynamicColor:(UIColor *)lightColor darkColor:(UIColor *)darkColor{
    if (@available(iOS 13.0, *)) {
        UIColor *dyColor = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
            if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleLight) {
                return lightColor;
            }else {
                return darkColor;
            }
        }];
        return dyColor;
    }else{
        return lightColor;
    }
}

图片

SF Symbols

苹果在 WWDC19 上引入了 SF Symbols 。SF Symbols是一个巨大的矢量图标库（超过1500），可供开发人员在自己的 App 中使用。

更多可以查看关于 SF Symbols 的 Session 206-Introducing SF Symbols，下载.dmg可以查看全部图标。苹果在自己的应用中使用，也推荐开发者使用。

if (@available(iOS 13.0, *)) {
        _iconIV.image = [UIImage systemImageNamed:@"plus.circle"];
}

不想用 SF Symbols 的话，还有一种方式就是和自定义颜色相同的方法，在 Images.xcassets 中配置不同模式下的图片。

assets_image.png

在 Images.xcassets 中设置颜色和图片是向下兼容的，iOS 13 以下的系统会默认取Any状态下的设定，iOS 13 会根据系统模式取Any或Dark下的设定。

模糊效果

在 iOS 中，我们创建模糊效果的 UIVisualEffectView 的代码也会有明确表面明暗的情况。

在 iOS 13 中，我们需要让这些模糊效果随着系统模式的切换而切换。UIKit 提供了新的模糊样式且是动态的，会随着系统模式的改版而自动匹配。

利用 UIVisualEffectView 来创建一些类似模糊的效果时，不要设置类似 UIBlurEffectStyleExtraLight 这样带有明确颜色的效果，而是设置 UIKit 中新提供的动态样式的效果，比如 UIBlurEffectStyleSystemThinMaterialLight 或 UIBlurEffectStyleSystemThinMaterialDark。

UIBlurEffect *effect = [UIBlurEffect effectWithStyle:UIBlurEffectStyleSystemMaterial];
UIVisualEffectView *effectView = [[UIVisualEffectView alloc] initWithEffect:effect];

启动图

如果我们的 App 使用了 LaunchImage 作为启动屏，那么就应该考虑把 LaunchImage 换成 LaunchScreen.storyboard 了，因为在 Xcode 11 中 LaunchImage 并不能像普通的图片那样针对深色模式设置另外的一张图片。

富文本

给 Attributed String 加上一个 foregroundColor 属性，设置动态的颜色即可。

[attr addAttribute:NSForegroundColorAttributeName value:[UIColor labelColor] range:NSMakeRange(10, 20)];

layer

关于 layer 的话，可以通过调用 view. traitcollection 从 view 中获得当前的 UITraitCollection。

UIColor *resolvedColor = [[UIColor labelColor] resolvedColorWithTraitCollection:self.view.traitCollection];
label.layer.borderColor = resolvedColor.CGColor;

如果我们需要解析多种颜色，UITraitCollection 有一个方便的 performAsCurrent() 方法：

[self.view.traitCollection performAsCurrentTraitCollection:^{
    for (UIColor *color in self.colorsArr) {
        // 批量拿到 color.CGColor
    }
}];

调试 dark mode

storyboards 和 xib 文件，现在可以切换界面之间的样式是默认还是暗黑了。

在模拟器上，也可以直接切换暗黑模式进行调试了。

debug.JPG

一些新变更

UIActivityIndicatorView 的 style 变更了。
iOS 13前 的 UIActivityIndicatorViewStyle：

typedef NS_ENUM(NSInteger, UIActivityIndicatorViewStyle) {
    UIActivityIndicatorViewStyleWhiteLarge,
    UIActivityIndicatorViewStyleWhite,
    UIActivityIndicatorViewStyleGray,
};

iOS 13后，由于暗黑模式，上述三个属性都被废弃，建议使用如下 style：

typedef NS_ENUM(NSInteger, UIActivityIndicatorViewStyle) {
    UIActivityIndicatorViewStyleMedium,
    UIActivityIndicatorViewStyleLarge,
    UIActivityIndicatorViewStyleWhiteLarge API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleLarge", 
    UIActivityIndicatorViewStyleWhite API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleMedium",
    UIActivityIndicatorViewStyleGray API_DEPRECATED_WITH_REPLACEMENT("UIActivityIndicatorViewStyleMedium", 
};

Status Bar 的 style 变更了。

在 iOS 13 之前，状态栏的样式的枚举值也带有着明显的颜色倾向，UIStatusBarStyleDefault、UIStatusBarStyleLightContent。

现在，状态栏的 default 样式会根据当前的模式展示不同的颜色，而原有的 lightContent 样式则新增一个 darkContent 的样式与之对应。

typedef NS_ENUM(NSInteger, UIStatusBarStyle) {
    UIStatusBarStyleDefault      = 0, // Automatically chooses light or dark content based on the user interface style
    UIStatusBarStyleLightContent = 1, // Light content, for use on dark backgrounds
    UIStatusBarStyleDarkContent  = 3, // Dark content, for use on light backgrounds
};

参考资料：

How To Adopt Dark Mode In Your iOS App

Backwards compatibility for iOS 13 system colors

写给设计师的指南：iOS 13 Dark Mode 深度解析

作者简介

就职于甜橙金融（翼支付）信息技术部，负责 iOS 客户端开发。