Android 使用SharedPreferences实施设置屏幕

示例

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

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偏好类的Android开发人员文档中列出了许多其他类型。

接下来,我们需要一个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中定义的默认值,然后获取default SharedPreferences。一个例子:

//设置我们在XML中定义的默认值
PreferenceManager.setDefaultValues(this, R.xml.preferences, false);
SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this);
    
//获取设置选项的值
boolean silentMode = preferences.getBoolean("silent_mode", false);
boolean awesomeMode = preferences.getBoolean("awesome_mode", false);
    
String customStorage = preferences.getString("custom_storage", "");