1.3 SwiftUI 中常见的异步 API

.task

SwiftUI 刚发布时,View 只有两个最基础的生命周期方法:.onAppear 和 .onDisAppear,iOS 14 又新增了 .onChange 这样的修饰器,可以监听值的变化。不过上面的几个 API 都是在主线程调用的,iOS 15 新增的 .task 修饰器赋予了 View 快速开启异步任务的能力。

在上一节的示例中,我们已经使用过这个 API 了:

1
2
3
.task {
  img = await fetchImage()
}

.task 的会在 View 出现时调用,并立即开启一个异步任务,闭包内的代码就处于这个新开启的异步环境中。当 View 被释放时,如果任务还未结束,系统会自动取消该任务。

.task 方法全名如下:

1
func task(priority: TaskPriority = .userInitiated, _ action: @escaping () async -> Void) -> some View

默认情况下,task 任务以最高的可用优先级运行,这取决于系统的调度,你也可以自定义任务的优先级(TaskPriority)。

此外,还有另一个 .task API :

1
func task<T>(id value: T, priority: TaskPriority = .userInitiated, _ action: @escaping () async -> Void) -> some View where T : Equatable

它是上一个 API 的加强版,多了一个 id 参数,当我们使用这个 API 开启异步任务时,系统会监听 id 的值变化,一旦 id 发生了变化,原来的任务会被取消,系统会开启一个新的任务。

比如我们常见的筛选菜单,是通过多个控制参数去拉取服务端的数据的,一旦其中一个参数发生变化,App 就会发起新的网络请求然后刷新界面。在弱网环境下,如果 App 没有处理好菜单切换时网络请求的取消,就容易会造成数据的错乱。为了处理好这种边界条件,我们需要管理好网络请求的生命周期。而现在使用 task(id:priority:_:) 可以非常方便地处理类似的问题,我们只需要新增一个遵循 Equatable 协议的 id 参数就行了。

.refreshable

.refreshable 是 iOS 15 新增的 modifier,可以给 View 快速添加刷新控件。比如下面的示例代码,当我们使用下拉刷新时,会先去拉取三条随机的柴犬图片地址,然后使用 AsyncImage 去加载相应的图片。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
struct ShibeView: View {
  
  @ObservedObject private var shibeVM = ShibeViewModel()
  
  var body: some View {
    List {
      ForEach(shibeVM.shibes, id: \.self) {
        AsyncImage(url: .init(string: $0)) { image in
          HStack {
            Spacer()
            image
              .resizable()
              .aspectRatio(contentMode: .fill)
              .cornerRadius(20)
            Spacer()
          }
        } placeholder: {
          ProgressView()
        }
      }
    }
    .listStyle(.plain)
    .refreshable {
      await shibeVM.fetchRandomShibes()
    }
    .task {
      await shibeVM.fetchRandomShibes()
    }
  }
}

@MainActor class ShibeViewModel: ObservableObject {
  @Published var shibes: [String] = []
  
  private let url = URL(string: "https://shibe.online/api/shibes?count=3")!
  
  func fetchRandomShibes() async {
    let res = try? await URLSession.shared.data(from: url)
    if let data = res?.0, let model = try? JSONDecoder().decode([String].self, from: data) {
      shibes = model
    }
  }
}

我们使用了 MainActor 修饰了 ShibeViewModel 类,它可以确保该类的属性和方法在主线程调用。因为这里使用 await 标记的 URLSession 方法是在子线程运行的,加载完数据后将其赋值给 shibes 会导致 UI 的刷新工作不在主线程,这是不可取的 。关于 actor,后面还会有详细的介绍,这里不必多作停留。

在之前使用 Callback 范式编写代码时,我们通常使用 DispatchQuene.main.async 来切回至主线程,而且还要使用 weak 来解决循环引用的问题,这样的处理既麻烦且易遗漏。现在我们使用 MainActor 可以轻松解决这个问题,值得注意的是,MainActor 对 Callback 并不生效,我们必须使用新的 Concurrency 才能享受它带来的便捷和安全。

如果你留意过苹果最新的文档,你会发现 UI 类控件,比如 UIView、UIViewController 等,现在都使用了 MainActor 修饰,这是为了确保 UI 在主线程更新。

其它

URLSession、AsyncImage 等,前面的章节已经介绍过了,不再赘述。