Merge "Update SharedPreferences documentation with behavior info"

 * when they are committed to storage.  Objects that are returned from the

 * various <code>get</code> methods must be treated as immutable by the application.

 *

 * <p>Note: This class provides strong consistency guarantees. It is using expensive operations

 * which might slow down an app. Frequently changing properties or properties where loss can be

 * tolerated should use other mechanisms. For more details read the comments on

 * {@link Editor#commit()} and {@link Editor#apply()}.

 * <p>SharedPreferences is best suited to storing data about how the user prefers

 * to experience the app, for example, whether the user prefers a particular UI theme

 * or whether they prefer viewing particular content in a list vs. a grid. To this end,

 * SharedPreferences reflects changes {@link Editor#commit() committed} or

 * {@link Editor#apply() applied} by {@link Editor}s <em>immediately</em>, potentially

 * before those changes are durably persisted.

 * Under some circumstances such as app crashes or termination these changes may be lost,

 * even if an {@link OnSharedPreferenceChangeListener} reported the change was successful.

 * SharedPreferences is not recommended for storing data that is sensitive to this

 * kind of rollback to a prior state such as user security or privacy settings.

 * For other high-level data persistence options, see

 * <a href="https://d.android.com/room">Room</a> or

 * <a href="https://d.android.com/datastore">DataStore</a>.

 *

 * <p><em>Note:</em> Common implementations guarantee that outstanding edits to preference

 * files are persisted to disk when host Activities become stopped. In some situations

 * (e.g. performing many {@link Editor#commit()} or {@link Editor#apply()}

 * operations just prior to navigating away from the host Activity) this can lead

 * to blocking the main thread during lifecycle transition events and associated

 * ANR errors. For more details see the documentation for {@link Editor#commit()} and

 * {@link Editor#apply()}.

 *

 * <p><em>Note: This class does not support use across multiple processes.</em>

 *