Android Codelab中RecyclerView相关应用崩溃问题求助

核心错误信息 #

java.lang.IllegalStateException: You need to use a Theme.AppCompat theme (or descendant) with this activity

问题根源 #

你使用了AndroidX库中的组件（如RecyclerView、Fragment），这类组件要求承载它们的Activity必须继承AppCompatActivity，并且应用的主题必须是Theme.AppCompat或其子类主题。当前你的Activity主题不符合这个要求，导致崩溃。

解决步骤 #

1. 修正Activity继承关系 #

确保宿主Activity继承自androidx.appcompat.app.AppCompatActivity，而非原生Activity：

class YourHostActivity : AppCompatActivity() {
    // 你的Activity逻辑代码
}

2. 配置AppCompat主题 #

在res/values/styles.xml中定义AppCompat系列主题：

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="colorPrimary">@color/colorPrimary</item>
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
    <item name="colorAccent">@color/colorAccent</item>
</style>

然后在AndroidManifest.xml中为对应Activity指定该主题：

<activity
    android:name=".YourHostActivity"
    android:theme="@style/AppTheme">
    <!-- 其他Activity配置项 -->
</activity>

3. 可选：使用Material Components主题 #

如果项目依赖Material Components库，也可以使用其主题（属于AppCompat后代）：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
    <!-- 自定义属性 -->
</style>

额外说明 #

你提供的Fragment和布局代码本身无问题，崩溃完全由Activity主题配置错误导致。按上述步骤修改后即可解决问题。

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