Swift MainActor 在 UIKit 中的使用姿势

2023-09-03 06:08:18

理解 MainActor

MainActor 是 Swift Concurrency 提供的一项功能，旨在简化主线程上的操作。通过使用 @mainActor 标记的函数或属性，开发人员可以确保这些元素只能在应用程序的主线上执行，这有助于避免跨线程访问 UI 元素可能引发的问题。

为什么需要 MainActor？

在 UIKit 环境中，所有与用户界面相关的操作必须在主线程上执行。这是因为 UI 更新会涉及大量的状态共享和同步需求，这些需求通常由系统自动处理以确保界面的一致性和响应性。错误地尝试从后台线程更新 UI 可能导致应用程序崩溃或显示异常。

主要问题及解决方案

1. 在背景任务完成后更新 UI

当从后台线程返回数据到主界面上时，需要使用 MainActor 确保操作安全执行在主线程上。这可以通过直接将函数标记为 @mainActor 来实现。

代码示例:

import SwiftUI

@MainActor func updateUIWithBackgroundData() {
    // 模拟异步任务完成
    DispatchQueue.global().asyncAfter(deadline: .now() + 2) {
        let data = fetchSomeDataInBackground()
        
        // 使用 MainActor 来确保在主线程上更新 UI
        Task.detached(priority: .userInitiated) {
            await updateUIWith(data)
        }
    }
}

func fetchSomeDataInBackground() -> String {
    return "Data fetched from background"
}

@MainActor func updateUIWith(_ data: String) {
    // 更新 UI 的代码，例如设置 label.text
}

安全建议： 确保所有与 UI 相关的更新都通过 Task.detached 包装在 @mainActor 中执行。这样可以避免潜在的线程冲突。

2. 在异步函数中使用 MainActor

当处理包含异步任务的方法时，标记这些方法为 @MainActor 可以确保所有内部更新 UI 的代码块都在主线程上运行。

代码示例:

import SwiftUI

struct ContentView: View {
    @State private var text = "Loading..."
    
    var body: some View {
        Text(text)
            .onAppear(perform: loadDataAsync)
    }
    
    @MainActor func loadDataAsync() async {
        // 模拟异步加载过程
        let result = await fetchTextFromServer()
        
        // 更新 UI 时确保在主线程上执行
        text = result
    }
    
    func fetchTextFromServer() async -> String {
        try? await Task.sleep(nanoseconds: NSEC_PER_SEC)
        return "Data loaded from server"
    }
}