navigation3

  
Navigation 3는 Compose와 함께 작동하도록 설계된 새로운 탐색 라이브러리입니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 11월 4일 1.2.1 - - 1.3.0-alpha04

종속 항목 선언

navigation3의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha04")
    implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha04")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.3

버전 1.3.0-alpha04

2026년 11월 4일

androidx.navigation3:navigation3-*:1.3.0-alpha04이 출시되었습니다. 버전 1.3.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 공유된 NavEntry가 팝된 후 팝이 완료되기 전에 다시 푸시될 때 화면에 렌더링되지 않는 문제가 해결되었습니다. (I6a482)

버전 1.3.0-alpha03

2026년 10월 21일

androidx.navigation3:navigation3-*:1.3.0-alpha03이 출시되었습니다. 버전 1.3.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

1.3.0-alpha02에서 변경사항 없음

버전 1.3.0-alpha02

2026년 10월 7일

androidx.navigation3:navigation3-*:1.3.0-alpha02이 출시되었습니다. 버전 1.3.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • SceneInfo 클래스에 title 및 url 속성이 추가되었습니다. 이 속성은 장면의 마지막 NavEntry's 메타데이터에서 자동으로 채워집니다. TitleMetadataKey 및 UrlMetadataKey를 사용하여 항목의 메타데이터에서 도착 페이지 제목과 URL을 정의합니다. (I78a20, b/542693522)

버전 1.3.0-alpha01

2026년 9월 23일

androidx.navigation3:navigation3-*:1.3.0-alpha01이 출시되었습니다. 버전 1.3.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • DeferredAnimatedContent로 이전하고 전환 핸드오프 문제를 해결하여 NavDisplay의 뒤로 탐색 예측 애니메이션 핸드오프를 수정했습니다. I145eaedd b/430807423
    • DeferredAnimatedContent는 DeferredTransition를 사용하여 전환을 지연 단계(defer를 통해)와 자동 단계(animateTo를 통해)로 분리합니다. 지연 단계에서는 스와이프 동작 중에 수동 변환을 적용하고 자동 단계에서는 스와이프가 커밋될 때 전환을 실행합니다.

알려진 문제

  • 공유 요소가 전환 중에 들어오는 장면이 아닌 나가는 장면에 렌더링됩니다. (b/582354988)
  • 공유 요소는 지연된(동작) 단계에서 탐색하지 않습니다.

버전 1.2.1

2026년 11월 4일

androidx.navigation3:navigation3-*:1.2.1이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.

변경사항

  • compileSdk이(가) 37에서 36으로 다운그레이드되었습니다. 버전 1.2는 compileSdk 37이 필요하지 않은 Compose 1.10에 종속됩니다.

버전 1.2.0

2026년 9월 23일

androidx.navigation3:navigation3-*:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.2.0이 이제 안정화되었습니다.

1.1.0 이후 중요 변경사항

Result API

  • 이 새로운 API를 사용하면 LocalResultEventBus 및 ResultEventBusNavEntryDecorator에서 제공하는 ResultEventBus를 사용하여 NavEntries 간에 결과를 전달할 수 있습니다.
  • ResultEventBusNavEntryDecorator 외부에서 ResultEventBus를 호이스팅하고 rememberResultEventBusNavEntryDecorator에 전달할 수 있도록 rememberResultEventBus를 추가했습니다.
  • 전달된 결과는 ResultEventBus#conflateAsState를 사용하여 상태로 액세스하거나 ResultEffect를 사용하여 결과 흐름으로 수집할 수 있습니다.

Deep Link API

Navigation3는 이제 DeepLinkRequest, DeepLinkUri, DeepLinkMatcher를 통해 androidx.navigation3.runtime.deeplink에서 Kotlin 멀티플랫폼(KMP) 딥 링크를 지원합니다.

  • DeepLinkRequest 및 RequestExtras: DeepLinkUri, URI 문자열 또는 Android Intent에서 생성된 딥 링크 요청을 나타냅니다. requestExtras DSL 및 RequestExtrasKey<T>로 빌드된 유형 안전 RequestExtras 컨테이너를 사용하여 추가 요청 메타데이터를 연결할 수 있습니다.
  • DeepLinkMatcher: DeepLinkRequest와 일치시킬 수 있는 딥 링크를 나타냅니다. 각 일치자 인스턴스는 이 딥 링크를 지원하는 탐색 키와 연결됩니다. 탐색 키는 여러 일치자와 연결될 수 있습니다. DeepLinkMatcher.match를 호출하면 일치하는 경우 연결된 탐색 키가 포함된 MatchResult가 반환됩니다. 기본 DeepLinkMatcher 구현은 두 가지입니다. Uri를 기반으로 딥 링크를 일치시키는 UriDeepLinkMatcher와 불리언으로 일치하는 DeepLinkMatcher.Filter만 사용하여 딥 링크를 일치시키는 StaticKeyDeepLinkMatcher입니다.
  • BackStackMatcher: 딥 링크 일치가 성공하면 합성 백 스택을 구성하는 DeepLinkMatcher입니다. BackStackMatcher은 DeepLinkMatcher.withBackStack 확장 함수를 통해 만들 수 있습니다.

뒤로 탐색 예측 처리

  • NavigationBackHandler 및 rememberNavigationEventState를 추가하여 뒤로 탐색 예측 처리(onBackCompleted 및 onBackCancelled)와 SceneState 연결을 간소화했습니다. 이를 통해 맞춤 UI 구성요소는 백 스택 델타를 수동으로 계산하지 않고도 표준 뒤로 탐색 및 뒤로 탐색 예측 동작을 지원할 수 있습니다.
  • 앞으로 애니메이션 도중에 트리거되는 뒤로 탐색 예측 동작 지원을 포함하여 뒤로 탐색 예측 전환이 개선되었습니다.

기타 변경사항

  • 이제 NavEntry.contentKey가 기본적으로 key.toString() 및 key::class.toString()의 복합체로 설정되어 여러 인터페이스에서 동일한 단순 이름을 공유하는 data object 키 간의 키 충돌을 방지합니다.
  • 이제 EntryProvider에서 키 유형보다 키 인스턴스를 기반으로 일치에 우선순위를 부여합니다.
  • Scene 구현이 data class이거나 equals 및 hashCode를 구현하도록 하는 린트 검사가 추가되었습니다.

버전 1.2.0-rc01

2026년 9월 9일

androidx.navigation3:navigation3-*:1.2.0-rc01이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • 딥 링크 URI 패턴에서 중복된 자리표시자 이름을 허용하지 않습니다. (I8985c, b/522343165)

버전 1.2.0-beta01

2026년 8월 26일

androidx.navigation3:navigation3-*:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • DeepLinkRequest.extras를 Map<String, Any>에서 RequestExtrasKey<T>와 T의 쌍을 저장하는 새로운 유형의 안전한 맵과 유사한 클래스 RequestExtras로 리팩터링했습니다. RequestExtras는 requestExtras DSL로 인스턴스화할 수 있습니다. (Ic929d, b/543883369)

버그 수정

  • 정방향 전환 중에 트리거되는 뒤로 탐색 예측 동작이 스와이프 진행 상황에 따라 애니메이션으로 표시되지 않는 문제가 해결되었습니다. 이제 뒤로 탐색 예측이 애니메이션으로 표시되고 올바르게 완료됩니다. (Icdcb0, b/456218398)
  • Scene 구현이 데이터 클래스이거나 등호 및 해시코드를 구현하여 적절한 경우 동일한 Scene가 사용되도록 하는 린트 검사가 추가되었습니다. (Ibdf0d, b/542316099)
  • 이제 NavEntry.contentKey는 기본적으로 key.toString() 및 key::class.toString()의 조합으로 설정됩니다. 이렇게 하면 이름은 같지만 다른 인터페이스를 구현하는 데이터 객체가 더 이상 동일한 contentKey를 갖지 않습니다. 하지만 JS 플랫폼의 key::class는 정규화된 이름 대신 단순 클래스 이름만 반환하므로 JS 플랫폼은 이름이 중복된 데이터 객체에 대해 맞춤 contentKey를 계속 구현해야 합니다. (I1fbbb, b/512534342)
  • 여러 팝 전환이 진행 중일 때 빠른 뒤로 탐색 중에 사용된 중복 키에 대해 SaveableStateProvider에서 발생하는 IllegalArgumentException을 수정했습니다. (I4d728, b/516312097)

버전 1.2.0-alpha07

2026년 7월 29일

androidx.navigation3:navigation3-*:1.2.0-alpha07이 출시되었습니다. 버전 1.2.0-alpha07에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 다른 DeepLinkMatcher.MatchResult를 래핑하는 추상 WrappedMatchResult 클래스를 추가했습니다. 이렇게 하면 맞춤설정된 일치 결과가 다른 결과 위에 레이어로 표시됩니다. (I7d4dc, b/470282247)
  • 일치자 인스턴스와 입력 일치자의 일치 결과를 제공하고 백 스택을 반환하는 빌더 람다라는 두 매개변수를 사용하는 새 BackStackMatcher 클래스가 추가되었습니다. 일치하는 항목이 있으면 BackStackMatcher는 람다로 빌드된 백 스택과 함께 원래 일치 결과가 포함된 WrappedMatchResult를 확장하는 BackStackMatchResult를 반환합니다. BackStackMatcher는 새 DeepLinkMatcher.withBackStack 확장 함수를 사용해야만 만들 수 있습니다. (Ibf987, b/470282247)

  • value : T를 String로 인코딩 및 디코딩하기 위해 KSerializer를 확장하는 추상 DeepLinkSerializer 클래스를 추가했습니다. DeepLinkSerializer를 사용하여 기본이 아닌 딥 링크 인수를 직렬화할 수 있습니다. rememberSaveable 및 rememberNavBackStack와 호환됩니다. (Id3c9f, b/470282247)

  • DeepLinkMatcher에 두 번째 유형 매개변수 out R : DeepLinkMatcher.MatchResult<T>가 추가되어 개발자가 유형 변환 없이 DeepLinkMatcher.match()에서 반환된 서브클래스화된 MatchResult의 속성에 액세스할 수 있습니다. (I693d3, b/470282247)

  • DeepLinkMatcher.MatchResult's T 상한이 Any?에서 Any(으)로 변경되었습니다. (I6bf1a)

  • DeepLinkRequest 생성자 필드 uri의 기본값이 이제 null입니다. 보조 생성자의 uriString가 uri로 이름이 변경되었습니다. (Ia0f14, b/522194187)

버그 수정

  • ResultEffect가 이제 rememberUpdatedState을 사용하여 최신 onResult 람다를 캡처합니다. (I7d2a3, b/531709234)
  • 빈 경로 세그먼트의 딥 링크 일치 문제를 수정했습니다. 인수 유형이 String이면 빈 경로는 빈 문자열 값으로 처리됩니다. 그렇지 않으면 빈 경로가 값이 제공되지 않은 것으로 처리되고 기본값으로 대체됩니다. 기본값이 없으면 일치가 실패합니다. (I56575, b/535298128)
  • DeepLinkRequest.uri에 빈 쿼리 값 지원이 추가되었습니다. 인수가 문자열 유형인 경우 빈 값은 리터럴 빈 문자열로 처리됩니다. 그렇지 않으면 빈 값은 값이 제공되지 않은 것으로 처리되고 일치 항목은 기본값으로 대체됩니다. 기본값이 없으면 일치가 실패합니다. (I30343, b/535127459)
  • 이제 EntryProvider에서 키 유형보다 키 인스턴스를 기반으로 일치에 우선순위를 부여합니다. (Ib5ec9, b/533331924)
  • SceneState가 이제 최상위 오버레이가 아닌 장면부터 시작하여 이전 장면을 올바르게 계산합니다. (I91915, b/513630541)

버전 1.2.0-alpha06

2026년 7월 15일

androidx.navigation3:navigation3-*:1.2.0-alpha06이 출시되었습니다. 버전 1.2.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 와일드 카드가 있는 프래그먼트는 모든 입력과 일치하지만 입력이 인수로 추출되지 않는다는 점을 명확히 하기 위해 URI 프래그먼트에 관한 UriDeepLinkMatcher 문서를 수정했습니다. (I5ad9b, b/524677091)
  • URI 패턴에 스키마가 포함되어 있지 않거나 이중 슬래시로 시작하지 않는 경우 UriDeepLinkMatcher가 요청과 일치하지 않는 문제를 수정했습니다. 예를 들어 www.example.com/home는 이제 http://www.example.com/home와 일치합니다. (Ia6b65, b/522791926)

버전 1.2.0-alpha05

2026년 7월 1일

androidx.navigation3:navigation3-*:1.2.0-alpha05이 출시되었습니다. 버전 1.2.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

새로운 API

  • rememberResultEventBusNavEntryDecorator에 전달할 수 있는 ResultEventBus를 반환하는 rememberResultEventBus API를 추가했습니다. 이렇게 하면 ResultEventBusNavEntryDecorator 외부에서 ResultEventBus를 호이스팅할 수 있습니다. (Ia655b, b/516995400)

DeepLinkRequest

  • KMP 호환 생성자 2개(DeepLinkUri를 사용하는 생성자 1개, 원시 문자열 URI를 사용하는 생성자 1개)를 추가했습니다. (I3c088, b/513200887, b/522194187)
  • (Android만 해당) Intent를 사용하는 생성자가 추가되었습니다. (Ia0498, b/513200887, b/522194187)
  • 모든 생성자에는 추가 요청 정보를 연결하기 위한 Map<String, Any>의 추가 extras 필드가 있습니다. (If81d5, b/513200887)
  • 추가 항목의 맵을 빌드하는 유형 안전 방식으로 새로운 requestExtras dsl이 추가되었습니다. DSL은 RequestExtrasKey에서 Any까지의 쌍을 저장하는 put 함수를 제공합니다. Map<String, Any>.get(key) 확장 함수를 사용하여 RequestExtrasKey로 지도에서 읽을 수 있습니다. (I5091c, b/513200887)
  • (Android만 해당) ActionExtrasKey를 사용하여 추가 지도 항목을 만드는 ActionExtrasKey 및 actionExtra 함수가 추가되었습니다. (Id0c90, [b/513200887]
  • MimeTypeExtrasKey를 사용하여 추가 지도 항목을 만드는 MimeTypeExtrasKey 및 mimeTypeExtra 함수를 추가했습니다. (I85131, b/513200887)

DeepLinkMatcher

  • mimeType 또는 action로 DeepLinkRequest를 필터링하는 DeepLinkMatcher.Filters를 만드는 DeepLinkMatcher.mimeTypeFilter 및 DeepLinkMatcher.actionFilter 함수를 추가했습니다(Android만 해당). 두 필터 모두 문자열 일치로 일치하며 대소문자를 구분하지 않습니다. (Ie7e67, b/513191950)

API 변경사항

DeepLinkRequest

  • fromAction 팩토리 함수를 삭제합니다. 작업과 연결된 요청을 만들려면 새 DeepLinkRequest.extras 필드를 사용합니다.(Id0c90, b/513200887)
  • fromMimeType 팩토리 함수를 삭제했습니다. mimeType과 연결된 요청을 만들려면 새 DeepLinkRequest.extras 필드를 사용합니다. (I85131, b/513200887)
  • (Android만 해당) fromIntent 팩토리 함수가 삭제되었습니다. Intent 및 추가 항목 맵을 사용하는 새 생성자로 대체되었습니다. (Ia0498, b/513200887, b/522194187)
  • 팩토리 함수 fromUri 및 fromUriString가 삭제되었습니다. DeepLinkUri 또는 원시 문자열 URI를 사용하는 새 생성자로 대체되었습니다. (Id5b6f, b/522194187)
  • DeepLinkMatcher, DeepLinkMatcher.MatchResult 및 서브클래스는 이제 공변 T(out T)를 사용하므로 계층적 키는 Matchers와 함께 사용되는 유형 변환이 필요하지 않습니다. (I1e453, b/525094876)
  • 이제 인수 맵의 UriMatchResult 생성자 매개변수가 기본적으로 빈 맵으로 설정됩니다. (I3acdd)
  • DeepLinkMatcher.Filter 추상 클래스가 이제 함수형 인터페이스입니다. filter 생성자 필드가 삭제되었으며 대신 서브클래스에서 직접 전달해야 합니다. (I9eb7d, b/522194187)

버그 수정

  • 람다 값이 포함된 중첩된 메타데이터가 있는 항목으로 팝할 때 팝된 항목이 즉시 사라지는 문제가 해결되었습니다. (Idb872, b/520494430)
  • 일치하는 동안 필수 인수가 누락된 경우 MissingFieldException를 발생시키는 대신 null UriMatchResult을 반환하도록 UriDeepLinkMatcher를 수정했습니다. (I5322f, b/524663005)
  • https 스키마가 있는 URI를 포함하는 UriDeeplinkMatcher는 https 스키마가 있는 요청과만 일치할 수 있습니다. (Ibfe22, b/522304329)
  • DeepLinkRequest를 UriDeepLinkMatcher에 일치시킬 때 http 스키마를 https와 일치하는 것으로 올바르게 식별하도록 UriDeepLinkMatcher를 수정합니다. (I3a62b, b/518804264)
  • 이제 두 결과가 같으면 DeepLinkMatcher.MatchResult 비교 연산자가 기본적으로 0을 반환합니다. (I48ddb, b/518841353)
  • 이제 필수 인수가 누락되어 일치 요청이 실패할 때 UriDeepLinkMatcher에서 예외를 발생시키는 대신 null UriMatchResult를 반환합니다. (I669a7, b/470282247, b/512923412)

버전 1.2.0-alpha04

2026년 6월 3일

androidx.navigation3:navigation3-*:1.2.0-alpha04이 출시되었습니다. 버전 1.2.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • ModalBottomSheet와 같은 중첩된 오버레이가 그 위의 오버레이가 팝될 때 예기치 않게 다시 애니메이션되는 오버레이 애니메이션 문제가 해결되었습니다. (Ia2b9e, b/502624496)

버전 1.2.0-alpha03

2026년 5월 19일

androidx.navigation3:navigation3-*:1.2.0-alpha03이 출시되었습니다. 버전 1.2.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

Navigation 3은 이제 DeepLinkRequest 및 DeepLinkMatcher를 사용하는 딥 링크를 지원합니다.

  • DeepLinkRequest: DeepLinkUri 및 선택적 mimeType 또는 작업이 포함된 요청된 딥 링크입니다(Android만 해당). 새 클래스와 함께 uri, mimeType 또는 action를 사용하여 인스턴스를 만드는 컴패니언 함수가 있습니다. Android 플랫폼에는 인텐트에서 요청을 빌드하는 도우미도 있습니다. (Iaaac9, b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
    val uriAndMimeRequest = DeepLinkRequest.fromUriString(
      "https://sampledeeplink.com/user/profile?id=123",
      "image/png"
    )
    
  • DeepLinkMatcher는 DeepLinkRequest와 일치할 수 있는 딥 링크를 나타냅니다. 각 일치자 인스턴스는 이 딥 링크를 지원하는 탐색 키와 연결됩니다. 탐색 키는 여러 일치자와 연결될 수 있습니다. DeepLinkMatcher.match를 호출하면 일치하는 경우 연결된 탐색 키가 포함된 MatchResult가 반환됩니다. 기본 DeepLinkMatcher 구현에는 두 가지가 있습니다. 하나는 URI를 기반으로 딥 링크를 일치시키는 UriDeepLinkMatcher이고 다른 하나는 Boolean로 일치하는 DeepLinkMatcher.Filter만 사용하여 딥 링크를 일치시키는 StaticKeyDeepLinkMatcher입니다. (I3798e, b/470282247)

  • UriDeepLinkMatcher: DeepLinkUri를 직렬화 가능한 탐색 키와 일치시켜 딥 링크를 처리하는 DeepLinkMatcher의 독자적인 구현입니다. 기본 유형의 딥 링크 인수 또는 목록, 배열, 집합과 같은 기본 요소 모음을 지원합니다. (I1520b, b/470282247)

    @Serializable
    data class UserKey(val id: Int): NavKey
    
    // declare a deep link supported by UserKey
    val userMatcher = UriDeepLinkMatcher(
      uriPattern = "www.sampledeeplink.com/user?userId={id}",
      serializer = serializer<UserKey>()
    )
    
    // handle a requested deep link with fallback key
    val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey
    
  • android.net.Uri의 Kotlin 멀티플랫폼 버전인 DeepLinkUri를 추가했습니다. (Id4725, b/470282247)

API 변경사항

  • Compose의 compileSdk와 일치하도록 compileSdk 37로 상향 조정되었습니다.

버그 수정

  • 여러 오버레이를 표시할 때 AnimatedBottomSheetSample의 IllegalArgumentException가 수정되었습니다. 이제 샘플 SceneStrategy가 마지막 비OverlayScene를 올바르게 계산하고 모든 오버레이 장면 아래에 표시합니다. (If2281, b/506733412)
  • NavigationEvent 종속 항목을 1.1.1로 상향 조정했습니다. 이렇게 하면 검사 모드에서 작동하지 않는 NavigationEventHandler가 삭제되어 Android 스튜디오 미리보기에서 뒤로 탐색 예측을 사용 설정할 수 있습니다. (I487fd)

버전 1.2.0-alpha02

2026년 4월 22일

androidx.navigation3:navigation3-*:1.2.0-alpha02이 출시되었습니다. 버전 1.2.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • onBack의 이름을 onBackCompleted로 바꾸고 NavigationBackHandler에 onBackCancelled를 추가하여 취소된 뒤로 동작 처리를 지원합니다. (I92741)
  • SceneState를 사용할 때 뒤로 동작 및 뒤로 탐색 예측 처리를 간소화하기 위해 NavigationBackHandler를 추가합니다. 이를 통해 개발자는 백 스택 델타를 수동으로 계산하지 않고도 표준 뒤로 탐색 및 뒤로 탐색 예측 동작을 지원하는 맞춤 UI 구성요소를 더 쉽게 만들 수 있습니다. (I6a055)
  • rememberNavigationEventState을 추가하여 SceneState를 뒤로 탐색 예측 처리와 연결하는 작업을 간소화합니다. (Iae49c)

새로운 기능

  • 새 ResultEventBusNavEntryDecorator에서 제공하는 LocalResultEventBus를 사용하여 NavEntries 간에 결과를 전달할 수 있도록 ResultEventBus API를 추가했습니다. 전달된 결과는 ResultEventBus#conflateAsState를 사용하여 상태로 평가하거나 ResultEffect를 사용하여 결과 흐름으로 평가할 수 있습니다.

버전 1.2.0-alpha01

2026년 4월 8일

androidx.navigation3:navigation3-*:1.2.0-alpha01이 출시되었습니다. 버전 1.2.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 이제 OverlayScenes가 노옵스 LocalAnimatedContentScope와 함께 제공되므로 OverlayScene에서 LocalNavAnimatedContentScope에 액세스해도 더 이상 IllegalStateException이 발생하지 않습니다. (I2f00c, b/486067688)

버전 1.1.7

2026년 8월 26일

androidx.navigation3:navigation3-*:1.1.7이 출시되었습니다. 버전 1.1.7에 포함된 커밋을 확인하세요.

버그 수정

  • 정방향 전환 중에 트리거되는 뒤로 탐색 예측 동작이 스와이프 진행 상황에 따라 애니메이션으로 표시되지 않는 문제가 해결되었습니다. 이제 뒤로 탐색 예측이 애니메이션으로 표시되고 올바르게 완료됩니다. (Icdcb0, b/456218398)

버전 1.1.6

2026년 8월 12일

androidx.navigation3:navigation3-*:1.1.6이 출시되었습니다. 버전 1.1.6에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 NavEntry.contentKey는 기본적으로 key.toString() 및 key::class.toString()의 조합으로 설정됩니다. 이렇게 하면 이름은 같지만 다른 인터페이스를 구현하는 데이터 객체가 더 이상 동일한 contentKey를 갖지 않습니다. 하지만 JS 플랫폼의 key::class는 정규화된 이름 대신 단순 클래스 이름만 반환하므로 JS 플랫폼은 이름이 중복된 데이터 객체에 대해 맞춤 contentKey를 계속 구현해야 합니다. (I1fbbb, b/512534342)
  • 백 스택에서 빠르게 팝하여 여러 팝 전환이 동시에 진행 중일 때 키 재사용을 위해 SaveableStateHolder에서 발생하는 IllegalArgumentException를 수정했습니다. (I4d728, b/516312097)

버전 1.1.5

2026년 7월 29일

androidx.navigation3:navigation3-*:1.1.5이 출시되었습니다. 버전 1.1.5에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 entryProvider DSL은 키 클래스(예: entry<UserKey>{ ... })로 빌드된 NavEntry보다 키 인스턴스(예: entry(key = userKey) { ... })로 빌드된 NavEntry의 우선순위를 지정합니다. (Ib5ec9, b/533331924)

버전 1.1.4

2026년 7월 1일

androidx.navigation3:navigation3-*:1.1.4이 출시되었습니다. 버전 1.1.4에 포함된 커밋을 확인하세요.

버그 수정

  • 람다 값이 포함된 중첩된 메타데이터가 있는 항목으로 팝할 때 팝된 항목이 즉시 사라지는 문제가 해결되었습니다. (Idb872, b/520494430)

버전 1.1.3

2026년 6월 17일

androidx.navigation3:navigation3-*:1.1.3이 출시되었습니다. 버전 1.1.3에 포함된 커밋을 확인하세요.

버그 수정

  • ModalBottomSheet와 같은 중첩된 오버레이가 그 위의 오버레이가 팝될 때 예기치 않게 다시 애니메이션되는 오버레이 애니메이션 문제가 해결되었습니다. (Ia2b9e, b/502624496)

  • NavigationEvent 종속 항목을 1.1.2로 상향 조정하여 Android 스튜디오 미리보기에서 뒤로 탐색 예측을 사용 설정하기 위해 검사 모드일 때 노옵스 NavigationEventHandler를 삭제했습니다.

버전 1.1.2

2026년 5월 19일

androidx.navigation3:navigation3-*:1.1.2이 출시되었습니다. 버전 1.1.2에 포함된 커밋을 확인하세요.

버그 수정

  • NavigationEvent 종속 항목을 1.1.1로 상향하여 검사 모드에서 작동하지 않는 NavigationEventHandler를 삭제하고 Android 스튜디오 미리보기에서 뒤로 탐색 예측을 사용 설정했습니다.

버전 1.1.1

2026년 4월 22일

androidx.navigation3:navigation3-*:1.1.1이 출시되었습니다. 버전 1.1.1에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 OverlayScenes가 노옵스 LocalAnimatedContentScope와 함께 제공되므로 OverlayScene에서 LocalNavAnimatedContentScope에 액세스해도 더 이상 IllegalStateException이 발생하지 않습니다. (I2f00c, b/486067688)

버전 1.1.0

2026년 4월 8일

androidx.navigation3:navigation3-*:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.1.0이 이제 안정화되었습니다.

1.0.0 이후 중요 변경사항

장면 간 공유 요소 - 이제 Navigation3에서 장면을 공유 요소 객체로 처리할 수 있습니다. 즉, 장면이 변경될 때 원활한 전환이 가능합니다. SharedTransitionScope를 NavDisplay 또는 rememberSceneState에 전달하여 이 기능을 사용 설정할 수 있습니다.

SceneDecoratorStrategy: 일반적인 UI 구성요소로 장면을 장식하거나 장면 간에 상태를 공유하는 등의 사용 사례를 지원하기 위해 SceneDecoratorStrategy가 도입되었습니다.

NavMetadata DSL - Navigation3에서 이제 새로운 유형 안전 메타데이터 DSL을 제공합니다. DSL은 메타데이터 맵에 제공하려는 키 및 값 유형을 정의할 수 있는 새로운 MetadataKey 인터페이스를 사용합니다. 또한 NavDisplay 전환을 위한 새로운 NavMetadataKeys가 추가되어 새로운 메타데이터 DSL과 함께 사용하여 NavDisplay에 전환을 추가할 수 있습니다.

OverlayScene 애니메이션: OverlayScene 인터페이스에 새로운 onRemoved 정지 콜백이 있습니다. 이 콜백은 장면과 연결된 키가 백 스택에서 삭제된 후 컴포지션을 나가기 전에 호출됩니다. 이렇게 하면 onRemoved 내에서 호출된 종료 애니메이션이 완료된 후 오버레이 장면이 컴포지션에서 삭제됩니다.

기타 변경사항 - 이제 NavDisplay 및 rememberSceneState는 then 중위로 연결된 이전의 단일 SceneStrategy 매개변수 대신 List<SceneStrategy>를 사용합니다. - 이제 EntryProvider DSL을 통해 항목 키를 고려하여 메타데이터를 동적으로 추가할 수 있습니다.

버전 1.1.0-rc01

2026년 3월 25일

androidx.navigation3:navigation3-*:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • NavDisplay는 이제 오버레이 아래에 표시되는 항목의 Lifecycle가 STARTED로 제한되도록 합니다. 이렇게 하면 대화상자를 사용할 때 dropUnlessResumed과 같은 API가 계속 작동합니다. (If209f, b/483966071)
  • NavDisplay에서 동일한 화면 간에 앞뒤로 이동하고 두 화면 간의 애니메이션을 중단하면 화면의 z 순서가 잘못될 수 있는 문제가 해결되었습니다. (I4d491, b/459419800)

버전 1.1.0-beta01

2026년 3월 11일

androidx.navigation3:navigation3-*:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha05

2026년 2월 25일

androidx.navigation3:navigation3-*:1.1.0-alpha05이 출시되었습니다. 버전 1.1.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 이제 NavDisplay 및 rememberSceneState는 then 중위로 연결된 이전의 단일 SceneStrategy 매개변수 대신 List<SceneStrategy>를 사용합니다. 이는 두 API가 이미 사용하는 List<SceneDecoratorStrategy<T>>와 더 잘 일치합니다. 이전 API는 지원 중단되었습니다. (I78b2c, b/482108465)
  • 메타데이터 맵에 지정된 NavMetadataKey가 포함되어 있는지 확인하는 메타데이터 #contains 연산자가 추가되었습니다. (Ic30db, b/485311895)
  • 메타데이터 DSL과 함께 사용할 DialogSceneStrategy의 NavMetadataKey DialogKey를 추가했습니다. (Ic7a26, b/483388817)

버전 1.1.0-alpha04

2026년 2월 11일

androidx.navigation3:navigation3-*:1.1.0-alpha04이 출시되었습니다. 버전 1.1.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Navigation3는 이제 새로운 유형 안전 메타데이터 DSL을 제공합니다. DSL은 메타데이터 맵에 제공하려는 키 및 값 유형을 정의할 수 있는 새로운 MetadataKey 인터페이스를 사용합니다. 또한 NavDisplay 전환을 위한 새로운 NavMetadataKey가 추가되어 새로운 metadata DSL과 함께 사용하여 NavDisplay에 전환을 추가할 수 있습니다. (Ic10ef, Ic049c,b/476213928)

API 변경사항

  • OverlayScene 인터페이스에 새로운 onRemoved 정지 콜백이 있습니다. 이 콜백은 장면과 연결된 키가 백 스택에서 삭제된 후 컴포지션을 나가기 전에 호출됩니다. 이렇게 하면 오버레이 장면이 컴포지션에서 삭제되기 전에 onRemoved 내에서 호출된 종료 애니메이션이 완료될 수 있습니다. (I29a72, b/440558061)
  • SceneStrategy에서 장식 함수를 새로운 SceneDecoratorStrategy로 분리했습니다. 이 새로운 인터페이스는 장면을 장식하는 데 사용해야 합니다. SceneDecoratorStrategies를 추가할 수 있는 NavDisplay 및 rememberSceneState용 새 API가 있습니다. (If9385, b/477669607, b/477670333)

버그 수정

  • SharedTransitionLayout를 NavDisplay 또는 rememberSceneState에 전달하고 OverlayScene를 사용하면 비정상 종료가 발생하는 오류를 수정했습니다. SharedTransitionLayout를 사용하는 것은 AnimatedContent의 일부로 렌더링되는 NavEntries에서만 작동하고 OverlayScene는 자체 창에서 별도로 렌더링되기 때문입니다. (I1bb76, b/478664101)

종속 항목 업데이트

  • Navigation3 1.0.1부터: Navigation3가 이제 NavigationEvent 1.0.2에 종속됩니다. 이는 AndroidStudio 미리보기 중에 NavDisplay를 사용하여 발생하는 IllegalStateException를 수정합니다. (Id7212, b/477149762)

버전 1.1.0-alpha03

2026년 1월 28일

androidx.navigation3:navigation3-*:1.1.0-alpha03이 출시되었습니다. 버전 1.1.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 EntryProvider DSL을 통해 항목 키를 고려하여 메타데이터를 동적으로 추가할 수 있습니다. (I942fb, b/474416976)

버전 1.1.0-alpha02

2026년 1월 14일

androidx.navigation3:navigation3-*:1.1.0-alpha02이 출시되었습니다. 버전 1.1.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 SceneStrategy에서 새로운 calculatedScene(Scene) 함수를 통해 장면 중첩을 지원합니다. 즉, SceneStrategy를 맞춤설정하여 다른 장면에 추가 기능을 제공할 수 있습니다. (I5df7c,b/440333896)

버전 1.1.0-alpha01

2025년 12월 3일

androidx.navigation3:navigation3-*:1.1.0-alpha01이 출시되었습니다. 버전 1.1.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 이제 Navigation3에서 장면을 공유 요소 객체로 처리하는 것을 지원합니다. 즉, 장면이 변경될 때 원활한 전환이 가능합니다. SharedTransitionScope를 NavDisplay 또는 rememberSceneState에 전달하여 이 기능을 사용 설정할 수 있습니다. (I15868)

버전 1.0

버전 1.0.1

2026년 2월 11일

androidx.navigation3:navigation3-*:1.0.1이 출시되었습니다. 버전 1.0.1에는 이러한 커밋이 포함되어 있습니다.

종속 항목 업데이트

  • Navigation3는 이제 NavigationEvent 1.0.2에 종속됩니다. 이는 AndroidStudio 미리보기 중에 NavDisplay를 사용하여 발생하는 IllegalStateException를 수정합니다. (Id7212, b/477149762)

버전 1.0.0

2025년 11월 19일

androidx.navigation3:navigation3-*:1.0.0이 출시되었습니다. 버전 1.0.0에는 이러한 커밋이 포함되어 있습니다.

Navigation3 소개

  • 이제 Navigation3 라이브러리가 안정화되었습니다. Navigation3는 탐색에 대한 AndroidX Compose 우선 접근 방식입니다.
  • 자세한 내용은 공지사항 블로그 게시물을 참고하고, 리소스를 방문하고, 레시피를 사용해 보세요.

버전 1.0.0-rc01

2025년 11월 5일

androidx.navigation3:navigation3-*:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 NavDisplay가 Scene 수준에서 LocalLifecycleOwner를 설정하여 장면 작성자가 Lifecycle.State가 RESUMED인지 확인하여 모든 전환이 완료되었는지 확인할 수 있습니다. NavEntry 수준의 LocalLifecycleOwner 동작은 변경되지 않습니다. 전환이 진행 중인 경우에도 STARTED로 제한되며, 해당 NavEntry가 백 스택에서 팝되어 애니메이션이 종료되는 중인 경우에도 CREATED로 제한됩니다. (I03113, b/454045829)

버전 1.0.0-beta01

2025년 10월 22일

androidx.navigation3:navigation3-*:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • 이제 SceneStrategyScope에는 인수가 없는 공개 생성자만 있으므로 SceneStrategy 및 반환된 Scene를 개별적으로 테스트하는 데 적합합니다. 더 복잡한 사용 사례의 경우 rememberSceneState()를 사용하세요. (I8440c, b/451679047)

버그 수정

  • SceneStrategy를 then와 연결할 때 발생하는 무한 루프가 수정되었습니다. (Iba3f0, b/450323470)
  • NavDisplay에 전달된 backStack를 교체하고 애니메이션을 사용할 때 발생하는 화면 깜박임 문제가 해결되었습니다. (Ief7b5, b/450967248)

버전 1.0.0-alpha11

2025년 10월 8일

androidx.navigation3:navigation3-*:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • SceneStrategy의 calculateScene 메서드는 더 이상 @Composable가 아닙니다. 대신 이 작업을 SceneStrategy 메서드(즉, rememberMySceneStrategy() 메서드)의 구성으로 이동하는 것이 좋습니다. 이렇게 하면 올바른 값을 기반으로 rememberSaveable 값 또는 키 remember 문의 전체 기간을 정의할 수 있습니다. (If1733, b/448709506)
  • SceneStrategy.calculateScene의 onBack 매개변수가 SceneStrategyScope의 새 수신자 범위로 이동하여 선택적 매개변수임을 더 명확하게 나타내고 향후 Navigation3 기능의 확장 지점을 제공합니다. (I3aea3, b/448460407)
  • NavDisplay 및 SceneStrategy에 전달된 onBack 람다는 더 이상 여러 항목을 팝해야 하는 시점을 나타내는 count: Int 매개변수를 제공하지 않습니다. 대신, Scene에서 여러 항목을 표시하도록 요청하는 드문 경우에 () -> Unit 람다가 연속으로 여러 번 호출됩니다. (Idedb5, b/446989346)
  • NavEntryWrapper 클래스를 삭제하고, 새 콘텐츠가 포함된 NavEntry를 사용하는 새 보조 생성자가 있는 최종 NavEntry 클래스로 기능을 대체합니다. 이렇게 하면 새 콘텐츠로 항목을 래핑하는 기능이 계속 지원됩니다. (I7da2a, b/444447130)
  • NavEntryDecorator를 만들고 반환하는 navEntryDecorator 함수가 삭제되고 NavEntryDecorator 클래스로 대체되었습니다. 이 클래스는 이제 공개 상태가 되었으며 서브클래스화할 수 있습니다. (If81f8, b/444447434, b/447381176)
  • SaveableStateHolder로 항목을 장식하므로 SavedStateNavEntryDecorator의 이름이 SaveableStateHolderNavEntryDecorator로 변경되었습니다. 데코레이터는 기능적으로 NavEntryDecorator의 팩토리이므로 함수에서 클래스로 리팩터링되었습니다. (Ie6013, b/447381176)
  • NavDisplay 대신 SceneState를 사용하는 맞춤 디스플레이는 더 이상 LocalEntriesToRenderInCurrentScene 컴포지션 로컬(현재 내부)을 사용할 필요가 없습니다. (Ic40ef, b/414668196)
  • 공개 API 노출 영역에서 SceneSetupNavEntryDecorator 및 rememberSceneSetupNavEntryDecorator()를 삭제했습니다. 이제 이 기능은 수동으로 포함하지 않아도 기본적으로 포함됩니다. (Ieae42, b/444479133)
  • 이제 NavEntry, DialogScene, SinglePaneScene, SceneState가 모두 equals를 구현합니다. (I96121)
  • 장면 인터페이스에 NavDisplay의 장면별 메타데이터를 연결하는 새로운 메타데이터 필드가 있습니다. 이렇게 하면 Scene이 NavDisplay의 메타데이터를 재정의할 수 있습니다(예: 전환 사용). (I1fd96, b/443955625)
  • 중복된 일반 유형 매개변수를 삭제하여 rememberNavBackStack 서명을 간소화합니다. 이제 함수에서 vararg elements: NavKey를 허용합니다. (I03e45)
  • 이제 NavDisplay의 기본 애니메이션이 모든 플랫폼에서 호출할 수 있는 공통 API의 일부가 되었습니다. (I71af9, b/447147159)
  • 클래스가 NavEntries를 빌드하는 범위를 제공하는 Kotlin DSL임을 정확하게 반영하도록 EntryProviderBuilder의 이름을 EntryProviderScope로 바꿉니다. (Ia7465)

버그 수정

  • 이제 rememberNavBackStack()은 NavKey에 다형성 직렬화를 적용하며, 올바른 상태 복원을 보장하도록 구성된 맞춤 SavedStateConfiguration가 필요합니다. 모든 NavKey 하위 유형이 제공된 SerializersModule에 등록되어야 한다는 요구사항을 반영하도록 KDoc가 업데이트되었습니다. (I6de37,I782f2, b/446664383)

버전 1.0.0-alpha10

2025년 9월 24일

androidx.navigation3:navigation3-*:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • rememberDecoratedNavEntries로 데코레이션된 NavEntry<T> 목록을 사용하는 새 NavDisplay 오버로드를 추가합니다. (I4025b, b/441940314)
  • DialogScene를 새 패키지로 이동했습니다. (Ia5840)
  • 공개 API DecorateNavEntry를 삭제합니다. 대신 rememberDecoratedNavEntries를 사용하여 데코레이터 목록으로 NavEntry를 래핑합니다. (Id8c09)
  • Navigation3 UI에서 이제 새로운 기본 transitionSpec 속성을 제공합니다. (Ibcabd)
  • 장면 관리에 도움이 되는 새로운 SceneState 객체가 추가되었습니다. 또한 SceneState 및 NavigationEventState를 사용하는 새로운 NavDisplay 오버로드를 제공합니다. (Idfb46, b/444479133)
  • 이제 NavDisplay에서 Transition의 currentState 및 targetState를 확인하여 이동하는 Scene에 따라 전환을 맞춤설정할 수 있습니다. (I906cc, b/443872322)
  • 이제 NavigationEventInfo는 interface가 아닌 abstract class입니다. 클래스(예: data class MyInfo : NavigationEventInfo())에서 상속하도록 모든 맞춤 구현을 업데이트합니다. (I1e59c, b/444734264)
  • navigationevent-compose 핸들러 API가 업데이트되었습니다. 이제 NavigationEventHandler 및 NavigationBackHandler(및 변형)은 호이스팅된 NavigationEventState를 허용하는 새로운 오버로드를 지원합니다. 단순 오버로드(currentInfo 사용)는 보존되며 이제 내부적으로 이 새로운 상태 모델을 사용합니다. (Ic3251, b/444734264)
  • 모든 Scene API가 navigation3-ui에서 navigation3-runtime으로 이동했습니다. 즉, 이제 navigation3-runtime에서 지원하는 모든 플랫폼에서 사용할 수 있습니다. (I431d0, b/444449993)
  • 장식할 NavEntry 목록을 사용하는 새 rememberDecoratedNavEntries 오버로드가 추가되었습니다. 입력 항목은 이미 다른 항목 데코레이터로 장식되어 있을 수 있습니다. (I5a034, b/444230270)
  • navigation3 와일드 카드 유형 매개변수를 삭제합니다. (I02540)
  • entryProvider DSL의 제네릭 처리가 개선되었습니다. 이전에 androidx.navigation3.runtime.entry를 가져온 경우 더 이상 필요하지 않습니다. (I299fc)
  • 리플렉션 기반 NavBackStackSerializer 오버로드를 Android로 제한합니다. 이렇게 하면 멀티플랫폼 코드에서 명시적 SavedStateConfiguration 오버로드를 강제로 사용하여 Android 이외의 플랫폼에서 암시적 런타임 직렬화 실패를 방지할 수 있습니다. (I73313, b/420443609)
  • NavigationEvent의 swipeEdge을 @IntDef로 만드세요 (Icee54, b/443950342)
  • NavBackStack 직렬화를 Android로 제한합니다. 이렇게 하면 Android 이외의 플랫폼에서 런타임 오류가 방지됩니다. 멀티플랫폼 상태 저장을 위해 명시적 SavedStateConfiguration와 함께 rememberNavBackStack 오버로드를 사용합니다. (I1e418, b/420443609)

버그 수정

  • 중첩된 NavDisplay에 단일 하위 항목이 있는 경우 뒤로 탐색 예측 중에 발생하는 비정상 종료 문제를 수정했습니다. (I2cdc0, b/441933162)

버전 1.0.0-alpha09

2025년 9월 10일

androidx.navigation3:navigation3-*:1.0.0-alpha09이 출시되었습니다. 버전 1.0.0-alpha09에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • DecoratedNavEntryProvider가 제공된 데코레이터 목록으로 데코레이팅된 NavEntries를 만들고 반환하는 rememberDecoratedNavEntries로 대체되었습니다. (I0fe1c, b/441328236)
  • NavBackStack는 이제 NavKey 유형에 대해 일반적입니다. 이렇게 하면 앱과 라이브러리가 NavKey로 제한되지 않고 백 스택의 맞춤 키 유형을 정의할 수 있습니다. (I4d190,Iad2f4, b/420443609)
  • NavBackStack가 이제 @kotlinx.serialization.Serializable이므로 추가 상용구 없이 프로세스 종료 및 구성 변경 전반에서 탐색 상태를 저장하고 복원할 수 있습니다. (I2c3cf, b/420443609)
  • RememberNavBackStack가 모든 플랫폼 타겟에 제공되도록 commonMain로 이동되었습니다. (Id69e7, b/420443609)

버그 수정

  • 이제 NavDisplay가 각 NavEntry를 올바른 Lifecycle.State로 올바르게 이동합니다. (I30aac, b/440145700)
  • NavDisplay가 NavigationEvent 라이브러리의 LocalNavigationEventDispatcherOwner를 통해 설정된 중첩된 NavigationEventDispatcherOwner를 무시하는 문제가 해결되었습니다. (I6224a)

종속 항목 변경사항

버전 1.0.0-alpha08

2025년 8월 27일

androidx.navigation3:navigation3-*:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 새 Kotlin 멀티플랫폼(KMP) 타겟을 Navigation3 Runtime 아티팩트에 추가했습니다. Navigation3 Runtime는 이제 JVM(Android 및 데스크톱), 네이티브(Linux, iOS, watchOS, macOS, MinGW), 웹(JavaScript, WasmJS) 플랫폼을 지원합니다. (I55078, b/424410398, b/419294028, b/419046226) 참고: Navigation3 UI 아티팩트의 KMP 타겟은 제공되지 않습니다. 다른 플랫폼에서는 자체 커스텀 NavDisplay를 구현해야 합니다. 이 기능이 지원되기를 원한다면 여기에서 Jetbrains 문제에 투표하고 추가 지원 진행 상황을 추적하세요.
  • 이제 NavDisplayInfo 객체가 공개되며 NavDisplay에서 표시되는 항목 목록을 가져오는 데 사용할 수 있습니다. (Ibc91f)

API 변경사항

  • 상태 복원을 실행하기 위해 rememberNavBackStack과 함께 사용할 새 NavBackStackSerializer를 추가했습니다. 이제 rememberNavBackStack()는 자체 구성을 제공하는 데 사용할 수 있는 SavedStateConfiguration도 사용합니다. (I2f4d2, I4cd58, b/420443609)

버그 수정

알려진 문제

  • I8bf6d에서 도입된 버그로 인해 수명 주기가 개별 항목이 아닌 장면에 기반하여 NavEntry에 제공된 key가 String가 아니거나 NavEntry가 contentKey를 재정의하지 않고 key와 동일하게 설정한 경우 수명 주기가 중단되었습니다. 이렇게 하면 키를 Bundle에 저장할 수 있습니다. 이 문제는 다음 출시에서 수정되었습니다. (b/440145700)

버전 1.0.0-alpha07

2025년 8월 13일

androidx.navigation3:navigation3-*:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에는 이러한 커밋이 포함되어 있습니다.

MinSdk 업데이트

API 변경사항

  • 이제 SavedStateNavEntryDecorator는 SaveableStateProvider에 내장된 SaveableStateRegistry를 사용하여 상태를 저장하고 복원합니다. (If8d9a)
  • 이제 predictivePopTransitionSpec에 스와이프 가장자리가 매개변수로 제공되므로 사용자가 뒤로 탐색 예측 동작을 시작한 가장자리에 따라 전환을 맞춤설정할 수 있습니다. (I753a8)

버그 수정

  • 최근 장면이 기억되지 않아 커스텀 장면이 무한히 다시 계산되는 문제가 해결되었습니다. (I7ba84, b/418153031)

종속 항목 업데이트

버전 1.0.0-alpha06

2025년 7월 30일

androidx.navigation3:navigation3-*:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

종속 항목 업데이트

버전 1.0.0-alpha05

2025년 7월 2일

androidx.navigation3:navigation3-*:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

동작 변경사항

  • 이제 NavEntry의 상태는 NavDisplay에 전달된 현재 데코레이터 목록을 엄격하게 기반으로 합니다. 즉, 백 스택의 NavEntries 상태를 유지하려면 여러 백 스택이 있는 경우 백 스택을 따라 데코레이터를 교체해야 합니다. 그렇지 않으면 항목이 스왑이 아닌 팝된 것처럼 상태가 삭제됩니다. (I7a759, b/428033667)

버전 1.0.0-alpha04

2025년 6월 18일

androidx.navigation3:navigation3-*:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • NavEntry.content이(가) 이제 비공개입니다. NavEntry 콘텐츠를 호출하려면 호출하는 데 더 이상 key 매개변수가 필요하지 않은 새 NavEntry.Content() API를 호출합니다. (Icd0fd, b/420991203)
  • NavEntry.key이(가) 이제 비공개 필드입니다. NavEntry 및 관련 상태는 새 contentKeyFactory 람다에서 생성되고 NavEntry.key에서 생성된 저장 가능한 해시로 기본 설정되는 새 contentKey 필드로 식별해야 합니다. (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)

종속 항목 변경사항

  • Navigation3는 이제 새로운 androidx.navigationevent.compose 아티팩트에 종속됩니다.

버전 1.0.0-alpha03

2025년 6월 4일

androidx.navigation3:navigation3-*:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • Navigation3는 더 이상 교체되어 다른 backStack 인스턴스로 대체된 backStacks의 데코레이터 상태를 지우지 않습니다. (I28a42, b/415076044)

버전 1.0.0-alpha02

2025년 5월 23일

androidx.navigation3:navigation3-*:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 동일한 속성 값을 가진 서로 다른 데이터 클래스에 충돌을 일으키는 SavedStateNavEntryDecorator 문제가 해결되었습니다. (b/418070648, Iff4775)
  • 명시적 종속 항목을 선언하지 않고 실행할 때 비정상 종료를 일으키는 클래스 누락 문제가 해결되었습니다. (b/419049149, I4b4ed)

버전 1.0.0-alpha01

2025년 5월 20일

androidx.navigation3:navigation3-*:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

Navigation3는 Jetpack Compose 인앱 탐색을 처리하기 위해 특별히 빌드된 새로운 탐색 라이브러리입니다. androidx.navigation3.runtime 아티팩트는 구성 요소를 제공하고 androidx.navigation3.ui 아티팩트는 NavDisplay API를 통해 UI 레이어를 제공합니다. 개발자는 자체 상태를 NavDisplay 컴포저블 함수에 직접 제공할 수 있으며, 이 함수는 개발자 상태의 변경사항에 따라 콘텐츠를 변경합니다.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

자세한 내용은 Navigation3 가이드를 참고하세요.