flutter_network_connectivity

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin Flutter que permite o monitoramento em tempo real do status de conectividade de rede em dispositivos Android e iOS. Ele utiliza APIs nativas do sistema — NetworkCapabilities no Android e NetworkMonitor no iOS — para fornecer informações precisas e atualizadas sobre se um dispositivo está conectado à internet. O plugin é leve e projetado para integração perfeita em aplicativos que exigem conscientização de rede, como aqueles que precisam adaptar seu comportamento com base na disponibilidade da conexão. Ele suporta detecção de Wi-Fi e dados móveis e emite eventos quando ocorrem mudanças na conectividade.

Casos de uso

Verificações em tempo real do status da rede
Gerenciamento do modo offline
Atualizações dinâmicas da interface com base na conectividade
Monitoramento de conectividade em segundo plano
Resiliência do aplicativo durante flutuações de rede

Principais recursos

Suporte multiplataforma (Android e iOS)
Usa APIs nativas do sistema para precisão
emissão de evento de conectividade em tempo real
Leve e fácil de integrar
Suporta detecção de Wi-Fi e dados móveis

Indicado para

Aplicativos que exigem conscientização de rede
Aplicações com capacidade offline
Integrações de serviço em segundo plano
Otimização da experiência do usuário com base na conectividade
Desenvolvedores procurando verificações confiáveis de conectividade

Considerações

Requer permissões específicas da plataforma
Pode não detectar todos os casos extremos, como portais cativos
Limitado ao status de conectividade, não à largura de banda ou qualidade
Depende da estabilidade da implementação nativa
Sem lógica embutida de repetição para conexões falhas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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.

Buscar pacotes, repositórios e categorias de apps

Instalar pacote