9.
Handling Shared Preferences
Written by Kevin D Moore
Heads up... You're reading this book for free, with parts of this chapter shown beyond this point as text.
Picture this: You’re browsing recipes and find one you like. You’re in a hurry and want to bookmark it to check it later. Can you build a Flutter app that does that? You sure can! Read on to find out how.
In this chapter, your goal is to learn how to use the shared_preferences plugin to save important pieces of information to your device.
You’ll start with a new project that shows three tabs at the bottom of the screen for three different views: Recipes, Bookmarks and Groceries.
The first screen is where you’ll search for recipes you want to prepare. Once you find a recipe you like, just bookmark it and the app will add the recipe to your Bookmarks page and also add all the ingredients you need to your shopping list. You’ll use a web API to search for recipes and store the ones you bookmark in a local database.
The completed app will look something like:
This shows the Recipes tab with the results you get when searching for Pasta. It’s as easy as typing in the search text field and pressing the Search icon. The app stores your search term history in the combo box to the right of the text field.
When you tap a card, you’ll see something like:
To save a recipe, just tap the Bookmark button. When you navigate to the Bookmarks tab, you’ll see that the recipe has been saved:
If you don’t want the recipe anymore, swipe left or right and you’ll see a delete button that allows you to remove it from the list of bookmarked recipes.
The Groceries tab shows the ingredients you need to make the recipes you’ve bookmarked.
You’ll build this app over the next few chapters. In this chapter, you’ll use shared preferences to save simple data like the selected tab and also to cache the searched items in the Recipes tab.
By the end of the chapter, you’ll know:
- What shared preferences are.
- How to use the shared_preferences plugin to save and retrieve objects.
Now that you know what your goal is, it’s time to jump in!
Getting started
Open the starter project for this chapter in Android Studio, run flutter pub get, then run the app.
Notice the three tabs at the bottom — each will show a different screen when you tap it. Only the Recipes screen currently shows any UI. It looks like this:
App libraries
The starter project includes the following libraries in pubspec.yaml:
dependencies:
...
cached_network_image: ^3.2.2
flutter_slidable: ^2.0.0
platform: ^3.1.0
flutter_svg: ^1.1.4
Saving data
There are three primary ways to save data to your device:
Why save small bits of data?
There are many reasons to save small bits of data. For example, you could save the user ID when the user has logged in — or if the user has logged in at all. You could also save the onboarding state or data that the user has bookmarked to consult later.
The shared_preferences plugin
shared_preferences is a Flutter plugin that allows you to save data in a key-value format so you can easily retrieve it later. Behind the scenes, it uses the aptly named SharedPreferences on Android and the similar UserDefaults on iOS.
shared_preferences: ^2.0.15
flutter pub get
Saving UI states
You’ll use shared_preferences to save a list of saved searches in this section. Later, you’ll also save the tab that the user has selected so the app always opens to that tab.
Adding an entry to the search list
First, you’ll change the UI so that when the user presses the search icon, the app will add the search entry to the search list.
import 'package:shared_preferences/shared_preferences.dart';
import '../widgets/custom_dropdown.dart';
import '../colors.dart';
static const String prefSearchKey = 'previousSearches';
List<String> previousSearches = <String>[];
Running code in the background
To understand the code you’ll add next, you need to know a bit about running code in the background.
Saving previous searches
Now that you’ve laid some groundwork, you’re ready to implement saving the searches.
void savePreviousSearches() async {
// 1
final prefs = await SharedPreferences.getInstance();
// 2
prefs.setStringList(prefSearchKey, previousSearches);
}
void getPreviousSearches() async {
// 1
final prefs = await SharedPreferences.getInstance();
// 2
if (prefs.containsKey(prefSearchKey)) {
// 3
final searches = prefs.getStringList(prefSearchKey);
// 4
if (searches != null) {
previousSearches = searches;
} else {
previousSearches = <String>[];
}
}
}
getPreviousSearches();
Adding the search functionality
To perform a search, you need to clear any of your variables and save the new search value. This method will not do an actual search just yet. Do this by replacing // TODO: Add startSearch with:
void startSearch(String value) {
// 1
setState(() {
// 2
currentSearchList.clear();
currentCount = 0;
currentEndPosition = pageCount;
currentStartPosition = 0;
hasMore = true;
value = value.trim();
// 3
if (!previousSearches.contains(value)) {
// 4
previousSearches.add(value);
// 5
savePreviousSearches();
}
});
}
Adding a search button
Next, you’ll add a search button that saves terms each time the user performs a search.
IconButton(
icon: const Icon(Icons.search),
// 1
onPressed: () {
// 2
startSearch(searchTextController.text);
// 3
final currentFocus = FocusScope.of(context);
if (!currentFocus.hasPrimaryFocus) {
currentFocus.unfocus();
}
},
),
Expanded(
child: Row(
children: <Widget>[
Expanded(
// 3
child: TextField(
decoration: const InputDecoration(
border: InputBorder.none, hintText: 'Search'),
autofocus: false,
// 4
textInputAction: TextInputAction.done,
// 5
onSubmitted: (value) {
startSearch(searchTextController.text);
},
controller: searchTextController,
)),
// 6
PopupMenuButton<String>(
icon: const Icon(
Icons.arrow_drop_down,
color: lightGrey,
),
// 7
onSelected: (String value) {
searchTextController.text = value;
startSearch(searchTextController.text);
},
itemBuilder: (BuildContext context) {
// 8
return previousSearches
.map<CustomDropdownMenuItem<String>>((String value) {
return CustomDropdownMenuItem<String>(
text: value,
value: value,
callback: () {
setState(() {
// 9
previousSearches.remove(value);
savePreviousSearches();
Navigator.pop(context);
});
},
);
}).toList();
},
),
],
),
),
Test the app
It’s time to test the app. Because you added a new dependency, quit the running instance and run it again (Note that you do not always need to restart when adding dependencies). You’ll see something like this:
Saving the selected tab
In this section, you’ll use shared_preferences to save the current UI tab that the user has navigated to.
import 'package:shared_preferences/shared_preferences.dart';
static const String prefSelectedIndexKey = 'selectedIndex';
void saveCurrentIndex() async {
// 1
final prefs = await SharedPreferences.getInstance();
// 2
prefs.setInt(prefSelectedIndexKey, _selectedIndex);
}
void getCurrentIndex() async {
// 1
final prefs = await SharedPreferences.getInstance();
// 2
if (prefs.containsKey(prefSelectedIndexKey)) {
// 3
setState(() {
final index = prefs.getInt(prefSelectedIndexKey);
if (index != null) {
_selectedIndex = index;
}
});
}
}
getCurrentIndex();
saveCurrentIndex();
Key points
- There are multiple ways to save data in an app: to files, in shared preferences and to a SQLite database.
- Shared preferences are best used to store simple, key-value pairs of primitive types like strings, numbers and Booleans.
- An example of when to use shared preferences is to save the tab a user is viewing, so the next time the user starts the app, they’re brought to the same tab.
- The
async/awaitkeyword pair let you run asynchronous code off the main UI thread and then wait for the response. An example is getting an instance ofSharedPreferences. - The shared_preferences plugin should not be used to hold sensitive data. Instead, consider using the flutter_secure_storage plugin.
Where to go from here?
In this chapter, you learned how to persist simple data types in your app using the shared_preferences plugin.