Swiperefreshlayout

스와이프하여 새로고침 UI 패턴을 구현합니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2025년 2월 12일 1.1.0 - 1.2.0-beta01 -

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
}

Kotlin

dependencies {
    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.2.0

버전 1.2.0-beta01

2025년 2월 12일

androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에는 이 커밋이 포함되어 있습니다.

API 변경사항

  • SwipeRefreshLayout 메서드 매개변수 및 반환 유형의 null 허용 여부를 지정했습니다. (I006d1, b/236497776)

버그 수정

  • 이제 이 라이브러리는 유형 사용인 JSpecify nullness 주석을 사용합니다. Kotlin 개발자는 올바른 사용을 적용하기 위해 다음 컴파일러 인수 -Xjspecify-annotations=strict를 사용해야 합니다 (Kotlin 컴파일러 버전 2.1.0부터 기본값임). (Iaf490, b/326456246)

버전 1.2.0-alpha01

2020년 7월 22일

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

버그 수정

  • requestDisallowInterceptTouchEvent(boolean)은 이제 다른 ViewGroup과 마찬가지로 요청을 반영합니다. 새 동작을 setLegacyRequestDisallowInterceptTouchEventEnabled를 통해 사용 중지할 수 있지만 그러지 않는 것이 좋습니다. (I968da, b/141855018)

버전 1.1.0

버전 1.1.0

2020년 6월 24일

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

1.0.0 이후 주요 변경사항

  • 이제 SwipeRefreshLayout이 NestedScrollingChild3 및 NestedScrollingParent3을 구현합니다.

버전 1.1.0-rc01

2020년 4월 15일

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

버전 1.1.0-beta01

2020년 3월 4일

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

버전 1.1.0-alpha03

2019년 10월 9일

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

새로운 기능

  • 진행률 표시기의 배경 색상을 설정하는 새 스타일 속성 R.styleable.SwipeRefreshLayout_swipeRefreshLayoutProgressSpinnerBackgroundColor가 있습니다. (aosp/931124 참조)

API 변경사항

  • 이제 requestDisallowInterceptTouchEvent(boolean)는 항상 상위 요소에 전파됩니다. 새 동작을 setLegacyRequestDisallowInterceptTouchEventEnabled를 통해 사용 중지할 수 있지만 그러지 않는 것이 좋습니다. (aosp/1108540 참조)

버그 수정

  • SwipeRefreshLayout에 스크롤 가능한 상위 요소(예: ViewPager2)와 스크롤 가능한 하위 요소가 있는 중첩 스크롤에서 발생하는 문제를 해결했습니다. (b/138314213 참조)

버전 1.1.0-alpha02

2019년 7월 2일

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

버그 수정

  • SwipeRefreshLayout의 새로 고침 상태 저장 및 복원 구현
  • SwipeRefreshLayout가 RecyclerView에 삽입될 때 발생하는 사용성 버그 수정

버전 1.1.0-alpha01

2018년 12월 3일

API 변경사항

  • aosp/737631: SwipeRefreshLayout은 이제 NestedScrollingChild3 및 NestedScrollingParent3을 구현하여 3개의 상위 요소와 하위 요소를 중첩 스크롤해 SwipeRefreshLayout을 통해 소비된 중첩 스크롤 거리를 전달할 수 있습니다. 현재 개발자 코드가 SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int)을 재정의하는 경우 이 메서드는 더 이상 호출되지 않으므로 대신 SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int, int[])을 재정의해야 합니다. 마찬가지로 SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int)이 더 이상 호출되지 않으며 대신 SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int, int[])을 재정의해야 합니다.