onRestart — 本质，在生命周期中恢复 Activity

onRestart — Android 生命周期中方法的本质

onRestart — 回调方法，Android 在 Activity 从不可见的 Stopped 状态返回到可见状态时，严格在 onStart 之前调用。此方法的独特之处在于它仅在 Activity 重新显示时调用——在首次创建实例时，序列从 onCreate 开始，跳过 onRestart。完整周期：onCreate → onStart → onResume（首次启动）或 onRestart → onStart → onResume（重新显示）。

从 Android 系统的角度来看，onRestart 是一种优化，允许 Activity 为返回做准备：更新存储库中的数据、同步 UI 状态、检查网络连接。与每次获得焦点时（包括从对话框或系统菜单返回时）都会调用的 onResume 不同，onRestart 仅在完整的隐藏-返回周期中激活。这使 onRestart 成为「重度」更新操作的理想位置，这些操作在部分失去焦点时不需要。

根据 Android Activity 生命周期规范，onStop 和 onRestart 之间的时间间隔可以从几秒（用户快速切换）到几小时（应用程序在后台且用户返回）。在此期间，远程来源（API、数据库）中的数据可能已更改，因此 onRestart 是检查数据新鲜度的自然点。

onRestart 与 onCreate 的区别：如何选择

onRestart 和 onCreate 是恢复 Activity 的两种不同方法。两者之间的选择取决于 Activity 是完全被销毁还是仅仅被隐藏。

选择规则：View 的初始化和 LiveData/StateFlow 的订阅在 onCreate（或 Fragment 的 onViewCreated）中执行。数据更新、列表重新加载和状态检查——在 onRestart 中。如果数据通过 ViewModel 加载，onRestart 可以简单地调用 ViewModel 的 refresh() 方法，而 View 通过响应式流订阅更新后的数据。

Google 建议：不要在 onRestart 中重复 onCreate 的逻辑。在 ViewModel 中分离出加载当前数据的 refresh() 方法，并在 onRestart 中调用它们。这保持了 MVVM 架构的纯净性并消除了代码重复。

onRestart 使用场景：更新数据和 UI

onRestart — 适用于每次返回屏幕时应执行但首次打开时不需要的操作的理想位置。以下是典型场景：

• 从数据库或 API 更新列表 — 用户进入了另一个 Activity，在那里修改了数据，返回——列表必须是最新的。在 onRestart 中调用 viewModel.refreshItems()。
• 检查授权 — 如果 Activity 长时间被隐藏，访问令牌可能已过期。onRestart 是检查令牌有效性和重定向到登录屏幕的点。
• 同步 UI 状态 — 切换主题、更改语言、更新设置——更改应在返回屏幕时应用。
• 重新加载媒体 — 如果 Activity 显示可能已更改的内容（新闻提要、汇率、天气），请在 onRestart 中更新数据。
• 检查网络连接 — 从离线模式返回时，Activity 应检查网络可用性并切换 UI。
• 恢复动画 — 在 onStop 中释放的动画，在 onStart 之前在 onRestart 中重新启动。

不要在 onRestart 中做什么：不要重新初始化 View——它们存活，因为 Activity 未被销毁。不要重新订阅 LiveData——onCreate 中的订阅仍然存活。不要创建新的 Fragment——它们已在 FragmentManager 中。

onRestart 与 process death：重要例外

最重要的例外：如果应用程序进程被系统杀死，onRestart 不会被调用。这是开发者经常忽略的关键点，他们依赖 onRestart 来恢复状态。

在 process death 时：

• 应用程序在后台，Android 杀死了进程以释放内存。
• 用户返回——系统启动新进程。
• Activity 重新创建：onCreate(Bundle) → onStart → onResume。
• onRestart 不被调用——对系统而言这是一个新的 Activity 实例。

如何防范：始终在 onSaveInstanceState(Bundle) 中保存关键状态（在 onStop 之前调用）或在 ViewModel 中使用 SavedStateHandle。在 onCreate 中检查 savedInstanceState：如果不为 null，从 Bundle 恢复状态；如果为 null，加载新数据。

根据 Google Android Vitals，大约 7% 的后台长时间停留后返回 Activity 的情况发生在 process death 之后。这意味着每第 15 个本应调用 onRestart 的 Activity 实际上会经过 onCreate。忽略此场景是「返回后空白屏幕」错误的主要原因之一。

Kotlin 中 onRestart 的代码示例

示例 1：通过 ViewModel 更新列表的 onRestart

Activity 在 onRestart 中调用 viewModel.refreshTasks()，以便在从编辑屏幕返回后更新任务列表。

class TaskListActivity : AppCompatActivity() {
    private val viewModel: TaskViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_task_list)
        viewModel.tasks.observe(this) { tasks ->
            Log.d("TaskList", "收到 ${tasks.size} 个任务")
        }
    }

    override fun onRestart() {
        super.onRestart()
        Log.d("TaskList", "onRestart：更新任务列表")
        viewModel.refreshTasks()
    }
}

class TaskViewModel : ViewModel() {
    private val _tasks = MutableLiveData<List<Task>>()
    val tasks: LiveData<List<Task>> get() = _tasks

    fun refreshTasks() {
        viewModelScope.launch {
            _tasks.value = TaskRepository().getAllTasks()
        }
    }
}

ViewModel.refreshTasks() 从存储库加载最新数据。LiveData 自动通知 Activity 数据更改——UI 无需额外代码即可更新。OnRestart 不会创建新订阅——它已在 onCreate 中设置。

示例 2：带授权检查的 onRestart

Activity 在返回时检查令牌的有效性，并在必要时重定向到登录页面。

class ProfileActivity : AppCompatActivity() {
    private val authManager = AuthManager()
    private val launcher = registerForActivityResult(
        ActivityResultContracts.StartActivityForResult()
    ) { Log.d("Profile", "从登录屏幕返回") }

    override fun onRestart() {
        super.onRestart()
        if (!authManager.isTokenValid()) {
            Log.d("Profile", "令牌已过期——重定向到登录")
            launcher.launch(Intent(this, LoginActivity::class.java))
        }
    }
}

class AuthManager {
    fun isTokenValid(): Boolean {
        val expiry = SharedPreferencesManager().getTokenExpiry()
        return System.currentTimeMillis() < expiry
    }
}

如果用户长时间最小化应用程序并在令牌过期后返回，onRestart 将重定向到登录屏幕。这防止了尝试使用过期令牌执行请求时的 API 错误。注意：检查在 onRestart 中，而不是在 onResume 中，以避免在从对话框返回时进行不必要的检查。

示例 3：在 Fragment 中使用 ViewLifecycleOwner 的 onRestart

Fragment 通过 LifecycleObserver 使用 onRestart 来更新数据。

class FeedFragment : Fragment() {
    private val viewModel: FeedViewModel by viewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        viewLifecycleOwner.lifecycle.addObserver(object : LifecycleObserver {
            @OnLifecycleEvent(Lifecycle.Event.ON_RESTART)
            fun onRestart() {
                Log.d("FeedFragment", "通过 LifecycleObserver 的 onRestart")
                viewModel.refreshFeed()
            }
        })
    }
}

与在 Fragment 中重写 onRestart 不同，使用 LifecycleObserver——这是一种更灵活的方法，允许在不继承的情况下向生命周期事件添加逻辑。ViewLifecycleOwner 确保观察者在 View 范围内存活（不会超过 onDestroyView）。