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

ConnectionChecker 是一个简单的Flutter包，允许你检查互联网连接或任何由用户提供的URI的连接状态。该包提供了简单的方式来验证设备是否在线或是否可以访问特定的端点，非常适合需要进行网络状态验证的应用。

功能

• 检查互联网连接。
• 验证到特定URI的连接。
• 轻量且易于集成到Flutter项目中。
• 处理不同的网络类型（如Wi-Fi、移动数据等）。
• 使用套接字进行快速可靠的连接检查。

安装

在你的pubspec.yaml文件中添加包：

dependencies:
  connectivity_checker: latest_version

然后运行以下命令以获取依赖项：

flutter pub get

使用

Android权限

Android应用必须在Android清单文件（AndroidManifest.xml）中声明其使用互联网的权限：

<manifest xmlns:android...>
 ...
 <uses-permission android:name="android.permission.INTERNET" />
 <application ...
</manifest>

iOS权限

对于iOS，必须在Info-debug.plist中添加以下内容：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

macOS权限

macOS应用必须在相关的*.entitlements文件中允许网络访问：

<key>com.apple.security.network.client</key>
<true/>

检查互联网连接

要检查设备是否已连接到互联网：

import 'package:connectivity_checker/connectivity_checker.dart';

void checkConnectivity() async {
  bool isConnected = await ConnectionChecker.hasConnection();
  print('Internet Connected: $isConnected');
}

检查到特定URI的连接

要检查到特定URI的连接：

import 'package:connectivity_checker/connectivity_checker.dart';

void checkConnectivity() async {
  String uri = 'https://example.com';
  bool isConnected = await ConnectionChecker.checkConnectivity(HttpOption(url: uri));
  print('Connected to $uri: $isConnected');
}

监听连接变化

你还可以订阅设备连接状态（在线/离线）的变化：

import 'package:connectivity_checker/connectivity_checker.dart';

void monitorConnectivityChanges() {
  ConnectionChecker.onConnectivityChanged.listen((status) {
    if (status == ConnectivityResult.connected) {
      print('Device is online');
    } else {
      print('Device is offline');
    }
  });
}

API 参考

1. checkConnectivity()

• 描述: 检查设备是否有活跃的互联网连接。
• 返回值: 返回一个Future<bool>，如果连接则为true，否则为false。

2. checkConnectivity(String url)

• 描述: 检查特定URI是否可以通过互联网访问。
• 参数:
  • url (String): 需要检查的URI。
• 返回值: 返回一个Future<bool>，如果URI可访问则为true，否则为false。

3. onConnectivityChanged

• 描述: 一个监听连接状态变化的流。
• 返回值: 返回一个Stream<ConnectivityResult>，广播连接状态的变化（例如connected、disconnected）。

示例

这是一个完整的示例，展示了如何在Flutter应用中使用ConnectionChecker：

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

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late final StreamSubscription<ConnectivityResult> _subscription;
  ValueNotifier<bool> res = ValueNotifier<bool>(true);

  [@override](/user/override)
  void initState() {
    super.initState();
    var i = ConnectionChecker();

    _subscription = i.onConnectivityChanged.listen((status) {
      res.value = status == ConnectivityResult.connected;
    });
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: ValueListenableBuilder(
            valueListenable: res,
            builder: (context, value, child) {
              return Text("$value");
            },
          ),
        ),
      ),
    );
  }
}