设置Android PreferenceFragment的正确方法是什么？

Question

我正在尝试在Android应用程序中实现基本设置活动，并且出现黑屏或崩溃。我看过的文档和样本没有帮助，因为它们太旧或不一致。例如，根据您的外观，设置活动应扩展Activity，PreferenceActivity或AppCompatPreferenceActivity（“文件”>“新建”>“活动”>“设置”活动的一部分）。

developer.android.com说您应该实现以下功能：

public class SettingsActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Display the fragment as the main content.
        getFragmentManager().beginTransaction()
            .replace(android.R.id.content, new SettingsFragment())
            .commit();
    }
}

但是，在Android Studio中使用的“设置活动”不会对其创建的三个片段中的任何一个进行调用。它使用首选项标头。

所以这是我的问题：

1. 如果您使用的是带有单个PreferenceFragment的简单，单个preferences.xml文件，并且不需要API 19之前的兼容性，那么SettingsActivity应该扩展哪个类？Activity，PreferenceActivity或AppCompatPreferenceActivity（针对其所有支持方法和委托）？
2. 您是否需要调用getFragmentManager().beginTransaction().replace(android.R.id.content, new SettingsFragment()).commit()SettingsActivity.onCreate（）？
3. 通过各种组合，我会得到空白的白色设置屏幕，没有操作栏或崩溃。在显示应用程序操作栏的活动中设置单个PreferencesFragment的正确方法是什么？

Answer 1

假设我们想要一个带有一个复选框首选项片段的设置屏幕，如下所示：

以下是有关如何构建设置活动的分步指南，您可以在其中添加一些首选项来切换或更改 Android 应用程序的配置：

1. 在模块的build.gradle文件中添加支持首选项片段的依赖项app：

   dependencies {
       compile 'com.android.support:preference-v7:25.1.0'
   }
   

2. xml在res目录中添加Android 资源目录。

3. 在xml目录中，添加一个新XML resource file命名pref_visualizer.xml如下。我们将在其中添加一个复选框首选项片段。

   <?xml version="1.0" encoding="utf-8"?>
   <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
       <CheckBoxPreference
           android:defaultValue="true"
           android:key="show_base"
           android:summaryOff="Bass will not be shown currently."
           android:summaryOn="Bass will be shown currently."
           android:title="Show Bass"
           />
   </PreferenceScreen>
   

   PreferenceScreen是根标签，可以根据需要保存尽可能多的首选项片段。如果要添加更多类型列表或文本框的配置，则需要在此处将其添加为PreferenceScreen标签的子项。

4. 添加一个名为的新 Java 类SettingsFragment，它将托管PreferenceScreen. 它应该扩展PreferenceFragmentCompat类，如下所示：

   import android.content.SharedPreferences;
   import android.content.SharedPreferences.OnSharedPreferenceChangeListener;
   import android.os.Bundle;
   import android.support.v7.preference.CheckBoxPreference;
   import android.support.v7.preference.EditTextPreference;
   import android.support.v7.preference.ListPreference;
   import android.support.v7.preference.Preference;
   import android.support.v7.preference.PreferenceFragmentCompat;
   import android.support.v7.preference.PreferenceScreen;
   import android.widget.Toast;
   
   
   public class SettingsFragment extends PreferenceFragmentCompat {
   
   
   @Override
   public void onCreatePreferences(Bundle bundle, String s) {
           addPreferencesFromResource(R.xml.pref_visualizer);
       }
   }
   

5. 现在是最后一部分，我们在应用程序中的 Activity 和SettingsFragment托管PreferenceScreen. 添加一个SettingsActivity从AppCompatActivity类继承的名为的新活动。SettingsActivity类将充当PreferenceScreen.

Java 文件SettingsActivity：

import android.support.v4.app.NavUtils;
import android.support.v7.app.ActionBar;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.MenuItem;

public class SettingsActivity extends AppCompatActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_settings);
}

}

布局文件SettingsActivity如下所示（activity_settings.xml）。在这里，android.name财产是关键。它将此活动连接到从PreferenceFragmentCompat类继承的整个项目中存在的任何类。我只有一个这样的类，名为SettingsFragment. PreferenceFragmentCompat如果您的应用程序有多个设置屏幕，您可能有多个类继承自类。

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/activity_settings"
    android:name="android.example.com.visualizerpreferences.SettingsFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

你都准备好了！

Answer 2

SettingsActivity 应该扩展什么类？

对我有用的是扩展AppCompatActivity。

static final String ANIMATION = "animation" ;
static final String COUNTDOWN_ON_OFF = "countdown_on_off";

@Override
protected void onCreate(Bundle savedInstanceState)
{
    super.onCreate(savedInstanceState);

    if (getFragmentManager().findFragmentById(android.R.id.content) == null)
    {
        getFragmentManager().beginTransaction().add(android.R.id.content, new Prefs()).commit();
    }
}

我踢出了所有与首选项标头相关的生成代码，并为我保留了一些模板方法/变量（Android Studio 在某些早期版本中生成的）PreferenceFragment

public static class Prefs extends PreferenceFragment
{
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.preferences);

        // Bind the summaries of EditText/List/Dialog/Ringtone preferences
        // to their values. When their values change, their summaries are
        // updated to reflect the new value, per the Android Design
        // guidelines.

        // findPreference() uses android:key like in preferences.xml !

        bindPreferenceSummaryToValue(findPreference(ANIMATION));

    }
}

我的类中的静态方法Activity（改编自模板）。您可能需要检查其他偏好类型：

 /**
 * Binds a preference's summary to its value. More specifically, when the
 * preference's value is changed, its summary (line of text below the
 * preference title) is updated to reflect the value. The summary is also
 * immediately updated upon calling this method. The exact display format is
 * dependent on the type of preference.
 *
 * @see #sBindPreferenceSummaryToValueListener
 */
private static void bindPreferenceSummaryToValue(Preference preference)
{
    // Set the listener to watch for value changes.
    preference.setOnPreferenceChangeListener(sBindPreferenceSummaryToValueListener);

    // Trigger the listener immediately with the preference's
    // current value.

    if (preference instanceof CheckBoxPreference)
    {
        sBindPreferenceSummaryToValueListener.onPreferenceChange(preference,
                                                                 PreferenceManager
                                                                         .getDefaultSharedPreferences(preference.getContext())
                                                                        .getBoolean(preference.getKey(), true));
    }
    else
    {
        sBindPreferenceSummaryToValueListener.onPreferenceChange(preference,
                                                                 PreferenceManager
                                                                         .getDefaultSharedPreferences(preference.getContext())
                                                                         .getString(preference.getKey(), ""));
    }
}

最后，Preference.OnPreferenceChangeListeneras static 变量Activity（也改编自模板）：

   /**
 * A preference value change listener that updates the preference's summary
 * to reflect its new value.<br>
 * template by Android Studio minus Ringtone Preference
 */
private static Preference.OnPreferenceChangeListener sBindPreferenceSummaryToValueListener = new Preference.OnPreferenceChangeListener()
{
    @Override
    public boolean onPreferenceChange(Preference preference, Object value)
    {
        String stringValue = value.toString();

        if (preference instanceof ListPreference)
        {
            // For list preferences, look up the correct display value in
            // the preference's 'entries' list.
            ListPreference listPreference = (ListPreference) preference;
            int index = listPreference.findIndexOfValue(stringValue);

            // Set the summary to reflect the new value.
            preference.setSummary(
                    index >= 0
                            ? listPreference.getEntries()[index]
                            : null);

        }
        else if (preference instanceof RingtonePreference)
        {
            // my app didn't need that
            return true;
        }
        else if (preference instanceof CheckBoxPreference)
        {
            Context ctx = preference.getContext();
            boolean isChecked = (Boolean) value;

            if (preference.getKey().equals(ANIMATION))
            {
                preference.setSummary(isChecked ? ctx.getString(R.string.sOn) : ctx.getString(R.string.sOff));
            }
            else if (preference.getKey().equals(COUNTDOWN_ON_OFF))
            {
                preference.setSummary(isChecked ? ctx.getString(R.string.sWhenPaused) : ctx.getString(R.string.sNever) );
            }
        }
        else
        {
            // For all other preferences, set the summary to the value's
            // simple string representation.
            preference.setSummary(stringValue);
        }
        return true;
    }
};
}