flutter_data_prefs 是一个用于数据持久化的 Flutter 插件，它允许你在 Flutter 应用中轻松地存储和读取键值对数据。这个插件通常用于存储用户偏好设置、应用配置等小规模数据。

安装

首先，你需要在 pubspec.yaml 文件中添加 flutter_data_prefs 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_data_prefs: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 初始化

在使用 flutter_data_prefs 之前，你需要初始化它。通常可以在应用的 main 函数中进行初始化：

import 'package:flutter/material.dart';
import 'package:flutter_data_prefs/flutter_data_prefs.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Prefs.init();
  runApp(MyApp());
}

2. 存储数据

你可以使用 Prefs.setString、Prefs.setInt、Prefs.setBool 等方法来存储不同类型的数据：

Prefs.setString('username', 'JohnDoe');
Prefs.setInt('age', 25);
Prefs.setBool('isLoggedIn', true);

3. 读取数据

你可以使用 Prefs.getString、Prefs.getInt、Prefs.getBool 等方法来读取存储的数据：

String username = Prefs.getString('username', defaultValue: 'Guest');
int age = Prefs.getInt('age', defaultValue: 0);
bool isLoggedIn = Prefs.getBool('isLoggedIn', defaultValue: false);

4. 删除数据

你可以使用 Prefs.remove 方法来删除指定的键值对：

Prefs.remove('username');

5. 清空所有数据

你可以使用 Prefs.clear 方法来清空所有存储的数据：

Prefs.clear();

示例

下面是一个完整的示例，展示了如何使用 flutter_data_prefs 来存储和读取用户偏好设置：

import 'package:flutter/material.dart';
import 'package:flutter_data_prefs/flutter_data_prefs.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Prefs.init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _username = 'Guest';
  int _age = 0;
  bool _isLoggedIn = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    _loadPreferences();
  }

  void _loadPreferences() async {
    setState(() {
      _username = Prefs.getString('username', defaultValue: 'Guest');
      _age = Prefs.getInt('age', defaultValue: 0);
      _isLoggedIn = Prefs.getBool('isLoggedIn', defaultValue: false);
    });
  }

  void _savePreferences() async {
    await Prefs.setString('username', 'JohnDoe');
    await Prefs.setInt('age', 25);
    await Prefs.setBool('isLoggedIn', true);
    _loadPreferences();
  }

  void _clearPreferences() async {
    await Prefs.clear();
    _loadPreferences();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Data Prefs Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Username: $_username'),
            Text('Age: $_age'),
            Text('Is Logged In: $_isLoggedIn'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _savePreferences,
              child: Text('Save Preferences'),
            ),
            ElevatedButton(
              onPressed: _clearPreferences,
              child: Text('Clear Preferences'),
            ),
          ],
        ),
      ),
    );
  }
}