SettingsService class Settings

Service for storing persistent key/value application settings.

This object provides a simple typed key-value store persisted to a platform-specific location. Values are stored inside a named "group" (the default is DEFAULT) which can be changed with beginGroup/endGroup.

Supported types: String, bool, int (32-bit), large int (64-bit), and double. Changes are buffered and written to disk either automatically or immediately when flush is called.

When multiple keys need to be retrieved or stored, the list-based methods (e.g., getStringList, setIntList) can be used for efficiency. Their behavior is similar to the single-value methods, with the addition of handling lists of keys and default values instead of single keys and default values.

Example

final settings = SettingsService();
settings.setString('username', 'alice');
settings.setInt('launchCount', 1);
settings.flush(); // ensure values are persisted
final name = settings.getString('username', defaultValue: 'guest');