synced_data 是一个用于在 Flutter 应用中实现数据同步的插件。它可以帮助你在本地和远程数据源之间同步数据，确保数据的一致性和实时性。以下是如何使用 synced_data 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化 SyncedData

在你的 Flutter 应用中，首先需要初始化 SyncedData。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 SyncedData
  await SyncedData.initialize(
    localDatabaseName: 'my_local_db',
    remoteUrl: 'https://your-remote-api.com',
    syncInterval: Duration(minutes: 5),  // 同步间隔时间
  );

  runApp(MyApp());
}

3. 定义数据模型

你需要定义一个数据模型类，该类将用于表示你要同步的数据。例如：

import 'package:synced_data/synced_data.dart';

class MyDataModel extends SyncedModel {
  String id;
  String name;
  int value;

  MyDataModel({required this.id, required this.name, required this.value});

  @override
  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'name': name,
      'value': value,
    };
  }

  factory MyDataModel.fromJson(Map<String, dynamic> json) {
    return MyDataModel(
      id: json['id'],
      name: json['name'],
      value: json['value'],
    );
  }
}

4. 同步数据

你可以使用 SyncedData 来同步数据。以下是一个简单的示例，展示如何从远程获取数据并同步到本地：

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

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<MyDataModel> dataList = [];

  @override
  void initState() {
    super.initState();
    _syncData();
  }

  Future<void> _syncData() async {
    // 从远程获取数据
    final remoteData = await SyncedData.fetchRemoteData<MyDataModel>(
      endpoint: '/data',
      fromJson: MyDataModel.fromJson,
    );

    // 将数据同步到本地
    await SyncedData.syncLocalData<MyDataModel>(
      remoteData: remoteData,
      toJson: (model) => model.toJson(),
      fromJson: MyDataModel.fromJson,
    );

    // 从本地获取数据
    final localData = await SyncedData.getLocalData<MyDataModel>(
      fromJson: MyDataModel.fromJson,
    );

    setState(() {
      dataList = localData;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Synced Data Example'),
      ),
      body: ListView.builder(
        itemCount: dataList.length,
        itemBuilder: (context, index) {
          final item = dataList[index];
          return ListTile(
            title: Text(item.name),
            subtitle: Text('Value: ${item.value}'),
          );
        },
      ),
    );
  }
}

5. 处理冲突

在数据同步过程中，可能会遇到数据冲突的情况。synced_data 提供了处理冲突的机制。你可以通过重写 SyncedModel 中的 resolveConflict 方法来处理冲突：

class MyDataModel extends SyncedModel {
  // ... 其他代码 ...

  @override
  MyDataModel resolveConflict(MyDataModel remoteModel) {
    // 自定义冲突解决逻辑
    return this.value > remoteModel.value ? this : remoteModel;
  }
}

6. 手动触发同步

你可以手动触发数据同步，例如在用户点击按钮时：

FloatingActionButton(
  onPressed: _syncData,
  child: Icon(Icons.sync),
),

7. 处理错误

在同步过程中，可能会遇到网络错误或其他异常。你可以使用 try-catch 来捕获并处理这些错误：

Future<void> _syncData() async {
  try {
    // 同步数据逻辑
  } catch (e) {
    print('Error syncing data: $e');
    // 显示错误信息给用户
  }
}

8. 清理数据

在应用退出或需要清理数据时，你可以使用 SyncedData.clearLocalData() 来清理本地数据：

await SyncedData.clearLocalData();