get_rx_persist 是一个用于 Flutter 的数据持久化插件，它结合了 get 状态管理库和 rxdart 响应式编程库，提供了一种简单且强大的方式来持久化和管理应用程序的状态数据。通过 get_rx_persist，你可以轻松地将应用程序的状态保存到本地存储（如 SharedPreferences 或 Hive），并在应用程序重新启动时恢复这些状态。

安装 get_rx_persist

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

dependencies:
  flutter:
    sdk: flutter
  get_rx_persist: ^1.0.0

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

基本用法

1. 初始化 GetRxPersist

在使用 get_rx_persist 之前，你需要初始化它。通常你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 GetRxPersist
  await GetRxPersist.init();
  
  runApp(MyApp());
}

2. 创建可持久化的 Rx 变量

你可以使用 RxPersist 来创建可持久化的 Rx 变量。这些变量会在应用程序重启时自动从本地存储中恢复。

import 'package:get/get.dart';
import 'package:get_rx_persist/get_rx_persist.dart';

class MyController extends GetxController {
  // 创建一个可持久化的 RxInt 变量
  final RxPersistInt counter = RxPersistInt('counter', defaultValue: 0);

  void increment() {
    counter.value++;
  }
}

3. 在 UI 中使用可持久化的 Rx 变量

你可以在 UI 中使用 GetX 或 Obx 来观察和更新这些可持久化的 Rx 变量。

import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'controller.dart'; // 假设你的控制器在 controller.dart 文件中

class MyApp extends StatelessWidget {
  final MyController controller = Get.put(MyController());

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('GetRxPersist Example')),
        body: Center(
          child: Obx(() => Text('Counter: ${controller.counter.value}')),
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () {
            controller.increment();
          },
          child: Icon(Icons.add),
        ),
      ),
    );
  }
}

支持的持久化类型

get_rx_persist 支持多种类型的持久化变量，包括：

• RxPersistInt
• RxPersistDouble
• RxPersistString
• RxPersistBool
• RxPersistList
• RxPersistMap

自定义存储

默认情况下，get_rx_persist 使用 SharedPreferences 作为存储后端。你也可以通过实现 PersistStorage 接口来自定义存储后端。

class CustomStorage implements PersistStorage {
  [@override](/user/override)
  Future<void> init() async {
    // 初始化自定义存储
  }

  [@override](/user/override)
  Future<void> write<T>(String key, T value) async {
    // 将值写入自定义存储
  }

  [@override](/user/override)
  Future<T?> read<T>(String key) async {
    // 从自定义存储中读取值
  }

  [@override](/user/override)
  Future<void> delete(String key) async {
    // 从自定义存储中删除值
  }
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 使用自定义存储初始化 GetRxPersist
  await GetRxPersist.init(storage: CustomStorage());
  
  runApp(MyApp());
}