shared_preferences_typed 是一个基于 shared_preferences 的 Flutter 插件，它提供了类型化的方式来存储和读取数据。相比于 shared_preferences，shared_preferences_typed 提供了更直观的 API，并且减少了类型转换的麻烦。

安装

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

dependencies:
  flutter:
    sdk: flutter
  shared_preferences_typed: ^1.0.0

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

使用

1. 初始化

你可以通过 SharedPreferencesTyped 类来初始化和使用类型化的 SharedPreferences。

import 'package:shared_preferences_typed/shared_preferences_typed.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化 SharedPreferencesTyped
  final prefs = await SharedPreferencesTyped.getInstance();

  runApp(MyApp(prefs: prefs));
}

class MyApp extends StatelessWidget {
  final SharedPreferencesTyped prefs;

  MyApp({required this.prefs});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('SharedPreferencesTyped Example'),
        ),
        body: Center(
          child: MyHomePage(prefs: prefs),
        ),
      ),
    );
  }
}

2. 存储数据

shared_preferences_typed 提供了类型化的方法来存储数据。你可以存储 int、double、bool、String、List<String> 等类型的数据。

void saveData(SharedPreferencesTyped prefs) async {
  await prefs.setInt('myInt', 42);
  await prefs.setDouble('myDouble', 3.14);
  await prefs.setBool('myBool', true);
  await prefs.setString('myString', 'Hello, World!');
  await prefs.setStringList('myStringList', ['one', 'two', 'three']);
}

3. 读取数据

你可以使用类型化的方法来读取数据。如果数据不存在，返回的将是 null。

void readData(SharedPreferencesTyped prefs) {
  int? myInt = prefs.getInt('myInt');
  double? myDouble = prefs.getDouble('myDouble');
  bool? myBool = prefs.getBool('myBool');
  String? myString = prefs.getString('myString');
  List<String>? myStringList = prefs.getStringList('myStringList');

  print('myInt: $myInt');
  print('myDouble: $myDouble');
  print('myBool: $myBool');
  print('myString: $myString');
  print('myStringList: $myStringList');
}

4. 删除数据

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

void removeData(SharedPreferencesTyped prefs) async {
  await prefs.remove('myInt');
}

5. 清除所有数据

你可以使用 clear 方法来清除所有的键值对。

void clearData(SharedPreferencesTyped prefs) async {
  await prefs.clear();
}

完整示例

以下是一个完整的示例，展示了如何使用 shared_preferences_typed 来存储、读取和删除数据。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  final prefs = await SharedPreferencesTyped.getInstance();

  runApp(MyApp(prefs: prefs));
}

class MyApp extends StatelessWidget {
  final SharedPreferencesTyped prefs;

  MyApp({required this.prefs});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('SharedPreferencesTyped Example'),
        ),
        body: Center(
          child: MyHomePage(prefs: prefs),
        ),
      ),
    );
  }
}

class MyHomePage extends StatelessWidget {
  final SharedPreferencesTyped prefs;

  MyHomePage({required this.prefs});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        ElevatedButton(
          onPressed: () => saveData(prefs),
          child: Text('Save Data'),
        ),
        ElevatedButton(
          onPressed: () => readData(prefs),
          child: Text('Read Data'),
        ),
        ElevatedButton(
          onPressed: () => removeData(prefs),
          child: Text('Remove Data'),
        ),
        ElevatedButton(
          onPressed: () => clearData(prefs),
          child: Text('Clear Data'),
        ),
      ],
    );
  }

  void saveData(SharedPreferencesTyped prefs) async {
    await prefs.setInt('myInt', 42);
    await prefs.setDouble('myDouble', 3.14);
    await prefs.setBool('myBool', true);
    await prefs.setString('myString', 'Hello, World!');
    await prefs.setStringList('myStringList', ['one', 'two', 'three']);
  }

  void readData(SharedPreferencesTyped prefs) {
    int? myInt = prefs.getInt('myInt');
    double? myDouble = prefs.getDouble('myDouble');
    bool? myBool = prefs.getBool('myBool');
    String? myString = prefs.getString('myString');
    List<String>? myStringList = prefs.getStringList('myStringList');

    print('myInt: $myInt');
    print('myDouble: $myDouble');
    print('myBool: $myBool');
    print('myString: $myString');
    print('myStringList: $myStringList');
  }

  void removeData(SharedPreferencesTyped prefs) async {
    await prefs.remove('myInt');
  }

  void clearData(SharedPreferencesTyped prefs) async {
    await prefs.clear();
  }
}