Flutter网络连接检测插件network_checker的使用

NetworkChecker 是一个Flutter插件，它能实时监控互联网连接状态，并在网络不可用时显示一个可自定义的重试界面。这为确保应用程序能够优雅地处理网络中断提供了一种简便的方法。

功能特性

• 实时监测：实时监测互联网连接。
• 默认重试界面：当网络不可用时，默认显示重试界面。
• 界面自定义：可以自定义重试按钮和重试界面UI。
• 内置周期性检查：支持内置的周期性连接检查功能。

安装

在您的pubspec.yaml文件中添加以下依赖：

dependencies:
  network_checker: latest_version

然后运行命令安装包：

flutter pub get

使用方法

将 NetworkChecker 小部件包裹在您希望监控连接性的主应用或特定小部件树部分周围。

基本使用

这是一个简单的例子，展示了如何使用 NetworkChecker 包裹一个包含文本的小部件：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NetworkChecker(
        child: Scaffold(
          appBar: AppBar(title: const Text('Network Checker Example')),
          body: const Center(child: Text('You are online!')),
        ),
      ),
    );
  }
}

自定义重试界面

为了实现完全自定义，您可以使用 retryUI 属性来提供一个自定义的重试界面：

NetworkChecker(
  child: MyApp(),
  retryUI: Center(
    child: Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        const Text('No Connection', style: TextStyle(fontSize: 20)),
        const SizedBox(height: 10),
        IconButton(
          icon: const Icon(Icons.refresh),
          onPressed: () => print('Retry!'),
        ),
      ],
    ),
  ),
)

示例代码

这里是一个更完整的示例，它结合了计数器功能与 NetworkChecker 的使用，以展示其在实际应用中的集成方式：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return NetworkChecker(
      child: Scaffold(
        appBar: AppBar(
          backgroundColor: Theme.of(context).colorScheme.inversePrimary,
          title: Text(widget.title),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              const Text(
                'You have pushed the button this many times:',
              ),
              Text(
                '$_counter',
                style: Theme.of(context).textTheme.headlineMedium,
              ),
            ],
          ),
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: _incrementCounter,
          tooltip: 'Increment',
          child: const Icon(Icons.add),
        ), // This trailing comma makes auto-formatting nicer for build methods.
      ),
    );
  }
}

这个完整的示例展示了如何将 NetworkChecker 集成到一个具有简单用户交互（如点击按钮增加计数）的应用程序中。当网络连接断开时，用户将看到一个提示信息，并可以选择通过点击刷新图标来尝试重新连接。