Huny's Dev Blog
huny.dev

기존 Android XML 화면에 Compose 한 조각만 넣는 법: ComposeView와 상태 복원

기존 Fragment와 XML을 유지한 채 ComposeView를 추가하고, 뷰 생명주기와 UI 상태 복원을 검증하는 방법을 설명한다.

Hun Jang
Hun Jang Nov 22, 2026

기존 화면을 유지한 채 UI 조각 하나를 교체하는 모습을 표현한 AI 생성 개념 이미지. 실제 앱 화면은 아니다.

오래된 Android 앱에 Jetpack Compose를 도입한다고 XML 화면을 전부 다시 만들 필요는 없다. 기존 Fragment와 XML을 두고, 바꾸고 싶은 영역에 ComposeView를 넣으면 된다. 첫 이관은 설정 화면의 옵션처럼 작고 독립적인 영역이 좋다. 핵심은 Compose를 화면에 그리는 것보다 Fragment의 뷰가 사라지는 시점과 상태가 남아야 하는 범위를 분리하는 것이다.

기존 화면이 Compose의 호스트가 된다

ComposeView는 XML 레이아웃에 배치할 수 있는 Android View다. 기존 헤더, 자바나 Kotlin으로 작성한 로직, Fragment 내비게이션을 그대로 둔 채 내부 영역만 Compose에 맡길 수 있다. 반대로 Compose 화면에 대체하기 어려운 기존 View를 넣어야 한다면 AndroidView가 맞다. 두 API의 이름이 비슷하지만, 어느 쪽이 바깥에 있는지가 다르다. View 안의 Compose · Compose 안의 View

아래 예시는 Compose 빌드 구성이 적용된 앱에서, 기존 fragment_settings.xml의 LinearLayout 안에 추가할 요소다. 같은 레이아웃에 여러 ComposeView를 두면 각각 고유 ID를 준다. 저장 상태를 복원할 때 서로 구분할 수 있어야 하기 때문이다.

Fragment는 실제 뷰가 준비된 onViewCreated()에서 내용을 넣는다. Android 공식 문서는 Fragment의 뷰에 넣는 ComposeView에 DisposeOnViewTreeLifecycleDestroyed를 제안한다. Fragment 인스턴스가 백스택에 남더라도 뷰만 먼저 파괴될 수 있기 때문에, Composition이 그 뷰의 수명에 맞춰 정리되도록 한 것이다.

예시는 Material 3 의존성이 이미 있는 앱을 가정한다. 실제 프로젝트에서는 기본 MaterialTheme 대신 앱의 테마를 연결한다. 위 코드는 공식 API에 따라 작성한 통합 예시이며, 별도 Android 앱으로 빌드하거나 기기에서 실행한 결과는 아니다.

펼침 상태와 저장된 설정은 다르다

여기서 expanded는 화면 안에서만 쓰는 작은 값이라 rememberSaveable로 충분하다. 안드로이드의 저장 상태가 복원되는 경우 화면 회전이나 시스템에 의한 재생성 뒤에도 값을 복원할 수 있다. remember만 사용하면 재구성 사이에는 남지만 Composition이 새로 만들어질 때까지 보장되지는 않는다.

반면 적용된 알림 필터처럼 화면 로직이나 앱의 동작에 영향을 주는 값은 UI 내부 변수에 복제하지 않는다. 기존 상태 소유자가 값을 내려주고 Compose에서는 변경 이벤트를 돌려주는 구조가 낫다. 화면 단위 로직에는 ViewModel을 쓸 수 있지만, ViewModel만으로 시스템의 프로세스 종료 뒤까지 데이터가 보존되지는 않는다. 복구에 필요한 최소 UI 상태는 SavedStateHandle을, 앱 재실행 후에도 유지해야 하는 실제 설정은 DataStore 같은 영속 저장소를 고려한다. UI 상태 저장 · 상태를 어디에 둘지 결정하기 · DataStore

첫 화면에서 확인할 네 가지

  1. 상세 영역을 펼친 뒤 기기 방향을 바꿔, 복원되어야 할 임시 상태가 유지되는지 본다.
  1. 다른 화면으로 이동했다가 뒤로 돌아와, 화면 정책에 맞게 상태가 복원 또는 초기화되는지 확인한다. 회전과 뒤로 가기는 같은 검증이 아니다.
  1. 폰트 크기를 키우고 TalkBack으로 읽기 순서를 확인한다. 기존 View와 새 Compose 영역이 한 화면처럼 탐색되어야 한다.
  1. 기존 View와 Compose 양쪽이 같은 설정을 보여 준다면 한쪽에서 바꿨을 때 다른 쪽에도 반영되는지 확인한다. 서로 다른 값이 보인다면 UI가 아니라 상태 소유권부터 점검한다.

화면 전체를 바꾸기 전에 이 한 조각을 안정적으로 넣어 보면, 다음 화면에서도 재사용할 경계가 생긴다. XML을 얼마나 지웠는지보다 기존 동작을 얼마나 잘 보존했는지가 첫 이관의 더 좋은 기준이다.

추천 글