使用CardStackView构建Tinder克隆App遇布局渲染错误求助

我跟着YouTube教程做Tinder安卓克隆应用，用了GitHub上的CardStackView控件，严格按步骤操作还是遇到布局渲染问题。这是我第一次在Stack Overflow提问，有不当之处请见谅。

布局代码 #

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".userinterface.HomeFragment">

    <com.yuyakaido.android.cardstackview.CardStackView
        android:contentDescription="card description"
        android:layout_height="match_parent"
        android:layout_width="match_parent"
        android:id="@+id/cardStackView"
        android:layout_centerInParent="true"
        tools:listitem="@layout/item_user_layout" />
</RelativeLayout>

错误信息 #

java.lang.reflect.InvocationTargetException
    at jdk.internal.reflect.GeneratedMethodAccessor4611.invoke(Unknown Source)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
    at com.android.layoutlib.common.util.ReflectionUtils.invoke(ReflectionUtils.java:80)
    at com.android.layoutlib.bridge.android.support.RecyclerViewUtil.setProperty(RecyclerViewUtil.java:139)
    at com.android.layoutlib.bridge.android.support.RecyclerViewUtil.setProperty(RecyclerViewUtil.java:133)
    at com.android.layoutlib.bridge.android.support.RecyclerViewUtil.setLayoutManager(RecyclerViewUtil.java:96)
    at com.android.layoutlib.bridge.android.support.RecyclerViewUtil.setAdapter(RecyclerViewUtil.java:69)
    at android.view.BridgeInflater.setupViewInContext(BridgeInflater.java:473)
    at android.view.BridgeInflater.createViewFromTag(BridgeInflater.java:356)
    at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:965)
    at android.view.LayoutInflater.rInflate_Original(LayoutInflater.java:1127)
    at android.view.LayoutInflater_Delegate.rInflate(LayoutInflater_Delegate.java:72)
    at android.view.LayoutInflater.rInflate(LayoutInflater.java:1101)
    at android.view.LayoutInflater.rInflateChildren(LayoutInflater.java:1088)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:686)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:505)
    at com.android.layoutlib.bridge.impl.RenderSessionImpl.inflate(RenderSessionImpl.java:365)
    at com.android.layoutlib.bridge.Bridge.createSession(Bridge.java:450)
    at com.android.tools.idea.layoutlib.LayoutLibrary.createSession(LayoutLibrary.java:122)
    at com.android.tools.rendering.RenderTask.createRenderSession(RenderTask.java:742)
    at com.android.tools.rendering.RenderTask.lambda$inflate$7(RenderTask.java:889)
    at com.android.tools.rendering.RenderExecutor$runAsyncActionWithTimeout$3.run(RenderExecutor.kt:202)
    at com.android.tools.rendering.RenderExecutor$PriorityRunnable.run(RenderExecutor.kt:316)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635)
    at java.base/java.lang.Thread.run(Thread.java:833)
Caused by: java.lang.IllegalArgumentException: CardStackView must be set CardStackLayoutManager.
    at com.yuyakaido.android.cardstackview.CardStackView.setLayoutManager(CardStackView.java:35)
    ... 27 more

解决方法 #

这个错误的核心是CardStackView必须使用专属的CardStackLayoutManager，Android Studio布局预览器默认会尝试设置普通LayoutManager，导致冲突。

1. 代码中手动设置LayoutManager #

在你的HomeFragment的onViewCreated方法里，初始化并绑定CardStackLayoutManager：

Kotlin示例：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val cardStackView = view.findViewById<CardStackView>(R.id.cardStackView)
    val layoutManager = CardStackLayoutManager(requireContext())
    cardStackView.layoutManager = layoutManager
    // 后续设置你的Adapter
    // cardStackView.adapter = YourCustomAdapter()
}

Java示例：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    CardStackView cardStackView = view.findViewById(R.id.cardStackView);
    CardStackLayoutManager layoutManager = new CardStackLayoutManager(getContext());
    cardStackView.setLayoutManager(layoutManager);
    // 后续设置你的Adapter
    // cardStackView.setAdapter(yourCustomAdapter);
}

2. 修复布局预览问题 #

如果想让Android Studio的布局预览正常显示，给CardStackView添加tools:layoutManager属性，指定正确的布局管理器：

修改后的布局代码片段：

<com.yuyakaido.android.cardstackview.CardStackView
    android:contentDescription="card description"
    android:layout_height="match_parent"
    android:layout_width="match_parent"
    android:id="@+id/cardStackView"
    android:layout_centerInParent="true"
    tools:listitem="@layout/item_user_layout"
    tools:layoutManager="com.yuyakaido.android.cardstackview.CardStackLayoutManager" />

内容的提问来源于stack exchange，提问作者Sandeep Sharma