开发者应该知道的 UIKit 新变化

WWDC 23 大家的目光都被 visionOS 吸引了，作为 UIKit 开发者关注一下目前今年的 What’s New in UIKit session 实为必要。~~尽管今年更新的内容似乎并没有那么吸引人。~~

笔者参照官方给出的代码片段复现了一些简单页面实现，并且将代码整合到仓库WhatsNewInUIKit，希望可以帮助你更快上手和理解这些新特性。笔者还按照业务理解和适配进度的优先级，对 session 内容进行了重新排序和整理。

总的来说，今年的更新主要包括以下几个方面：

开发体验
通用组件
国际化
iPadOS 适配

? 2022年笔者在云音乐组内和博客分享了 WWDC22 UIKit 新功能，有兴趣可以先回顾一下这篇文章，这个系列会一直保持更新。

开发体验

预览

新版本的 Xcode 中新增了 #Preview()这个宏，终于，在用户界面开发上 UIKit 也能够获得和 SwiftUI 一样的预览体验了。

CleanShot 2023-07-17 at 14.27.18

开发者可以自定义预览的视图的名称，下面的 Demo 中使用了 #Preview()并指定预览的名称为 NumberVC。

class NumberViewController: UIViewController {
    // ...
}


#Preview("NumberVC") {
    let controller = NumberViewController()
    return controller
}

除了快速预览 UIViewController ，开发者还可以在面板快速预览UIView及其子类。实际体验下来这项功能还是非常实用的，可以在一个面板上以集合的形式显示查看不同机型上的显示效果。

CleanShot 2023-07-17 at 14.32.49

开发者可以在一个代码文件下创建多个#Preview()宏，所有预览将展示在 Preview 页面的顶部很方便切换。这个宏的定义长得像这样，需要注意的是这个宏仅在新版本的 Xcode 和系统上生效。

@available(iOS 17.0, macOS 14.0, tvOS 17.0, *)
@freestanding(declaration) public macro Preview(_ name: String? = nil, traits: PreviewTrait<Preview.ViewTraits>..., body: @escaping () -> UIViewController) = #externalMacro(module: "PreviewsMacros", type: "Common")

至于 Preview 实现的原理可以移步这篇文章查看。

`viewIsAppearing`

viewIsAppearing的触发时机可以让开发者更方便的对用户界面刷新进行操作，关于这个生命周期你需要知道的有以下几点：

向前兼容到 iOS 13，不少应用的最低 target 在今年都有机会升级到这个版本
viewIsAppearing只会触发一次，不会像layoutSubviews那样被多次调用
时机介于viewWillAppear与viewDidAppear之间，在view transition 之前
viewWillAppear与viewDidAppear适用于不依赖视图的结对调用，例如注册数据库通知以及销毁注册

SF Symbols 动画

之前听《Anyway.FM》播客主播有提到 SF Symbols 可能是 Apple 在设计界做出的最大贡献，今年的 SF Symbols 5 带来了通用动画这一重要更新，对独立开发来说又是一大利好。

动画的形式可以大体分为两种，一种是单次动画，一种是持续动画，效果也提供了多种选择。

// 单次 Bounce 动画
imageView.addSymbolEffect(.bounce)

CleanShot 2023-07-17 at 14.42.45

// 单次 Pulse 动画
imageView.addSymbolEffect(.pulse)

CleanShot 2023-07-17 at 14.45.17

// 单次缩放动画
imageView.addSymbolEffect(.scale)

CleanShot 2023-07-17 at 14.46.33

// 持续可变渐变动画
imageView.addSymbolEffect(.variableColor.iterative)
imageView.removeSymbolEffect(ofType:.variableColor)

CleanShot 2023-07-17 at 14.47.53

// 符号切换动画
imageView.setSymbolImage(UIImage(systemName: "swift")!, contentTransition: .replace.offUp)

CleanShot 2023-07-17 at 14.50.55

SF Symbols 为跨 UI 框架提供了统一 API，为自定义符号提供了复合层注解。如果你对新增的功能感兴趣可以观看这个session，上述的几种动画用例代码都可以WhatsNewInUIKit中找到。

Trait System

如果你没有接触过全局样式开发，可能会对 Trait 这套框架感到陌生。

UITraitCollection 包含许多系统特征，例如用户界面样式（切换日间/夜间主题）、水平和垂直尺寸（横屏/竖屏布局）等等。

CleanShot 2023-07-17 at 15.01.16

根据Unleash the UIKit trait system的说法，有两点需要开发者注意:

View controllers 从其 view 的 superview 继承trait collection，而不是直接从其parent view controller继承。
如果在 view 添加到 hierarchy 之前访问 view controller 的 trait collection，那么 view controller 将获取不到最新的traits，导致viewWillAppear 受到影响（需要适配 viewIsAppearing）。

除此之外，session还提及了以下几点更新:

开发者允许编写自定义的 traits，并且采用了更灵活的 API。
采用注册的方式处理 traits，在 traits 发生更改时接收回调而不需要在子类中重写 traitCollectionDidChange（事实上已经被traitCollectionDidChange被标记为废弃）。以下列举了两种注册方式。
允许将自定义 UIKit traits 与自定义 SwiftUI environment keys 相桥接，允许应用在 UIKit 和 SwiftUI 组件之间双向无缝传递 traits。

通用组件增强

UIPageControlTimerProgress

UIPageControlTimerProgress 有一个内置计时器可以轻松配置每个页面的持续展示时间，当定时器到达指定时间时 UIPageControl 将自动滚动页面。

对于需要跟随视频播放器或外部计时器的页面，需要使用 UIPageControlProgress 随着内容进度手动更新 currentProgress。

CleanShot 2023-07-17 at 15.29.28

需要注意的是，用户需要在点击UIPageControl之后才能激活倒计时进度条。，WhatsNewInUIKit 包含了以下 Demo 可以方便快速上手这个新特性。

CleanShot 2023-07-17 at 15.25.57

UIContentUnavailableConfiguration

在业务开发过程中，针对无网络状态、搜索不命中状态、无内容状态都应该展示空态视图。在内容构成上该视图通常会包含一个一级文本、一个二级文本以及一个图片。自定义实现上有不同的方法，例如画一个视图然后添加自定义分类。

CleanShot 2023-07-17 at 15.58.23

新增的UIContentUnavailableConfiguration使用方法很容易理解，UIViewController 的拓展中包含了一个contentUnavailableConfiguration属性，更新 viewController 最佳方法是重写updateContentUnavailableConfiguration(using: state)。

在 SwiftUI 中使用这个特性也很简单，使用UIHostingConfiguration 能完成空状态视图。
CleanShot 2023-07-17 at 15.57.15

例如在搜索场景中，可以使用如下代码在没有结果匹配的情况下展示空态界面。

    // Represent no search results empty state
    override func updateContentUnavailableConfiguration(using state: UIContentUnavailableConfigurationState) {
        var config: UIContentUnavailableConfiguration?
        if searchResults.isEmpty {
            config = .search()
        }
        contentUnavailableConfiguration = config
    }

    // Update search results for query
    searchResults = backingStore.results(for: query)
    setNeedsUpdateContentUnavailableConfiguration()

默认提供了UIContentUnavailableConfiguration.empty()、UIContentUnavailableConfiguration.loading()、UIContentUnavailableConfiguration.search()这几种实现，可以自定义的属性包含以下多项，通过苹果提供的空态 API，开发者也可以审视自己之前实现类似需求时考虑是否周全。

    public var image: UIImage?

    public var imageProperties: UIContentUnavailableConfiguration.ImageProperties


    public var text: String?

    public var attributedText: NSAttributedString?

    public var textProperties: UIContentUnavailableConfiguration.TextProperties

    public var secondaryText: String?

    public var secondaryAttributedText: NSAttributedString?

    public var secondaryTextProperties: UIContentUnavailableConfiguration.TextProperties

    public var button: UIButton.Configuration

    public var buttonProperties: UIContentUnavailableConfiguration.ButtonProperties

    public var secondaryButton: UIButton.Configuration

    public var secondaryButtonProperties: UIContentUnavailableConfiguration.ButtonProperties

    public var alignment: UIContentUnavailableConfiguration.Alignment

    public var axesPreservingSuperviewLayoutMargins: UIAxis

    public var directionalLayoutMargins: NSDirectionalEdgeInsets

    public var imageToTextPadding: CGFloat

    public var textToSecondaryTextPadding: CGFloat

    public var textToButtonPadding: CGFloat

    public var buttonToSecondaryButtonPadding: CGFloat

    public var background: UIBackgroundConfiguration