搜索插件、代码仓与 APP 分类

simple_connection_checker 封面
插件详情v0.3.4

simple_connection_checker

一个简单的包,用于检查设备何时连接到互联网(网络连接)。还提供一种方法来监听连接状态的变化。

AndroidiOSmacOSWindowsLinux
近 30 天下载
8280
喜欢数
34
Pub 分数
160

安装插件

flutter pub add simple_connection_checker

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个轻量级的 Flutter 包,可在多个平台上实现互联网连接状态的简单检测。它提供了一种直接的方法来检查设备是否已连接到互联网,并提供了一个流,用于监听连接状态的实时变化。非常适合需要可靠网络状态监控而无需复杂设置的应用程序。该包支持 Android、iOS、macOS、Windows 和 Linux,使其在跨平台开发中具有高度灵活性。

适合场景

  • 在 API 调用之前检查互联网连接
  • 实时监控网络状态变化
  • 确保离线模式处理
  • 显示网络状态指示器
  • 根据连接性验证用户操作
  • 在网络状况不佳时防止请求失败

主要特点

  • 用于连接性检查的简单 API
  • 基于流的连接状态监听
  • 跨平台支持
  • 轻量且易于集成
  • 连接状态的实时更新
  • 无额外依赖

适合对象

  • 基本连接性监控
  • 需要网络感知的应用程序
  • 寻求最小化设置的开发者
  • 跨平台移动和桌面应用
  • 网络逻辑有限的项目
  • 原型和快速实现

使用建议

  • 不处理 Wi-Fi 与蜂窝网络的区别
  • 仅限在线/离线状态
  • 无内置重试机制
  • 依赖系统级别的连接API
  • 某些平台可能需要权限处理
  • 不适合高级网络诊断

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Simple Connection Checker

A simple package to check when the device is connected (connectivity) to internet. Also provide a method to listen for connection status changes.

Demo

Instalation

Include simple_connection_checker in your pubspec.yaml file:

dependencies:
  flutter:
    sdk: flutter
  simple_connection_checker: version

Usage

To use this package, just import it into your file and call the static method isConnectedToInternet as follows:

import 'package:simple_connection_checker/simple_connection_checker.dart';

...

bool isConnected = await SimpleConnectionChecker.isConnectedToInternet();

...

Note: You can pass an optional parameter named lookUpAddress to pass an especific URL to make the lookup operation and check the internet connection. By default, this value is www.google.com. Do not use the protocol on the URL string passed (http:// or https://).

New 💥

  • A beta version to use with web
  • Now you can listen for internet connection changes. Here is the example
import 'package:simple_connection_checker/simple_connection_checker.dart';

...
StreamSubscription? subscription;
bool? _connected;

@override
void initState() {
  super.initState();
  SimpleConnectionChecker _simpleConnectionChecker = SimpleConnectionChecker()
      ..setLookUpAddress('pub.dev'); //Optional method to pass the lookup string
  subscription = _simpleConnectionChecker.onConnectionChange.listen((connected) {
    setState(() {
      _connected = connected;
    });
  });
}

@override
void dispose() {
  subscription?.cancel();
  super.dispose();
}

...

Note: Don't forget to cancel the subscription

Demo

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

暂无相关数据。