程序与视图生命周期

1先分清两层（别混）

iOS 里日常说的「生命周期」其实是两套：程序/场景级管前后台；视图级管某一屏出现与消失。混用会导致「回前台请求挂在错误地方」。

2程序生命周期总流程

冷启动 → 前台交互 →（可多次）进后台再回前台 → 最终被系统回收。SwiftUI 里你主要观察 ScenePhase；底层仍是 UIKit 的 Scene/App 在驱动。

3关键 API：ScenePhase（SwiftUI）

@Environment(\.scenePhase) 是现代 SwiftUI App 观察前后台的主入口。三个值，调用时机如下。

import SwiftUI

@main
struct MyApp: App {
  @Environment(\.scenePhase) private var scenePhase

  var body: some Scene {
    WindowGroup {
      ContentView()
    }
    .onChange(of: scenePhase) { oldPhase, newPhase in
      print("scenePhase: \(oldPhase) → \(newPhase)")
      switch newPhase {
      case .active:
        // 回前台：可静默刷新未读数
        break
      case .inactive:
        // 过渡态：短暂停动画
        break
      case .background:
        // 进后台：立即落盘
        TodoStore.shared.save()
      @unknown default:
        break
      }
    }
  }
}

4程序侧：典型调用顺序

5对照 HarmonyOS：UIAbility

你会的 Stage 模型里，程序级几乎全在 UIAbility。和 iOS scenePhase 不是一一改名，但职责同构。

@main
struct MyApp: App {
  @Environment(\.scenePhase) private var phase
  var body: some Scene {
    WindowGroup { ContentView() }
      .onChange(of: phase) { _, p in
        if p == .background { save() }
        if p == .active { refresh() }
      }
  }
}

export default class EntryAbility extends UIAbility {
  onCreate(want, launchParam) { /* 初始化一次 */ }
  onWindowStageCreate(windowStage) {
    windowStage.loadContent('pages/Index')
  }
  onForeground() { /* ≈ active */ }
  onBackground() { /* ≈ background */ }
  onDestroy() { /* 释放 */ }
}

6视图生命周期：关键方法

SwiftUI 没有 UIKit 那么多 viewWillAppear 回调；日常就这几只「钩子」。理解时机比背名字重要。

struct DetailView: View {
  let itemId: String
  @State private var title = "加载中…"

  var body: some View {
    Text(title)
      .onAppear { print("appear \(itemId)") }
      .onDisappear { print("disappear \(itemId)") }
      .task(id: itemId) {
        // itemId 变了会取消上一次 fetch
        title = await api.fetchTitle(itemId)
      }
  }
}

7视图生命周期流程图与调用顺序

父子同屏时：大体是父先 appear，再子 appear；消失时常见子先 disappear，再父（以实际 print 为准，导航动画可能导致额外次数）。

8对照 HarmonyOS：组件 / 页面钩子

struct ListPage: View {
  @State private var items: [Item] = []
  var body: some View {
    List(items) { Text($0.name) }
      .task { items = await api.list() }
      .onDisappear { /* 可选清理 */ }
  }
}

@ComponentV2
struct ListPage {
  @Local items: Item[] = []
  aboutToAppear(): void {
    this.load() // 禁止在 build() 里打网络
  }
  aboutToDisappear(): void {
    // 取消监听；勿乱改 @Param 链路状态
  }
  async load() {
    this.items = await api.list()
  }
  build() {
    List() { ForEach(this.items, (it: Item) => {
      ListItem() { Text(it.name) }
    }, (it: Item) => it.id) }
  }
}

9什么逻辑放哪一层

10补充：UIKit 视图控制器（知道即可）

纯 SwiftUI 项目很少手写；但调试、混排、看崩溃栈时会撞到。和鸿蒙「页面钩子」更像这一层。

11真实坑

12一张速查表收工