使用 SharedPreferences 实现设置屏幕

SharedPreferences 的一个用途是在你的应用中实现设置屏幕,用户可以在其中设置其偏好/选项。像这样:

StackOverflow 文档

PreferenceScreen 在 SharedPreferences 中保存用户首选项。要创建 PreferenceScreen,你需要做一些事情:

用于定义可用选项的 XML 文件:

这在/res/xml/preferences.xml 中,对于上面的设置屏幕,它看起来像这样:

<PreferenceScreen
    xmlns:android="http://schemas.android.com/apk/res/android">
    <PreferenceCategory
        android:title="General options">
        <CheckBoxPreference
            android:key = "silent_mode"
            android:defaultValue="false"
            android:title="Silent Mode"
            android:summary="Mute all sounds from this app" />

        <SwitchPreference
            android:key="awesome_mode"
            android:defaultValue="false"
            android:switchTextOn="Yes"
            android:switchTextOff="No"
            android:title="Awesome mode™"
            android:summary="Enable the Awesome Mode™ feature"/>

        <EditTextPreference
            android:key="custom_storage"
            android:defaultValue="/sdcard/data/"
            android:title="Custom storage location"
            android:summary="Enter the directory path where you want data to be saved. If it does not exist, it will be created."
            android:dialogTitle="Enter directory path (eg. /sdcard/data/ )"/>
    </PreferenceCategory>
</PreferenceScreen>

这将定义设置屏幕中的可用选项。 Preference Class 上的 Android 开发者文档中列出了许多其他类型的 Preference

接下来,我们需要一个 Activity 来托管我们的 Preferences 用户界面。在这种情况下,它很短,看起来像这样:

package com.example.preferences;

import android.preference.PreferenceActivity;
import android.os.Bundle;

public class PreferencesActivity extends PreferenceActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.preferences);
    }
}

它扩展了 PreferenceActivity,并为首选项屏幕提供了用户界面。它可以像普通活动一样启动,在这种情况下,类似于:

Intent i = new Intent(this, PreferencesActivity.class);
startActivity(i);

别忘了将 PreferencesActivity 添加到你的 AndroidManifest.xml

在应用程序中获取首选项的值非常简单,只需先调用 setDefaultValues(),以便设置 XML 中定义的默认值,然后获取默认的 SharedPreferences。一个例子:

//set the default values we defined in the XML
PreferenceManager.setDefaultValues(this, R.xml.preferences, false);
SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this);
    
//get the values of the settings options
boolean silentMode = preferences.getBoolean("silent_mode", false);
boolean awesomeMode = preferences.getBoolean("awesome_mode", false);
    
String customStorage = preferences.getString("custom_storage", "");