如何修复 ViewPager2 中的“违反设计假设”错误？

Question

我正在使用 ViewPager2、Kotlin 和 AndroidX。 当适配器不在索引 0 并且我更改适配器列表并将当前项设置为索引 0 时，将引发异常。

java.lang.IllegalStateException: Design assumption violated.
        at androidx.viewpager2.widget.ViewPager2.updateCurrentItem(ViewPager2.java:538)
        at androidx.viewpager2.widget.ViewPager2$4.onAnimationsFinished(ViewPager2.java:518)
        at androidx.recyclerview.widget.RecyclerView$ItemAnimator.isRunning(RecyclerView.java:13244)
        at androidx.viewpager2.widget.ViewPager2.onLayout(ViewPager2.java:515)
        at android.view.View.layout(View.java:15596)

在 ViewPager2 的第 537 行有一个 if 导致异常：

        // Extra checks verifying assumptions
        // TODO: remove after testing
        View snapView1 = mPagerSnapHelper.findSnapView(mLayoutManager);
        View snapView2 = mLayoutManager.findViewByPosition(snapPosition);
        if (snapView1 != snapView2) {
            throw new IllegalStateException("Design assumption violated.");
        }

这就是我更新适配器列表的方式：

adapter.list = newList
adapter.notifyDataSetChanged()
viewpager.setCurrentItem(0, true)

仅当 smoothScroll 设置为 true 时才会发生这种情况

我错过了什么？

编辑： 我正在使用androidx.viewpager2.widget.ViewPager2 中的com.google.android.material:material:1.1.0-alpha08

Answer 1

ViewPager2 在配置更改时遇到了同样的问题。我正在使用：

implementation 'com.google.android.material:material:1.0.0'
implementation 'androidx.viewpager2:viewpager2:1.0.0-beta03'

在我的例子中，我在 FragmentStateAdapter 类中重写了 getItemId() 方法。当我摆脱我的getItemId() 方法后，“IllegalStateException：违反设计假设”错误就消失了！ :-)

Answer 2

我正在使用androidx.viewpager2:viewpager2:1.0.0

对于仍然坚持这一点并需要实施 getItemId() containsItem() 的人。请检查您的getItemId() 和containsItem() 实施。我的问题是，当我提供 10 件商品时，可能有几件商品具有相同的价值，会发生此错误。

媒体有多个具有相同值的数据。

private var mediaId = media.map { it.hashCode().toLong() }

override fun getItemId(position: Int): Long = mediaId[position]

override fun containsItem(itemId: Long): Boolean = mediaId.contains(itemId)

当您更新数据甚至只是滑动时，viewpager 会令人困惑，因为您使用非唯一 ID 实现 getItemId()。解决方案只是确保您的数据是唯一的或有自己的 ID。 *我的媒体数据没有id。

如果你打开getItemId()的实现请注意这部分：

• @return 稳定项目 ID {@link RecyclerView.Adapter#hasStableIds()}

您需要为每个项目提供唯一的 ID。

Answer 3

我遇到了同样的问题，但在当前版本androidx.viewpager2:viewpager2:1.0.0-beta01 中，该错误似乎已修复（至少对我而言）。

在ViewPager2 1.0.0-beta01 Release Notes中查看更多信息

Answer 4

这是一个简单用例的解决方案

import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentActivity
import androidx.viewpager2.adapter.FragmentStateAdapter

class ViewPager2Adapter(
val dataList: List<Item> = listOf(),
fragmentActivity: FragmentActivity
) :
FragmentStateAdapter(fragmentActivity) {

val pageIds= dataList.map { it.hashCode().toLong() }.toMutableList()

override fun createFragment(position: Int): Fragment {
    return MyFragment.newInstance(dataList[position])
}

override fun getItemCount(): Int {
    return dataList.size
}

override fun getItemId(position: Int): Long {
    return pageIds[position]
}

override fun containsItem(itemId: Long): Boolean {
    return pageIds.contains(itemId)
}
}

然后我遇到了一个特定的用例，当我用新的对象替换该位置的对象时，我得到了异常。

解决方案： 现在，如果您要对适配器进行数据更改，即用新对象替换 dataList 中的对象，请确保将旧对象的 pageIds 中的 id 替换为新对象。

(viewPager2.adapter as? ViewPager2Adapter)?.apply {
pageIds[oldIndex] = (NewItemObject).hashCode().toLong()
notifyItemChanged(oldIndex)
}

Answer 5

我的问题是我正在自定义 containsItem() 以具有一些条件，在这些条件下我从 ViewPager 中删除 Fragments，然后返回 false；

旋转手机后遇到Design assumption violated（然后刷ViewPager2）。

我通过返回超类方法解决了这个问题：return super.containsItem(itemId);

@Override
public boolean containsItem(long itemId) {
    // Your code
    return super.containsItem(itemId);
}

更新：

containsItem 方法没有“CallSuper”注解，因此不需要调用

这样就对了，不用调用super；在返回布尔值之前我没有明确调用它；只是返回它来解决这个问题