核心代碼 (Java/Kotlin 通用)
// Java
Intent intent = getPackageManager()
.getLaunchIntentForPackage(getPackageName());
if (intent != null) {
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);
// 可選:殺掉當前進程徹底重啟
// android.os.Process.killProcess(android.os.Process.myPid());
// System.exit(0);
}
// Kotlin 擴充函數
fun Context.restartApp() {
packageManager.getLaunchIntentForPackage(packageName)?.apply {
addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK)
startActivity(this)
}
// 如需徹底進程重啟 (慎用)
// android.os.Process.killProcess(android.os.Process.myPid())
// System.exit(0)
}
關鍵 Flag 解析
| Flag | 作用 |
FLAG_ACTIVITY_CLEAR_TOP | 若目標 Activity 已在任務棧中,清除其上方所有 Activity,重用該實例 (觸發 onNewIntent) |
FLAG_ACTIVITY_NEW_TASK | 在新任務棧啟動 (非 Activity 上下文調用 startActivity 必加) |
FLAG_ACTIVITY_CLEAR_TASK | API 11+,清空目標任務棧所有 Activity (配合 NEW_TASK 實現完全重置) |
進階:徹底進程重啟 (保證靜態變量、單例重置)
public static void restartProcess(Context context) {
Intent intent = context.getPackageManager()
.getLaunchIntentForPackage(context.getPackageName());
if (intent != null) {
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
// 使用 PendingIntent 延遲執行,避免當前進程立即死亡導致啟動失敗
PendingIntent pending = PendingIntent.getActivity(
context, 0, intent, PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE);
AlarmManager am = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
am.set(AlarmManager.RTC, System.currentTimeMillis() + 100, pending); // 100ms 後啟動
// 立即殺死當前進程
android.os.Process.killProcess(android.os.Process.myPid());
System.exit(0);
}
}
⚠️ **慎用**:會導致 Application.onCreate() 重新執行、所有靜態變量重置、Service 重啟,可能引發副作用 (如正在上傳的文件中斷)。
現代架構下的替代方案
- 配置變更重建:
recreate() (Activity) — 僅重建 Activity,保留進程。
- ViewModel + SavedStateHandle:配置變更/進程重建自動保存 UI 狀態。
- WorkManager:需保證執行的後台任務,系統會在進程重啟後自動恢復。
- Jetpack AppStartup:初始化邏輯組件化,避免依賴進程重啟重置。
適用場景對比
| 場景 | 推薦方式 |
| 切換語言/主題需全局生效 | recreate() 主 Activity + attachBaseContext 更新語系 |
| 嚴重錯誤需徹底重置 (如 Native Crash 後) | Process.killProcess() + System.exit() + PendingIntent 延遲拉起 |
| 用戶主動「重新登入」/「切換帳號」 | 清理數據 → startActivity(launchIntent) + finishAffinity() |
| 修改系統級設置 (需重啟生效) | 引導用戶手動重啟 App (彈窗提示) |