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

问题描述 投票:4回答:3

我正在尝试在Android应用中实施基本设置活动,并获得空白屏幕或崩溃。我见过的文档和样本没有帮助,因为它们要么旧又不一致。例如,根据您的外观,设置活动应该扩展ActivityPreferenceActivity或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. 如果您使用的是一个简单的单个preferences.xml文件,并且只有一个PreferenceFragment和API之间的兼容性不是必需的,那么SettingsActivity应该扩展哪个类? Activity,PreferenceActivity或AppCompatPreferenceActivity(适用于所有支持方法和委派)?
  2. 你需要在SettingsActivity.onCreate()中调用getFragmentManager().beginTransaction().replace(android.R.id.content, new SettingsFragment()).commit()吗?
  3. 通过各种组合,我要么得到一个空白的白色设置屏幕,没有操作栏或崩溃。在显示应用操作栏的活动中设置单个PreferencesFragment的正确方法是什么?
android android-fragments android-actionbar settings preferences
3个回答
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();
    }
}

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

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.OnPreferenceChangeListener作为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;
    }
};
}

3
投票

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

enter image description here

以下是有关如何构建设置活动的分步指南,您可以在其中添加一些首选项以切换或更改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. 添加一个名为SettingsFragment的新Java类,它将托管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. 现在是最后一部分,我们在应用程序中的一个活动和主持SettingsFragmentPreferenceScreen类之间建立关联。添加一个名为SettingsActivity的新活动,该活动继承自AppCompatActivity类。 SettingsActivity类将作为PreferenceScreen的容器。

SettingsActivity的Java文件:

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"/>

你们都准备好了!


1
投票

这是关于Kotlin和android-x:

gradle这个:

implementation 'androidx.appcompat:appcompat:1.1.0-rc01'
implementation 'androidx.core:core-ktx:1.2.0-alpha02'
implementation 'androidx.constraintlayout:constraintlayout:2.0.0-beta2'
implementation 'com.google.android.material:material:1.1.0-alpha08'
implementation "androidx.preference:preference-ktx:1.1.0-rc01"
implementation 'androidx.core:core-ktx:1.2.0-alpha02'
implementation 'androidx.collection:collection-ktx:1.1.0'
implementation 'androidx.fragment:fragment-ktx:1.2.0-alpha01'

Manaktivitykkt

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        if (savedInstanceState == null)
            supportFragmentManager.commit { replace(android.R.id.content, PrefsFragment()) }
    }

    class PrefsFragment : PreferenceFragmentCompat() {
        override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
            setPreferencesFromResource(R.xml.preferences, rootKey)
        }
    }
}

的preferences.xml

<androidx.preference.PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">

  <androidx.preference.Preference android:title="hello"/>
</androidx.preference.PreferenceScreen>

0
投票

除了RBT给出的答案之外,还必须指定首选项主题,否则应用程序将崩溃并出现IllegalStateException。

在styles.xml文件中,只需在Activity的主题中添加以下行

<item name="preferenceTheme">@style/PreferenceThemeOverlay</item>
© www.soinside.com 2019 - 2024. All rights reserved.