SharedPreferences对象使用常规的XML文件来存储数据，这些文件存储在应用程序的数据目录内。该XML文件的结构很简单，因为它只允许存储键/值对，不过Android API还提供了非常方便的抽象，允许开发者以类型安全的方式读写数据。
创建SharedPreferences对象最简单的方式是使用PreferenceManager.getDefaultSharedPreferences()方法，它会返回应用程序默认的偏好对象。使用该方式来存储主要的偏好设置很方便，因为框架会自动管理好文件名。但是，如果应用程序有多个偏好文件，最好使用Context.getSharedPreference()方法，它允许开发者自由地命名文件。如果只是创建和Activity相关的偏好文件，可以使用Activity.getPreference()方法，它会在调用时得到Activity的名字。
PreferenceManager.getDefaultSharedPreferences()创建的偏好文件名是由包名以及后缀_preferences组成的，如com.liyuanjinglyj.code_preferences。虽然很少需要这个名字，但如果要实现文件备份代理该名字就很重要。
SharedPreferences支持的存储值的类型有int,float.long.boolean,String以及set<String>对象。键名必须是一个有效的字符串，常见的做法是使用点符号按组结构化多个键值。
例如，如果偏好文件包含用于网络配置以及用户界面设置相关的值，可以通过为每个键添加network或者ui前缀来把它们分组。通过该方式，开发者可以轻松的管理键/值对，避免命名冲突。下面的例子演示了如何通过使用前缀并在单独的Java接口文件中定义键来结构化偏好数据：
public interface Constants { public static final String NETWORK_PREFIX = "network."; public static final String UI_PREFIX = "ui."; public static final String NETWORK_RETRY_COUNT = NETWORK_PREFIX + "retryCount"; public static final String NETWORK_CONNECTION_TIMEOUT = NETWORK_PREFIX + "connectionTimeout"; public static final String NETWORK_WIFI_ONLY = NETWORK_PREFIX + "wifiOnly"; public static final String UI_BACKGROUND_COLOR = UI_PREFIX + "backgroundColor"; public static final String UI_FOREGROUND_COLOR = UI_PREFIX + "foregroundColor"; public static final String UI_SORT_ORDER = UI_PREFIX + "sortOrder"; public static final int SORT_ORDER_NAME = 10; public static final int SORT_ORDER_AGE = 20; public static final int SORT_ORDER_CITY = 30; }
推荐使用上面的方法访问存储的偏好值，而不是把键名硬编码在代码中。这样做可以避免误拼写，从而减少由于拼写导致的bug。
下面的代码演示了使用之前定义的Constants类来访问偏好文件：
private void readUiPreferences() { SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this); int defaultBackgroundColor = getResources(). getColor(R.color.default_background); int backgroundColor = preferences.getInt( Constants.UI_BACKGROUND_COLOR, defaultBackgroundColor); View view = findViewById(R.id.background_view); view.setBackgroundColor(backgroundColor); }
要修改存储在偏好文件中的值，首先需要获取Editor实例，它提供了相应的PUT方法，以及用于提交修改的方法。在Android2.3之前，通过使用commit()方法把修改同步提交到存储设备中。但在2.3版本中，Editor提供了用于异步执行写操作的apply()方法。因为要尽可能地避免在主线程执行阻塞的操纵，apply()方法比之前的commit()方法更好。这使得在主线程直接从UI操作更新SharedPreferences很安全。
public void doToggleWifiOnlyPreference(View view) { SharedPreferences preferences = PreferenceManager. getDefaultSharedPreferences(this); boolean currentValue = preferences. getBoolean(Constants.NETWORK_WIFI_ONLY, false); preferences.edit() .putBoolean(Constants.NETWORK_WIFI_ONLY, !currentValue) .apply(); }
上面的代码显示了使用点击监听器来切换存储在Constants.NETWORK_WIFI_ONLY中的偏好值。如果使用之前的commit()方法，主线程可能会被阻塞，导致用户体验差。使用apply()方法就不需要担心上面的问题。
在同一个进程中，每个偏好文件都只有实例。所以即便从二个不同的组件使用相同的名字获取二个SharedPreference对象，它实际上还是共享同一个实例，所以对于一个对象的改变会立即影响到另一个对象。
为了能在偏好值被修改的时候收到通知，开发者需要注册一个监听器回调函数，每当调用apply()或者commit()方法时都会触发该监听器回调函数。最常见的例子是，在Activity中修改偏好值应该影响后台Service的行为，如下所示：
public class NetworkService extends IntentService implements SharedPreferences.OnSharedPreferenceChangeListener { public static final String TAG = "NetworkService"; private boolean mWifiOnly; public NetworkService() { super(TAG); } @Override public void onCreate() { super.onCreate(); SharedPreferences preferences = PreferenceManager .getDefaultSharedPreferences(this); preferences.registerOnSharedPreferenceChangeListener(this); mWifiOnly = preferences.getBoolean(Constants.NETWORK_WIFI_ONLY, false); } @Override protected void onHandleIntent(Intent intent) { ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(CONNECTIVITY_SERVICE); NetworkInfo networkInfo = connectivityManager.getActiveNetworkInfo(); int type = networkInfo.getType(); if (mWifiOnly && type != ConnectivityManager.TYPE_WIFI) { Log.d(TAG, "只执行WIFI网络"); return; } performNetworkOperation(intent); } @Override public void onSharedPreferenceChanged(SharedPreferences preferences, String key) { if (Constants.NETWORK_WIFI_ONLY.equals(key)) { mWifiOnly = preferences .getBoolean(Constants.NETWORK_WIFI_ONLY, false); if(mWifiOnly) { cancelNetworkOperationIfNecessary(); } } } @Override public void onDestroy() { super.onDestroy(); SharedPreferences preferences = PreferenceManager .getDefaultSharedPreferences(this); preferences.unregisterOnSharedPreferenceChangeListener(this); } private void cancelNetworkOperationIfNecessary() { // 取消网络操作。 } private void performNetworkOperation(Intent intent) { // 连上网络操作 } }
