navigation3
| 최근 업데이트 | 안정화 버전 | 출시 후보 버전 | 베타 버전 | 알파 버전 |
|---|---|---|---|---|
| 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/430807423DeferredAnimatedContent는DeferredTransition를 사용하여 전환을 지연 단계(defer를 통해)와 자동 단계(animateTo를 통해)로 분리합니다. 지연 단계에서는 스와이프 동작 중에 수동 변환을 적용하고 자동 단계에서는 스와이프가 커밋될 때 전환을 실행합니다.
알려진 문제
- 공유 요소가 전환 중에 들어오는 장면이 아닌 나가는 장면에 렌더링됩니다. (b/582354988)
- 공유 요소는 지연된(동작) 단계에서 탐색하지 않습니다.
Navigation3 버전 1.2
버전 1.2.1
2026년 11월 4일
androidx.navigation3:navigation3-*:1.2.1이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.
변경사항
compileSdk이(가) 37에서 36으로 다운그레이드되었습니다. 버전 1.2는compileSdk37이 필요하지 않은 Compose1.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 문자열 또는 AndroidIntent에서 생성된 딥 링크 요청을 나타냅니다.requestExtrasDSL 및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는requestExtrasDSL로 인스턴스화할 수 있습니다. (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'sT 상한이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를 반환하는rememberResultEventBusAPI를 추가했습니다. 이렇게 하면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) - 추가 항목의 맵을 빌드하는 유형 안전 방식으로 새로운
requestExtrasdsl이 추가되었습니다. 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를 발생시키는 대신 nullUriMatchResult을 반환하도록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에서 예외를 발생시키는 대신 nullUriMatchResult를 반환합니다. (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 ?: HomeKeyandroid.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 간에 결과를 전달할 수 있도록ResultEventBusAPI를 추가했습니다. 전달된 결과는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)
Navigation3 버전 1.1
버전 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에 포함된 커밋을 확인하세요.
버그 수정
- 이제
entryProviderDSL은 키 클래스(예: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의NavMetadataKeyDialogKey를 추가했습니다. (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가 추가되어 새로운metadataDSL과 함께 사용하여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)
종속 항목 업데이트
Navigation31.0.1부터:Navigation3가 이제NavigationEvent1.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에는 이러한 커밋이 포함되어 있습니다.
새로운 기능
- 이제
EntryProviderDSL을 통해 항목 키를 고려하여 메타데이터를 동적으로 추가할 수 있습니다. (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는 이제NavigationEvent1.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)
entryProviderDSL의 제네릭 처리가 개선되었습니다. 이전에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)
종속 항목 변경사항
- Navigation3는 이제 NavigationEvent Alpha08에 종속됩니다.
버전 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, b/425901162, b/434109022)
알려진 문제
- 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 업데이트
- AndroidX의 기본 minSdk가 API 21에서 API 23으로 이동했습니다. (Ibdfca, b/380448311, b/435705964, b/435705223)
API 변경사항
- 이제
SavedStateNavEntryDecorator는SaveableStateProvider에 내장된SaveableStateRegistry를 사용하여 상태를 저장하고 복원합니다. (If8d9a) - 이제
predictivePopTransitionSpec에 스와이프 가장자리가 매개변수로 제공되므로 사용자가 뒤로 탐색 예측 동작을 시작한 가장자리에 따라 전환을 맞춤설정할 수 있습니다. (I753a8)
버그 수정
- 최근 장면이 기억되지 않아 커스텀 장면이 무한히 다시 계산되는 문제가 해결되었습니다. (I7ba84, b/418153031)
종속 항목 업데이트
- Navigation3는 이제 Navigation Event
1.0.0-alpha06에 종속됩니다.
버전 1.0.0-alpha06
2025년 7월 30일
androidx.navigation3:navigation3-*:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.
종속 항목 업데이트
- Navigation3는 이제 Navigation Event
1.0.0-alpha05에 종속됩니다.
버전 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 가이드를 참고하세요.