iOS 暗黑模式

需求

iOS13 的暗黑模式已经推出来有很长一段时间了，之前觉得苹果应该不会强制要求适配暗黑模式，因此仅仅是禁止暗黑模式。
然而苹果在前段时间强制要求应用必须适配暗黑模式，微信首当其冲。苹果将最后的大限延迟到了6月30号，不适配的应用将面临下架的问题，现在不得不去适配了。

好在网上有着非常多的文章可供借鉴。笔者稍微总结了一下。

环境获取和设置

禁止暗黑模式

全局禁止

在应用的 Info.plist 文件中，添加 User Interface Style 字段，设置全局的 Light。

单文件禁止

iOS13之后，UIView、UIViewController、UIWindow中有个属性 overrideUserInterfaceStyle，可以设置单文件的模式，同时会强制限制该视图的子视图以同样的模式展示。

self.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;

UITraitCollection

系统环境的特征集。通过它来判断系统当前的模式。

// Unspecified、Light和 Dark，iOS12之后
self.traitCollection.userInterfaceStyle

UIView、UIViewController、UIScreen、UIWindow 都已经遵从了UITraitEnvironment 这个协议，因此这些类都拥有一个叫做 traitCollection 的属性。

适配的元素

暗黑模式下需要注意两种适配。

动态颜色

系统颜色

iOS13中，苹果引入了一批新的系统颜色，这些颜色会根据系统当前模式进行调整。

使用 system* 开头获取这些颜色。

需要特别注意这些颜色对应获取的系统版本。

自定义颜色

系统提供的颜色种类较少，我们可以在 Assets.xcassets 中添加颜色，可以配置暗黑模式下所对应的颜色，就像设置 1x，2x，3x 的图标一样。

Assets.xcassets => 右击 New Color Set 。

使用一：

在 xib 中，

使用二：

在代码中：

// iOS11+
[UIColor colorNamed:@"customGreen"];

通过代码自定义颜色

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

iOS13 提供了的新方法，可以在 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是一个巨大的矢量图标库，可供开发人员在自己的App中使用。

在 xib 中：

使用系统提供的图标 + tintColor（动态颜色）。

在代码中：

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

自定义设置图片

方式一：

使用：

iOS 13 以下的系统会默认取Any状态下的设定，iOS 13 会根据系统模式取Any或 Dark下的设定。

方式二：

如果你只有一套 icon，那么你可以将 icon 的渲染模式选为

在 xib 中：通过 tintColor（动态颜色）控制图标颜色的变化。

系统变动

系统还有一些因暗黑模式的引入而产生的一些改变。那些有着明确颜色效果的类型逐渐被替代和抛弃，例如模糊效果、加载指示器、状态栏等。

模糊效果

不要使用那些具有明确模糊效果的样式，使用新出的具有动态变化的样式。如：UIBlurEffectStyleSystemThinMaterialLight。

指示器

系统的加载指示器 iOS13之前有三种样式，在iOS13之后，请用下述的两种样式进行替换。

typedef NS_ENUM(NSInteger, UIActivityIndicatorViewStyle) {
    UIActivityIndicatorViewStyleMedium  API_AVAILABLE(ios(13.0), tvos(13.0)) = 100,
    UIActivityIndicatorViewStyleLarge   API_AVAILABLE(ios(13.0), tvos(13.0)) = 101,
};

状态栏

状态栏的样式在iOS13 系统下做了兼容，默认的设置下，会自动根据系统的模式进行更换。而带有明确颜色倾向的 UIStatusBarStyleLightContent，建议在暗黑模式下使用，并且新出了一个 UIStatusBarStyleDarkContent 与之对应。

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

启动图

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

在线调试

方式一：

可以在模拟器 设置 => 开发者，页面中打开暗黑模式。

方式二：

如果你使用 xib，可以直接切换模式来预览多种模式下的效果了。

参考地址

• iOS 13 DarkMode 暗黑模式。