onResume — 기본, Android에서 사용자 상호작용

Android에서 onResume 메서드의 기본

onResume — Activity 수명 주기의 세 번째 메서드로, onStart 후에 호출되며 화면이 사용자와의 완전한 상호작용을 위해 준비되었음을 알립니다. 이 순간 Activity는 백 스택의 최상위에 있으며, 시스템은 모든 입력 이벤트를 Activity로 전달하고, 애플리케이션은 사용자의 적극적인 참여가 필요한 모든 작업(화상 통화, 게임, 오디오 녹음, Canvas 그리기)을 시작할 수 있습니다.

onResume은 “포그라운드 수명”(foreground lifetime)의 일부입니다 — onResume과 onPause 사이의 간격입니다. 이것은 Activity의 가장 활동적인 기간으로, 애플리케이션이 가장 많은 리소스를 소비합니다: 터치 처리를 위한 CPU, 애니메이션 렌더링을 위한 GPU, 비디오 캡처를 위한 카메라와 마이크. 수명 주기의 이 수준을 이해하는 것은 에너지 소비 최적화에 중요합니다 — onResume에서 열린 리소스는 onPause에서 즉시 닫아야 합니다.

Google I/O 2025에 따르면, Activity가 세션당 onResume 상태에서 보내는 평균 시간은 뉴스 애플리케이션의 경우 2~5분, 게임 및 메신저의 경우 15~30분입니다. 나머지 시간 동안 Activity는 onPause, onStop 또는 onDestroy 상태에 있습니다. 이는 특히 onResume 코드를 최적화하는 것이 성능과 배터리 수명에 가장 큰 이점을 제공한다는 것을 의미합니다.

Activity에서의 onResume

Activity에서 onResume 메서드는 화면이 입력 포커스를 받을 때마다 호출됩니다 — 첫 번째 실행 시, 다른 Activity에서 돌아올 때, 대화상자를 닫을 때, 장치 잠금을 해제할 때. 이것은 세션 중에 여러 번 호출될 수 있는 “핫” 메서드이며, 구현은 가능한 한 가벼워야 합니다.

class CameraActivity : AppCompatActivity() {
    private var cameraProvider: ProcessCameraProvider? = null
    private var preview: Preview? = null

    override fun onResume() {
        super.onResume()
        val cameraProviderFuture = ProcessCameraProvider.getInstance(this)
        cameraProviderFuture.addListener({
            cameraProvider = cameraProviderFuture.get()
            val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
            preview = Preview.Builder().build().also {
                it.setSurfaceProvider(binding?.viewFinder?.surfaceProvider)
            }
            try {
                cameraProvider?.unbindAll()
                cameraProvider?.bindToLifecycle(
                    this, cameraSelector, preview
                )
            } catch (e: Exception) {
                Log.e("Camera", "Failed to bind camera", e)
            }
        }, ContextCompact.getMainExecutor(this))
    }

    override fun onPause() {
        super.onPause()
        cameraProvider?.unbindAll()
        preview = null
    }
}

CameraX 예제는 onResume/onPause의 고전적인 사용을 보여줍니다: 카메라는 한 번에 하나의 애플리케이션만 사용할 수 있는 독점 리소스입니다. bindToLifecycle을 통해 카메라를 수명 주기에 바인딩하면 onPause에서 카메라가 자동으로 닫히지만, 명시적인 unbindAll 호출은 즉각적인 해제를 보장합니다. 이는 Activity 간 전환 시 특히 중요합니다: 다른 Activity가 열기를 시도하기 전에 카메라를 해제해야 합니다.

Fragment에서의 onResume

Fragment의 onResume은 해당 Fragment를 포함하는 Activity가 onResume을 받은 후에 호출됩니다. 그러나 FragmentManager와 ViewPager의 특성으로 인해 Fragment의 onResume 호출 시점은 Activity에 비해 지연될 수 있습니다. 예를 들어, offscreenPageLimit = 1인 ViewPager의 Fragment는 Activity 시작 시가 아니라 현재 페이지가 될 때만 onResume을 받습니다.

class VideoPlayerFragment : Fragment() {
    private var exoPlayer: ExoPlayer? = null

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        exoPlayer = ExoPlayer.Builder(requireContext()).build()
        binding?.playerView?.player = exoPlayer
    }

    override fun onResume() {
        super.onResume()
        exoPlayer?.play()
        if (userVisibleHint) {
            startBiometricAuth()
        }
    }

    override fun onPause() {
        exoPlayer?.pause()
        stopBiometricAuth()
        super.onPause()
    }
}

Fragment.onResume의 userVisibleHint 검사는 ViewPager와 관련이 있습니다: Fragment가 onResume을 받을 수 있지만 인접한 페이지에 의해 숨겨져 있을 수 있습니다(예: 애니메이션 전환 중). 이러한 경우 가시성 확인 없이 onResume에서 비디오나 생체 인식을 시작하면 예기치 않은 동작이 발생합니다. Fragment 1.5.0부터는 ViewPager2에서 프래그먼트 수명 주기를 정밀하게 제어하기 위해 FragmentTransaction.setMaxLifecycle()을 사용하는 것이 좋습니다.

onResume vs onStart: 각각 사용해야 할 때

개발자들은 종종 onStart와 onResume을 혼동하여 잘못된 메서드에 코드를 배치합니다. 주요 규칙: onStart — 가시성 동안 작동하는 리소스용; onResume — 입력 포커스가 필요한 리소스용. 구체적인 시나리오와 올바른 메서드 선택을 살펴보겠습니다.

실용적인 규칙: 대화상자가 나타날 때 작업이 중단되어야 하는 경우 — onResume/onPause를 사용합니다. 화면이 부분적으로 가려져도 작업을 계속할 수 있는 경우 — onStart/onStop을 사용합니다. 예를 들어, 비디오 플레이어는 대화상자가 열리면 비디오를 일시 중지해야 하고(onPause), 위치 정보는 업데이트를 계속할 수 있습니다(onStart 유지).

독점 리소스 관리

독점 리소스는 특정 시점에 하나의 애플리케이션만 사용할 수 있는 장치 구성 요소입니다. 카메라, 마이크, 비디오 출력(MediaProjection), 읽기 모드의 NFC 어댑터, 액세서리 모드의 USB 장치 — 이러한 모든 리소스는 onResume에서 열고 onPause에서 해제해야 합니다.

MediaRecorder 작업

MediaRecorder는 오디오 및 비디오 녹음에 사용됩니다. 권한 요청 및 MediaRecorder 준비는 onCreate에서 수행되고, 녹음은 onResume에서 시작됩니다. 사용자가 다른 애플리케이션으로 전환하면 onPause가 녹음을 일시 중지하고 onResume이 재개합니다. 이것은 음성 녹음기 및 비디오 녹화 애플리케이션의 표준 동작입니다.

private var mediaRecorder: MediaRecorder? = null
private var isRecording = false

override fun onResume() {
    super.onResume()
    if (isRecording) {
        mediaRecorder?.resume()
    }
}

override fun onPause() {
    if (isRecording) {
        mediaRecorder?.pause()
    }
    super.onPause()
}

BiometricPrompt와 onResume

생체 인증(BiometricPrompt)은 Activity가 onResume 상태에 있을 때만 호출해야 합니다. onCreate나 onStart에서 호출하면 Activity 초기화가 완료되기 전에 생체 인증 대화상자가 나타나 결과 처리가 잘못될 수 있습니다. onResume에서 호출하면 생체 인증 창이 올바른 컨텍스트에 표시됩니다.

패턴 및 권장 사항

상용 프로젝트에서 사용되는 onResume 작업의 세 가지 검증된 패턴을 살펴보겠습니다: 비활성 타이머 재설정, 표시 데이터 업데이트, Jetpack Navigation 통합.

비활성 타이머 재설정

민감한 데이터(은행, 의료 기록)가 있는 애플리케이션에서 onResume은 자동 로그아웃 타이머를 재설정하는 데 사용됩니다. 사용자가 애플리케이션과 적극적으로 상호작용하는 경우 화면 전환 시마다 onResume이 호출되고 타이머가 재설정됩니다. 사용자가 애플리케이션을 최소화하면 onPause가 타이머를 중지하고, 돌아올 때 onResume이 타이머를 재설정하거나 재인증을 요청합니다.

돌아올 때 데이터 업데이트

화면으로 돌아올 때마다 최신 데이터를 표시해야 하는 목록은 onResume에서 업데이트됩니다. 예를 들어, 사용자가 다른 Activity에서 새 항목을 만들고 뒤로 이동하면 onResume이 로컬 데이터베이스 또는 ViewModel 캐시에서 목록을 다시 로드합니다. 이렇게 하면 수동 notifyDataSetChanged 호출 없이 데이터 일관성이 보장됩니다.

override fun onResume() {
    super.onResume()
    // ActivityResultLauncher가 결과를 반환했습니다 — 목록 업데이트 중
    viewModel.refreshList()
    // 비활성 타이머 재설정
    inactivityTimer.reset()
}

Jetpack Navigation과 onResume

Jetpack Navigation에서 프래그먼트의 onResume은 뒤로 가기 탐색을 통해 프래그먼트로 돌아올 때마다 호출됩니다. 이 속성은 UI 상태를 재설정하는 데 사용됩니다: 키보드 숨기기, 검색 필드 지우기, 툴바 제목 업데이트. OnBackPressedCallback을 onResume과 결합하면 코드 중복 없이 탐색을 완전히 제어할 수 있습니다.