flutter_network_connectivity

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Plugin, das die Echtzeitüberwachung des Netzwerkverbindungsstatus auf Android- und iOS-Geräten ermöglicht. Es nutzt native System-APIs – NetworkCapabilities unter Android und NetworkMonitor unter iOS –, um genaue, aktuelle Informationen darüber bereitzustellen, ob ein Gerät mit dem Internet verbunden ist. Das Plugin ist leichtgewichtig und für eine nahtlose Integration in Apps konzipiert, die Netzwerkbewusstsein erfordern, beispielsweise solche, die ihr Verhalten anhand der Verfügbarkeit einer Verbindung anpassen müssen. Es unterstützt sowohl die Erkennung von WLAN als auch mobilen Daten und sendet Ereignisse aus, wenn sich die Verbindung ändert.

Anwendungsfälle

Echtzeit-Netzwerkstatusprüfungen
Behandlung des Offline-Modus
Dynamische UI-Updates basierend auf der Verbindung
Hintergrundverbindungsüberwachung
App-Resilienz bei Netzwerkfluktuationen

Hauptmerkmale

Plattformübergreifende Unterstützung (Android & iOS)
Verwendet native System-APIs für Genauigkeit
Echtzeit-Verbindungsereignis-Emission
Leicht und einfach zu integrieren
Unterstützt Wi-Fi- und Mobilfunkdatenerkennung

Geeignet für

Apps, die Netzwerkbewusstsein erfordern
Offline-fähige Anwendungen
Hintergrunddienstintegrationen
Benutzererfahrungsoptimierung basierend auf der Konnektivität
Entwickler, die zuverlässige Verbindungsprüfungen suchen

Hinweise

Plattformspezifische Berechtigungen erforderlich
Erkennen aller Randfälle wie z. B. Captive Portale nicht möglich
Beschränkt auf den Verbindungsstatus, nicht auf Bandbreite oder Qualität
Abhängig von der Stabilität der nativen Implementierung
Keine integrierte Wiederholungslogik für fehlgeschlagene Verbindungen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Flutter Network Connectivity

A flutter plugin to check for Internet Availability as a stream based on network connectivity status, periodic interval or on call.

Usage

First, add flutter_network_connectivity as a dependency in your pubspec.yaml file.

dependencies:
  flutter_network_connectivity: ^0.0.6

Don't forget to flutter pub get.

Then import:

import 'package:flutter_network_connectivity/flutter_network_connectivity.dart';

Now you can create FlutterNetworkConnectivity object and use its methods

FlutterNetworkConnectivity flutterNetworkConnectivity =
    FlutterNetworkConnectivity(
	  isContinousLookUp: true,  // optional, false if you don't want continous lookup
	  lookUpDuration: const Duration(seconds: 5),  // optional, to override default lookup duration
	  lookUpUrl: 'example.com',  // optional, to override default lookup url
	);

To Check for Stream of Network Connectivity Status

_flutterNetworkConnectivity.getInternetAvailabilityStream().listen((isInternetAvailable) {
  // do something
});

Then Register Availability Listener after setting up Stream Listerer

await _flutterNetworkConnectivity.registerAvailabilityListener();

Unregister on dispose

await _flutterNetworkConnectivity.unregisterAvailabilityListener();

To Check for Internet Availability on Call

bool _isNetworkConnectedOnCall = await
    _flutterNetworkConnectivity.isInternetConnectionAvailable();

Examples

Simple usage example can be found in the example folder.

Android

Uses permission

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Minimum SDK Version 16

iOS

Uses NetworkMonitor, minimum required version 12.0

Demo

About

This plugin uses NetworkCapabilities for Android and NetworkMonitor for iOS to check for network connectivity status.

Contributing?

You're always welcome. See Contributing Guidelines. You can also take a look at Status Tracker to know more information about current or pending features/issues.

Pakete, Repositories und App-Kategorien suchen

Paket installieren