Android TV升级库后ListPreference资源缺失及样式适配问题求助

问题1：ListPreference触发资源缺失崩溃 #

点击ListPreference时应用直接崩溃，报错日志如下：

FATAL EXCEPTION: main
Process: com.example.tv, PID: 5348
android.content.res.Resources$NotFoundException: Resource ID #0x0
at android.content.res.ResourcesImpl.getValue(ResourcesImpl.java:225)
at android.content.res.Resources.loadXmlResourceParser(Resources.java:2446)
at android.content.res.Resources.getLayout(Resources.java:1252)
at android.view.LayoutInflater.inflate(LayoutInflater.java:536)
at android.view.LayoutInflater.inflate(LayoutInflater.java:485)
at androidx.appcompat.app.AlertController$AlertParams.createListView(AlertController.java:989)
at androidx.appcompat.app.AlertController$AlertParams.apply(AlertController.java:965)
at androidx.appcompat.app.AlertDialog$Builder.create(AlertDialog.java:983)
at androidx.preference.PreferenceDialogFragmentCompat.onCreateDialog(PreferenceDialogFragmentCompat.java:161)
at androidx.fragment.app.DialogFragment.prepareDialog(DialogFragment.java:665)
at androidx.fragment.app.DialogFragment.onGetLayoutInflater(DialogFragment.java:579)
at androidx.fragment.app.Fragment.performGetLayoutInflater(Fragment.java:1752)
at androidx.fragment.app.FragmentStateManager.createView(FragmentStateManager.java:493)
at androidx.fragment.app.FragmentStateManager.moveToExpectedState(FragmentStateManager.java:261)
at androidx.fragment.app.FragmentManager.executeOpsTogether(FragmentManager.java:1899)
at androidx.fragment.app.FragmentManager.removeRedundantOperationsAndExecute(FragmentManager.java:1823)
at androidx.fragment.app.FragmentManager.execPendingActions(FragmentManager.java:1760)
at androidx.fragment.app.FragmentManager$5.run(FragmentManager.java:547)
at android.os.Handler.handleCallback(Handler.java:938)
at android.os.Handler.dispatchMessage(Handler.java:99)
at android.os.Looper.loopOnce(Looper.java:201)
at android.os.Looper.loop(Looper.java:288)
at android.app.ActivityThread.main(ActivityThread.java:7839)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:548)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1003)

问题2：临时修复导致样式异常 #

添加以下Activity主题配置可避免崩溃，但ListPreference弹出的是灰色悬浮弹窗，无法嵌入Fragment区域且不匹配原有TV样式：

<item name="dialogTheme">@style/Theme.MaterialComponents.Dialog</item>
<item name="alertDialogTheme">@style/Theme.MaterialComponents.Dialog</item>

问题3：添加SwitchCompat再次触发崩溃 #

手动在偏好布局中加入SwitchCompat后，启动设置Activity时直接崩溃，报错日志：

FATAL EXCEPTION: main
Process: com.test.tv, PID: 6016
java.lang.RuntimeException: Unable to start activity ComponentInfo{com.test.tv/com.test.tv.view.ActSettings}: android.content.res.Resources$NotFoundException: Resource ID #0x0
at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2817)
at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2892)
at android.app.ActivityThread.-wrap11(Unknown Source:0)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1593)
at android.os.Handler.dispatchMessage(Handler.java:105)
at android.os.Looper.loop(Looper.java:164)
at android.app.ActivityThread.main(ActivityThread.java:6541)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.Zygote$MethodAndArgsCaller.run(Zygote.java:240)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:767)
Caused by: android.content.res.Resources$NotFoundException: Resource ID #0x0
at android.content.res.ResourcesImpl.getValue(ResourcesImpl.java:204)
at android.content.res.Resources.loadXmlResourceParser(Resources.java:2133)
at android.content.res.Resources.getLayout(Resources.java:1142)
at android.view.LayoutInflater.inflate(LayoutInflater.java:421)
at android.view.LayoutInflater.inflate(LayoutInflater.java:374)
at androidx.appcompat.app.AppCompatDelegateImpl.setContentView(AppCompatDelegateImpl.java:751)
at androidx.appcompat.app.AppCompatActivity.setContentView(AppCompatActivity.java:197)
at com.test.tv.view.ActCommon.onCreate(ActCommon.java:81)
at com.test.tv.view.ActSettings.onCreate(ActSettings.java:21)
at android.app.Activity.performCreate(Activity.java:6975)
at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1213)
at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2770)

相关代码 #

ActSettings类 #

public class ActSettings extends FragmentActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.act_settings);
    }
}

act_settings布局 #

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <RelativeLayout
        android:layout_width="@dimen/_150sdp"
        android:layout_height="match_parent"
        android:background="@drawable/bg_home"
        android:layout_alignParentEnd="true">
        <fragment
            android:id="@+id/settingsFragment"
            android:name="com.test.tv.fragment.FragmentSettings"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />
    </RelativeLayout>
</RelativeLayout>

FragmentSettings类 #

public class FragmentSettings extends PreferenceFragmentCompat {

    @Override
    public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
        addPreferencesFromResource(R.xml.prefs);
    }

}

prefs.xml布局 #

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:key="prefs_screen"
    android:summary=""
    android:title="@string/settings">
    <PreferenceCategory
        android:key="version_category"
        android:title="@string/app_version">
        <PreferenceScreen
            android:selectable="true"
            android:key="app_version"
            android:title="">
        </PreferenceScreen>
    </PreferenceCategory>
    <PreferenceCategory
        android:key="language_settings_category"
        android:title="@string/language">
        <ListPreference
            android:icon="@drawable/ic_translate_24px"
            android:key="prefs_language"
            app:useSimpleSummaryProvider="true"
            android:title="@string/mod_language"
            android:entries="@array/pref_languages"
            android:entryValues="@array/pref_languages_values"
            android:enabled="true"
            android:selectable="true" />
        <PreferenceScreen
            android:selectable="false"
            android:key="prefs_need_restart"
            android:summary="@string/need_restart"
            android:title=""/>
    </PreferenceCategory>
</PreferenceScreen>

解决方案 #

1. 修复资源缺失崩溃根源 #

崩溃核心原因是设置页面主题未正确继承Leanback专为TV设计的偏好主题，导致Preference库无法找到所需的弹窗布局资源。

修改你的Activity主题，确保继承自Leanback设置主题：

<style name="SettingsTheme" parent="@style/Theme.Leanback.Settings">
    <!-- 保留原有主题配置，比如背景 -->
    <item name="android:windowBackground">@drawable/bg_home</item>
</style>

在AndroidManifest.xml中给ActSettings应用该主题：

<activity
    android:name=".view.ActSettings"
    android:theme="@style/SettingsTheme"/>

2. 让ListPreference弹窗嵌入Fragment并匹配TV样式 #

使用Leanback库提供的LeanbackListPreference替代原生ListPreference，它专为Android TV优化，弹窗会自动嵌入Fragment区域并沿用Leanback设置界面的样式：

首先确保依赖最新的Leanback偏好库：

implementation "androidx.leanback:leanback-preference:1.2.0"

然后修改prefs.xml中的ListPreference：

<androidx.leanback.preference.LeanbackListPreference
    android:icon="@drawable/ic_translate_24px"
    android:key="prefs_language"
    app:useSimpleSummaryProvider="true"
    android:title="@string/mod_language"
    android:entries="@array/pref_languages"
    android:entryValues="@array/pref_languages_values"
    android:enabled="true"
    android:selectable="true" />

3. 解决SwitchCompat资源缺失问题 #

同样使用Leanback提供的LeanbackSwitchPreferenceCompat替代原生SwitchCompat，它适配了TV的交互逻辑和主题资源：

<androidx.leanback.preference.LeanbackSwitchPreferenceCompat
    android:key="prefs_switch_example"
    android:title="@string/switch_title"
    android:defaultValue="false"/>

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