Swiperefreshlayout

声明依赖项

要添加 SwipeRefreshLayout 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

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

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 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)

bug 修复

• 此库现在使用 JSpecify nullness annotations，即类型使用。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[])。