使用 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", "");