Why SharedPreferences / DataStore in Android Kotlin? - Purpose & Use Cases

The Big Idea

Discover how a tiny piece of code can make your app feel like it truly knows its user!

The Scenario

Imagine you want your app to remember a user's theme choice or login status every time they open it. Without a simple way to save this small data, you'd have to ask the user again and again, which feels frustrating and unprofessional.

The Problem

Manually saving data by writing files or databases for tiny settings is slow and complicated. It can cause bugs, data loss, or slow app startup. Plus, it wastes time writing extra code for simple tasks.

The Solution

SharedPreferences and DataStore provide easy, fast, and reliable ways to save small pieces of data like settings or user preferences. They handle storage behind the scenes so you can focus on your app's features.

Before vs After

✗ Before

val file = File(context.filesDir, "settings.txt")
file.writeText("dark_mode=true")

✓ After

val prefs = context.getSharedPreferences("settings", Context.MODE_PRIVATE)
prefs.edit().putBoolean("dark_mode", true).apply()

What It Enables

It lets your app remember user choices smoothly, creating a friendly and personalized experience every time.

Real Life Example

When you open a news app and it remembers you prefer dark mode and your favorite topics, that's SharedPreferences or DataStore working quietly in the background.

Key Takeaways

Saving small data manually is slow and error-prone.

SharedPreferences/DataStore simplify storing user settings.

This makes apps feel personal and easy to use.

Practice

1. What is the main purpose of SharedPreferences in Android development?

easy

A. To handle network requests and responses

B. To create complex database tables for large data storage

C. To save small amounts of key-value data persistently on the device

D. To design user interface layouts

Solution

1. Step 1: Understand SharedPreferences role

   SharedPreferences is designed to store small amounts of data as key-value pairs persistently on the device.

2. Step 2: Compare with other options

   Options B, C, and D describe unrelated tasks like databases, networking, and UI design, which are not the purpose of SharedPreferences.

3. Final Answer:

   To save small amounts of key-value data persistently on the device -> Option C

4. Quick Check:

   SharedPreferences = small persistent key-value storage [OK]

Hint: Remember SharedPreferences stores simple key-value pairs [OK]

Common Mistakes:

• Confusing SharedPreferences with databases
• Thinking SharedPreferences handles UI or network
• Assuming SharedPreferences stores large files

2. Which of the following is the correct way to get a SharedPreferences instance in Kotlin inside an Activity?

easy

A. val prefs = SharedPreferences("my_prefs")

B. val prefs = getSharedPreferences("my_prefs", Context.MODE_PRIVATE)

C. val prefs = SharedPreferences.getInstance("my_prefs")

D. val prefs = getPreferences("my_prefs")

Solution

1. Step 1: Recall correct method to get SharedPreferences

   The correct method is to call getSharedPreferences(name, mode) on a Context, passing the name and mode.

2. Step 2: Analyze options

   val prefs = getSharedPreferences("my_prefs", Context.MODE_PRIVATE) uses the correct method. Options A, C, and D are invalid constructors or methods. val prefs = getPreferences("my_prefs") uses getPreferences which does not take a name parameter.

3. Final Answer:

   val prefs = getSharedPreferences("my_prefs", Context.MODE_PRIVATE) -> Option B

4. Quick Check:

   Use getSharedPreferences(name, mode) to get prefs [OK]

Hint: Use getSharedPreferences with name and mode inside Activity [OK]

Common Mistakes:

• Trying to instantiate SharedPreferences directly
• Using getPreferences with a name parameter
• Confusing method names or parameters

3. What will be the output of this Kotlin code snippet using SharedPreferences?

val prefs = getSharedPreferences("settings", Context.MODE_PRIVATE)
val editor = prefs.edit()
editor.putString("username", "Alice")
editor.apply()
val name = prefs.getString("username", "Unknown")
println(name)

medium

A. null

B. Unknown

C. Compilation error

D. Alice

Solution

1. Step 1: Store value in SharedPreferences

   The code puts the string "Alice" with key "username" and applies the changes asynchronously.

2. Step 2: Retrieve stored value

   Then it retrieves the value for "username"; since it was stored, it returns "Alice" instead of the default "Unknown".

3. Final Answer:

   Alice -> Option D

4. Quick Check:

   Stored value retrieved correctly = Alice [OK]

Hint: Stored keys return saved value, else default [OK]

Common Mistakes:

• Forgetting to call apply() or commit()
• Expecting default value when key exists
• Confusing synchronous and asynchronous apply

4. Identify the error in this Kotlin code using DataStore to save a boolean value:

val dataStore = context.createDataStore(name = "settings")
fun saveFlag(flag: Boolean) {
  dataStore.edit { preferences ->
    preferences[booleanPreferencesKey("flag")] = flag
  }
}

medium

A. Missing 'suspend' modifier on the saveFlag function

B. Missing commit() call after edit block

C. booleanPreferencesKey should be replaced with stringPreferencesKey

D. DataStore cannot store boolean values

Solution

1. Step 1: Check DataStore function modifiers

   The function saveFlag must be marked suspend because it calls dataStore.edit(), which is a suspend function.

2. Step 2: Verify other code parts

   The createDataStore call is correct. The edit block commits changes automatically. Using booleanPreferencesKey is correct for boolean values. DataStore supports boolean values.

3. Final Answer:

   Missing 'suspend' modifier on the saveFlag function -> Option A

4. Quick Check:

   DataStore edit requires suspend function [OK]

Hint: DataStore edit calls require suspend functions [OK]

Common Mistakes:

• Missing 'suspend' modifier on saveFlag function
• Forgetting suspend modifier on save function
• Confusing preference key types

5. You want to migrate existing user settings from SharedPreferences to DataStore in a Kotlin app. Which approach correctly handles this migration?

hard

A. Use SharedPreferencesMigration with DataStore to copy data automatically on first access

B. Manually read all SharedPreferences keys and write them to DataStore every app start

C. Delete SharedPreferences and start fresh with DataStore without migration

D. Use SharedPreferences.edit() inside DataStore's edit block

Solution

1. Step 1: Understand migration support in DataStore

   DataStore provides a built-in SharedPreferencesMigration class to migrate data automatically from SharedPreferences on first DataStore access.

2. Step 2: Evaluate other options

   Manually read all SharedPreferences keys and write them to DataStore every app start is inefficient and error-prone. Delete SharedPreferences and start fresh with DataStore without migration loses user data. Use SharedPreferences.edit() inside DataStore's edit block is invalid because SharedPreferences and DataStore APIs are separate and cannot be mixed inside edit blocks.

3. Final Answer:

   Use SharedPreferencesMigration with DataStore to copy data automatically on first access -> Option A

4. Quick Check:

   Use SharedPreferencesMigration for smooth migration [OK]

Hint: Use SharedPreferencesMigration for easy migration [OK]

Common Mistakes:

• Trying manual migration every app start
• Deleting old preferences losing data
• Mixing SharedPreferences API inside DataStore