onRestart — 라이프사이클에서 Activity 복원

onRestart — Android 라이프사이클에서 메서드의 본질

onRestart — Android가 onStart 직전에, Activity가 보이지 않는 Stopped 상태에서 다시 표시 상태로 돌아올 때 호출하는 콜백 메서드입니다. 이 메서드는 Activity가 다시 표시될 때만 호출된다는 점에서 독특합니다 — 인스턴스의 첫 번째 생성 시 시퀀스는 onCreate로 시작하여 onRestart를 건너뜁니다. 전체 사이클: onCreate → onStart → onResume(첫 실행) 또는 onRestart → onStart → onResume(이후 표시).

Android 시스템의 관점에서 onRestart는 Activity가 복귀를 준비할 수 있도록 하는 최적화입니다: 리포지토리에서 데이터 업데이트, UI 상태 동기화, 네트워크 연결 확인. Activity가 포커스를 얻을 때마다 호출되는 onResume(대화상자나 시스템 메뉴에서 돌아올 때도 포함)과 달리 onRestart는 완전한 숨김 및 복귀 주기 중에만 트리거됩니다. 이로 인해 onRestart는 부분적인 포커스 손실 시 필요하지 않은 “무거운” 업데이트 작업에 이상적인 장소가 됩니다.

Android Activity 라이프사이클 사양에 따르면 onStop과 onRestart 사이의 시간 간격은 몇 초(사용자가 빠르게 전환)에서 몇 시간(앱이 백그라운드에 있었고 사용자가 돌아옴)까지 될 수 있습니다. 이 시간 동안 원격 소스(API, DB)의 데이터가 변경되었을 수 있으므로 onRestart는 최신 상태 확인을 위한 자연스러운 지점입니다.

onRestart 호출 시기: 조건 및 순서

onRestart는 Activity가 Stopped 상태에서 돌아올 때만 호출됩니다. Activity는 onStop이 호출된 후 이 상태에 진입합니다. 아래는 onRestart로 이어지는 모든 시나리오입니다.

onRestart 호출 시나리오:

• 다른 Activity에서 돌아오기 — 사용자가 새 Activity를 열고(예: 알림 탭) 뒤로 이동(“뒤로” 누름)했습니다. 스택: MainActivity.onPause → MainActivity.onStop → SecondActivity 생성됨 → 사용자가 “뒤로” 누름 → SecondActivity.onPause → SecondActivity.onStop → SecondActivity.onDestroy → MainActivity.onRestart → MainActivity.onStart → MainActivity.onResume.
• 최소화에서 돌아오기 — 사용자가 앱을 최소화(홈)했다가 얼마 후 돌아왔습니다. CurrentActivity.onPause → CurrentActivity.onStop → (앱이 백그라운드에) → 사용자 돌아옴 → CurrentActivity.onRestart → CurrentActivity.onStart → CurrentActivity.onResume.
• 잠금 화면에서 돌아오기 — 잠금 화면이 Activity를 덮습니다. 잠금 해제 후 상당한 시간(5초 초과)이 경과하면 Activity가 onRestart를 받습니다.
• Intent를 통해 시작된 앱에서 돌아오기 — 카메라, 갤러리, 브라우저 — startActivityForResult() 또는 ActivityResultLauncher를 통해 시작된 타사 앱.

onRestart가 호출되지 않는 경우: 화면 회전 시(Activity가 소멸되고 onCreate를 통해 다시 생성됨), 대화상자에서 돌아올 때(Activity가 onStop에 들어가지 않음, onPause → onResume만), 프로세스 종료 시(Activity가 다시 생성됨).

onRestart vs 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는 화면으로 돌아올 때마다 수행되어야 하지만 처음 열 때는 필요하지 않은 작업에 이상적인 장소입니다. 일반적인 시나리오는 다음과 같습니다:

• DB 또는 API에서 목록 업데이트 — 사용자가 다른 Activity로 이동하여 데이터를 변경하고 돌아왔습니다 — 목록이 최신 상태여야 합니다. onRestart에서 viewModel.refreshItems()를 호출하세요.
• 권한 확인 — Activity가 오랫동안 숨겨져 있었다면 액세스 토큰이 만료되었을 수 있습니다. onRestart는 토큰 유효성을 확인하고 로그인 화면으로 리디렉션하는 지점입니다.
• UI 상태 동기화 — 테마 전환, 언어 변경, 설정 업데이트 — 화면으로 돌아올 때 변경 사항이 적용되어야 합니다.
• 미디어 다시 로드 — Activity가 변경될 수 있는 콘텐츠(뉴스 피드, 환율, 날씨)를 표시하는 경우 onRestart에서 데이터를 업데이트하세요.
• 네트워크 연결 확인 — 오프라인 모드에서 돌아올 때 Activity는 네트워크 가용성을 확인하고 UI를 전환해야 합니다.
• 애니메이션 복원 — onStop에서 해제된 애니메이션은 onStart 전에 onRestart에서 다시 시작해야 합니다.

onRestart에서 하지 말아야 할 것: View를 다시 초기화하지 마세요 — Activity가 소멸되지 않았으므로 살아 있습니다. LiveData를 다시 구독하지 마세요 — onCreate의 구독이 아직 유효합니다. 새 Fragment를 만들지 마세요 — 이미 FragmentManager에 있습니다.

onRestart와 프로세스 종료: 중요한 예외

가장 중요한 예외: 앱 프로세스가 시스템에 의해 종료된 경우 onRestart가 호출되지 않습니다. 이는 상태 복원을 onRestart에 의존할 때 개발자가 자주 놓치는 핵심 사항입니다.

프로세스 종료 시:

• 앱이 백그라운드에 있었고 Android가 메모리를 확보하기 위해 프로세스를 종료했습니다.
• 사용자가 돌아옴 — 시스템이 새 프로세스를 시작합니다.
• Activity가 다시 생성됨: onCreate(Bundle) → onStart → onResume.
• onRestart가 호출되지 않음 — 시스템에게 이것은 새 Activity 인스턴스입니다.

이를 방지하는 방법: 중요한 상태를 항상 onSaveInstanceState(Bundle)(onStop 전에 호출됨)에 저장하거나 ViewModel에서 SavedStateHandle을 사용하세요. onCreate에서 savedInstanceState를 확인하세요: null이 아니면 Bundle에서 상태를 복원하고, null이면 새 데이터를 로드하세요.

Google Android Vitals에 따르면 백그라운드에서 오랜 시간 후 Activity로 돌아오는 약 7%가 프로세스 종료 후에 발생합니다. 즉, onRestart를 호출했어야 할 Activity 15개 중 1개는 실제로 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 오류를 방지합니다. 참고: 확인은 onResume이 아닌 onRestart에 있습니다. 이는 대화상자에서 돌아올 때 불필요한 확인을 피하기 위함입니다.

예제 3: ViewLifecycleOwner를 사용한 Fragment의 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는 observer가 View 범위 내에서 유지되도록 보장합니다(onDestroyView를 초과하여 지속되지 않음).