fl_query_connectivity_plus_adapter 是一个用于在 Flutter 应用中检测网络连接状态的插件，它基于 connectivity_plus 库，并提供了与 fl_query 库的集成。通过使用这个插件，你可以轻松地检测设备的网络连接状态，并在网络状态变化时执行相应的操作。

安装

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

dependencies:
  fl_query: ^1.0.0
  fl_query_connectivity_plus_adapter: ^1.0.0

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

基本用法

1. 初始化 fl_query 并设置网络连接适配器

   在你的应用启动时，初始化 fl_query 并设置 fl_query_connectivity_plus_adapter 作为网络连接适配器。

   import 'package:fl_query/fl_query.dart';
   import 'package:fl_query_connectivity_plus_adapter/fl_query_connectivity_plus_adapter.dart';
   
   void main() {
     QueryClient.initialize(
       connectivity: ConnectivityPlusAdapter(),
     );
   
     runApp(MyApp());
   }

2. 检测网络连接状态

   你可以使用 QueryClient 来检测当前的网络连接状态。

   import 'package:flutter/material.dart';
   import 'package:fl_query/fl_query.dart';
   
   class MyApp extends StatelessWidget {
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         home: Scaffold(
           appBar: AppBar(
             title: Text('Network Connectivity Example'),
           ),
           body: Center(
             child: FutureBuilder<bool>(
               future: QueryClient.of(context).isConnected,
               builder: (context, snapshot) {
                 if (snapshot.connectionState == ConnectionState.waiting) {
                   return CircularProgressIndicator();
                 } else if (snapshot.hasError) {
                   return Text('Error: ${snapshot.error}');
                 } else {
                   return Text('Connected: ${snapshot.data}');
                 }
               },
             ),
           ),
         ),
       );
     }
   }

3. 监听网络连接状态变化

   你可以使用 QueryClient 来监听网络连接状态的变化，并在状态变化时执行相应的操作。

   import 'package:flutter/material.dart';
   import 'package:fl_query/fl_query.dart';
   
   class MyApp extends StatefulWidget {
     @override
     _MyAppState createState() => _MyAppState();
   }
   
   class _MyAppState extends State<MyApp> {
     bool _isConnected = false;
   
     @override
     void initState() {
       super.initState();
       QueryClient.of(context).addConnectionListener((isConnected) {
         setState(() {
           _isConnected = isConnected;
         });
       });
     }
   
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         home: Scaffold(
           appBar: AppBar(
             title: Text('Network Connectivity Example'),
           ),
           body: Center(
             child: Text('Connected: $_isConnected'),
           ),
         ),
       );
     }
   }

高级用法

fl_query_connectivity_plus_adapter 还支持更高级的用法，例如在网络连接恢复时自动重试失败的查询。你可以通过配置 QueryClient 来实现这一点。

QueryClient.initialize(
  connectivity: ConnectivityPlusAdapter(),
  retryConfig: RetryConfig(
    retryOnConnectionFailure: true,
  ),
);