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

Universal Internet Checker 是一个用于检测Web和移动设备上互联网连接状态的Flutter插件（尚未在桌面平台上测试）。你可以通过这个插件来增强你的应用程序，使其具备网络感知能力。

安装

要在项目中使用universal_internet_checker插件，请在pubspec.yaml文件中添加依赖：

dependencies:
  universal_internet_checker: ^latest_version

然后运行以下命令以安装依赖：

flutter pub get

或者直接从pub.dev添加：

flutter pub add universal_internet_checker

确保替换^latest_version为实际的最新版本号。

使用方法

基本用法

导入包并调用静态方法checkInternet来检查当前的网络连接状态：

import 'package:universal_internet_checker/universal_internet_checker.dart';

...

ConnectionStatus status = await UniversalInternetChecker.checkInternet();
print(status == ConnectionStatus.online ? "Connected" : "Not Connected");

...

注意：你可以设置静态变量checkAddress来指定一个URL进行网络连接检查，默认值是www.google.com。不要包含http://或https://前缀或任何子目录。

UniversalInternetChecker.checkAddress = 'www.example.com';

监听网络状态变化

如果你想监听网络连接的变化，可以这样做：

import 'package:universal_internet_checker/universal_internet_checker.dart';

class MyHomePage extends StatefulWidget {
  ...

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  StreamSubscription? subscription;
  String _message = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    subscription = UniversalInternetChecker.onConnectionChange.listen((status) {
      setState(() {
        _message = status == ConnectionStatus.online ? 'Connected' : 'Not Connected';
      });
    });
  }

  [@override](/user/override)
  void dispose() {
    subscription?.cancel();
    super.dispose();
  }

  ...
}

使用Provider管理状态

如果你正在使用Provider，可以通过如下方式将网络状态提供给整个应用：

StreamProvider<ConnectionStatus>(
  create: (context) => UniversalInternetChecker().onConnectionChange,
  initialData: ConnectionStatus.unknown,
)

示例Demo

下面是一个完整的示例demo，展示了如何使用universal_internet_checker插件：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:universal_internet_checker/universal_internet_checker.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'UIC Example',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Universal Internet Checker'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _message = '';
  StreamSubscription? subscription;
  UniversalInternetChecker _internetChecker = UniversalInternetChecker();

  [@override](/user/override)
  void initState() {
    super.initState();
    subscription = _internetChecker.onConnectionChange.listen((connected) {
      setState(() {
        _message = connected == ConnectionStatus.online ? 'Connected' : 'Not Connected';
      });
    });
  }

  [@override](/user/override)
  void dispose() {
    subscription?.cancel();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: () async {
                ConnectionStatus status = await UniversalInternetChecker.checkInternet();
                setState(() {
                  _message = status == ConnectionStatus.online ? 'Connected' : 'Not Connected';
                });
              },
              child: Text('Check connection'),
            ),
            Text(_message),
          ],
        ),
      ),
    );
  }
}