AndroidX 子类中 SharedPreferences 空指针异常：原因和解决方案

Android

2024-03-20 18:39:22

在 AndroidX 中子类的 SharedPreferences 空指针异常：原因和解决方案

前言

将旧类升级到 AndroidX 库时，您可能会遇到在尝试获取子类中的 SharedPreferences 时抛出的空指针异常。本博客文章将深入探讨此问题的根源并提供逐步解决方案，帮助您避免此类错误并顺利升级您的应用程序。

问题概述

在 AndroidX 中，PreferenceActivity 类已被弃用，因此需要使用替代方法来管理首选项。如果不进行必要的调整，在子类中获取 SharedPreferences 时就会导致空指针异常。

解决方案

为了解决此问题并有效地管理首选项，请遵循以下步骤：

1. 创建 PreferenceFragmentCompat

在您的活动类中，创建PreferenceFragmentCompat类的实例。此片段将承载您的首选项设置界面。

2. 在活动中使用 PreferenceFragmentCompat

在您的活动类的onCreate()方法中，使用getSupportFragmentManager()将PreferenceFragmentCompat添加到您的界面中。

3. 获取 SharedPreferences

现在，您可以通过PreferenceFragmentCompat访问SharedPreferences：

SharedPreferences prefs = fragment.getPreferenceManager().getSharedPreferences();

示例代码

下方的代码示例展示了如何实现上述步骤：

// 活动类
public class LatinIMESettings extends FragmentActivity {

    static class LatinIMESettingsFragment extends PreferenceFragmentCompat {
        @Override
        public void onCreatePreferences(@Nullable Bundle savedInstanceState, @Nullable String rootKey) {
            setPreferencesFromResource(R.xml.prefs, rootKey);
        }
    }
    LatinIMESettingsFragment fragment;

    @Override
    protected void onCreate(Bundle icicle) {
        fragment = new LatinIMESettingsFragment();
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.container, fragment)
                .commit();
        SharedPreferences prefs = fragment.getPreferenceManager().getSharedPreferences();
    }
}

其他注意事项

确保您的PreferenceFragmentCompat正确配置为加载首选项资源文件。
请务必在onDestroy()方法中取消注册 SharedPreferences 更改监听器。

常见问题解答

为什么在 AndroidX 中PreferenceActivity类已弃用？
- PreferenceActivity类已被弃用，以支持更灵活的PreferenceFragmentCompat，它可以更轻松地集成到现有活动中。
我可以在PreferenceFragmentCompat中调用getPreferenceManager()之前，在活动中调用它吗？
- 不，您需要在PreferenceFragmentCompat中调用getPreferenceManager()，因为该类管理首选项设置界面。
如何处理 SharedPreferences 中的更改？
- 您可以在PreferenceFragmentCompat中注册 SharedPreferences 更改监听器，以便在更改首选项时收到通知。
我可以在子类中获取 SharedPreferences 的多个实例吗？
- 是，您可以获取 SharedPreferences 的多个实例，每个实例代表首选项文件中的不同键值对。
如果我在子类中找不到所需的键，该怎么办？
- 您应该使用contains()方法检查键是否存在，并在不存在时提供默认值。