Savedstate

프로세스가 종료되면 UI 상태를 저장하고 프로세스가 다시 시작되면 복원하는 플러그형 구성요소를 작성합니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2024년 8월 7일 1.2.1 - - 1.3.0-alpha01

종속 항목 선언

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

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

Groovy

dependencies {
    // Java language implementation
    implementation "androidx.savedstate:savedstate:1.2.1"

    // Kotlin
    implementation "androidx.savedstate:savedstate-ktx:1.2.1"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.savedstate:savedstate:1.2.1")

    // Kotlin
    implementation("androidx.savedstate:savedstate-ktx:1.2.1")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.3

버전 1.3.0-alpha01

2024년 8월 7일

androidx.savedstate:savedstate:1.3.0-alpha01 및 androidx.savedstate:savedstate-ktx:1.3.0-alpha01이 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • 이제 savedstate-ktx Kotlin 확장 프로그램이 기본 savedstate 모듈로 이동했습니다. 추가했습니다. (I1cc18, b/274803094)

참고

  • compileSdk를 35로 업데이트합니다. (5dc41be)

버전 1.2.1

버전 1.2.1

2023년 3월 22일

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

종속 항목 업데이트

버전 1.2.0

버전 1.2.0

2022년 6월 29일

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

1.1.0 이후 중요 변경사항

  • 이제 SavedStateRegistryController가 performAttach()를 통해 SavedStateRegistry와 일찍 연결할 수 있습니다.
  • 이제 getSavedStateProvider()를 통해 SavedStateRegistry에서 이전에 등록된 SavedStateProvider를 검색할 수 있습니다.
  • SavedState 라이브러리가 Kotlin으로 다시 작성되었습니다.
    • SavedStateRegistryOwner의 경우 Kotlin으로 작성된 클래스에는 소스와 호환되지 않는 변경사항입니다. 이제 이전 getSavedStateRegistry() 함수를 구현하는 대신 savedStateRegistry 속성을 재정의해야 합니다.
    • ViewTreeSavedStateRegistryOwner의 경우 Kotlin으로 작성된 클래스에는 소스와 호환되지 않는 변경사항입니다. 이제 이전에 설정된 소유자를 설정하고 찾으려면 androidx.savedstate.setViewTreeSavedStateRegistryOwner와 androidx.savedstate.findViewTreeSavedStateRegistryOwner의 View에서 Kotlin 확장 메서드를 직접 가져와서 사용해야 합니다. 이는 findViewTreeSavedStateRegistryOwner의 savedstate-ktx API를 대체합니다.

동작 변경사항

  • SavedStateRegistry는 저장할 상태가 없는 경우 더 이상 빈 번들을 저장하지 않습니다.

버전 1.2.0-rc01

2022년 5월 11일

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

문서 변경사항

  • 인터페이스를 구현하는 방식 또는 SavedStateRegistryController에서 메서드를 호출해야 하는 경우에 대하여 소유자가 갖는 책임 및 계약을 명확하게 설명하기 위하여 SavedStateRegistryOwner Kdoc이 업데이트되었습니다. (Iefc95, b/228887344)

버전 1.2.0-beta01

2022년 4월 20일

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

API 변경사항

  • SavedStateRegistry 및 ViewTreeSavedStateRegistryOwner 클래스가 Kotlin으로 다시 작성되었습니다. ViewTreeSavedStateRegistryOwner의 경우 Kotlin으로 작성된 클래스에는 소스와 호환되지 않는 변경사항입니다. 이제 이전에 설정된 소유자를 설정하고 찾으려면 androidx.savedstate.setViewTreeSavedStateRegistryOwner와 androidx.savedstate.findViewTreeSavedStateRegistryOwner의 View에서 Kotlin 확장 메서드를 직접 가져와서 사용해야 합니다. 이는 findViewTreeSavedStateRegistryOwner의 savedstate-ktx API를 대체합니다. 자바 프로그래밍 언어로 작성된 구현의 경우 바이너리와 호환되고 소스와 호환됩니다. (b/220191285)

버전 1.2.0-alpha02

2022년 4월 6일

androidx.savedstate:savedstate:1.2.0-alpha02 및 androidx.savedstate:savedstate-ktx:1.2.0-alpha02가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 getSavedStateProvider()를 통해 SavedStateRegistry에서 이전에 등록된 SavedStateProvider를 검색할 수 있습니다. (I7ea47, b/215406268)

API 변경사항

  • SavedStateRegistryOwner, SavedStateRegistryController, Recreator 클래스가 Kotlin으로 다시 작성되었습니다. SavedStateRegistryOwner의 경우 Kotlin으로 작성된 클래스에는 소스와 호환되지 않는 변경사항입니다. 이제 이전 getSavedStateRegistry() 함수를 구현하는 대신 savedStateRegistry 속성을 재정의해야 합니다. 자바 프로그래밍 언어로 작성된 구현의 경우 바이너리와 호환되고 소스와 호환됩니다. (b/220191285)

버전 1.2.0-alpha01

2022년 1월 26일

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

새로운 기능

  • 이제 SavedStateRegistryController가 performAttach()를 통해 SavedStateRegistry와 일찍 연결할 수 있습니다. (Ice4bf)

동작 변경사항

  • SavedStateRegistry는 저장할 상태가 없는 경우 더 이상 빈 번들을 저장하지 않습니다. (aosp/1896865, b/203457956)

버전 1.1.0

버전 1.1.0

2021년 2월 10일

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

1.0.0 이후 주요 변경사항

  • ViewTreeSavedStateRegistryOwner API: 새로운 ViewTreeSavedStateRegistryOwner.get(View) API를 사용하면 지정된 View 인스턴스에 포함된 SavedStateRegistry를 가져올 수 있습니다. 이를 올바르게 사용하려면 Activity 1.2.0, Fragment 1.3.0, AppCompat 1.3.0-alpha01 이상으로 업그레이드해야 합니다.
  • savedstate-ktx 아티팩트: 새 savedstate-ktx 아티팩트가 ViewTreeSavedStateRegistryOwner와의 호환을 위해 findViewTreeSavedStateRegistryOwner() Kotlin 확장 메서드와 함께 추가되었습니다.

버전 1.1.0-rc01

2020년 12월 16일

androidx.savedstate:savedstate:1.1.0-rc01 및 androidx.savedstate:savedstate-ktx:1.1.0-rc01 버전은 1.1.0-beta01 이후 변경사항 없이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

버전 1.1.0-beta01

2020년 10월 1일

androidx.savedstate:savedstate:1.1.0-beta01 및 androidx.savedstate:savedstate-ktx:1.1.0-beta01 버전은 1.1.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha01

2020년 5월 20일

androidx.savedstate:savedstate:1.1.0-alpha01 및 androidx.savedstate:savedstate-ktx:1.1.0-alpha01가 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 새로운 ViewTreeSavedStateRegistryOwner.get(View) API를 사용하면 View 인스턴스가 지정된 포함 SavedStateRegistry를 검색할 수 있습니다. Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05, AppCompat 1.3.0-alpha01로 업그레이드하여 올바르게 채워야 합니다. (aosp/1298679)
  • ViewTreeSavedStateRegistryOwner 작업을 위해 findViewTreeSavedStateRegistryOwner() Kotlin 확장 프로그램이 있는 새로운 savedstate-ktx 아티팩트가 추가되었습니다. (aosp/1299434)

버전 1.0.0

버전 1.0.0

2019년 9월 5일

androidx.savedstate:savedstate:1.0.0이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

SavedState 1.0.0의 주요 기능

androidx.savedstate에서 안정화 릴리스로 바뀌었습니다. 개발자가 restore/saveInstanceState 프로세스에 구성요소를 플러그인할 수 있는 API 세트입니다. API의 기본 진입점은 SavedStateRegistry이며 consumeRestoredStateForKey를 사용해 이전 savedstate를 검색하고 시스템에서 요청 시 savedstate를 제공하도록 registerSavedStateProvider 콜백을 등록하는 방법을 제공합니다.

버전 1.0.0-rc01

2019년 7월 2일

androidx.savedstate:savedstate:1.0.0-rc01이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버그 수정

  • 잘못된 proguard 규칙이 수정되었습니다. (b/132655499)

버전 1.0.0-beta01

2019년 5월 7일

androidx.savedstate:savedstate:1.0.0-beta01이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버전 1.0.0-alpha02

2019년 3월 13일

androidx.savedstate:savedstate:1.0.0-alpha02가 출시되었습니다. androidx.savedstate:savedstate는 savedstate 인프라를 단순화하고 SavedStateRegistry에서 제네릭을 삭제하도록 결정되었기 때문에 아티팩트 androidx.savedstate:savedstate-bundle 및 androidx.savedstate:savedstate-common을 단일 아티팩트로 결합합니다. 따라서 별도의 모듈이 필요하지 않습니다.

이 버전에 포함된 커밋의 전체 목록은 여기에서 확인할 수 있습니다.

새로운 기능

  • SavedStateRegistry.runOnNextRecreaction(Class<? extends AutoRecreated> clazz )가 추가되었습니다. 소유한 구성요소가 다시 시작되면 제공된 클래스가 인스턴스화되며 AutoRecreated.onRecreated 메서드가 실행됩니다.

API 변경사항

  • SavedStateRegistry<T>에서 제네릭이 삭제되었습니다.
  • AbstractSavedStateRegistry 및 BundlableSavedStateRegistry가 삭제되고 대신 간단한 SavedStateRegistry를 사용합니다.
  • BundleSavedStateRegistryOwner에서 SavedStateRegistryOwner로 이름이 변경되었습니다.

버전 1.0.0-alpha01

2018년 12월 17일

SavedState의 최초 릴리스입니다.

새로운 기능

androidx.savedstate는 개발자가 restore/saveInstanceState 프로세스에 구성요소를 플러그인할 수 있는 새로운 알파 API 세트입니다. API의 기본 진입점은 SavedStateRegistry<T>이며 consumeRestoredStateForKey를 통해 이전 savedstate를 검색하고 시스템에서 요청 시 savedstate를 제공하도록 registerSavedStateProvider 콜백을 등록하는 방법을 제공합니다.