wifi_configuration

Visão geral do pacote

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

Um plugin Flutter que permite a configuração e gerenciamento de redes Wi-Fi em dispositivos Android. Permite aos usuários conectar-se, desconectar-se e listar redes Wi-Fi disponíveis de forma programática. O plugin foi projetado para aplicativos que exigem interação direta com as configurações de Wi-Fi do dispositivo, como utilitários de configuração de rede ou configuradores de dispositivos IoT. Utiliza APIs nativas do Android para fornecer controle confiável de conectividade. Atualmente, suporta apenas Android, sem implementação para iOS.

Casos de uso

Configurando Wi-Fi para dispositivos IoT
Automatizando conexões de rede
Configurando redes de convidados
Gerenciando a conectividade de dispositivos em quiosques
Habilitar configuração de rede autosserviço

Principais recursos

Conectar-se a redes Wi-Fi
Listar redes Wi-Fi disponíveis
Desconectar da rede Wi-Fi
Suporte exclusivo para Android
API simples para gerenciamento de rede

Indicado para

aplicativos de configuração de dispositivos IoT
Aplicações de quiosque
Ferramentas de automação de rede
Gerenciamento de dispositivos empresariais
Utilitários de configuração móvel

Considerações

Limitado a plataformas Android
Requer permissões em tempo de execução
Pode exigir confirmação do usuário para conexão
Sem suporte para iOS
Depende da implementação do fabricante do dispositivo

README original

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

Connect a Flutter app to a Wi-Fi network, read the current SSID, and list available networks on Android and iOS.

This is a Dart 3 rewrite of wifi_configuration 1.2.1. The Dart API is the same (connectToWifi, getWifiList, isConnectedToWifi, connectedToWifi).

Install

dependencies:
  wifi_configuration: ^2.0.0

Usage

import 'package:wifi_configuration/wifi_configuration.dart';

final WifiConnectionStatus status = await WifiConfiguration.connectToWifi(
  'OfficeNet',
  'passphrase',
);

switch (status) {
  case WifiConnectionStatus.connected:
  case WifiConnectionStatus.alreadyConnected:
    break;
  case WifiConnectionStatus.locationNotAllowed:
    // Ask the user to enable location / grant permission.
    break;
  default:
    break;
}

final List<String> nearby = await WifiConfiguration.getWifiList();
final String current = await WifiConfiguration.connectedToWifi();
final bool matches = await WifiConfiguration.isConnectedToWifi('OfficeNet');

packageName from 1.x is still accepted as an optional third argument and is ignored on current Android/iOS.

Platform notes

Android

Add nothing extra in most apps — the plugin manifest already requests:

ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION
NEARBY_WIFI_DEVICES (Android 13+)
Wi-Fi and network state permissions

Location must be on. On Android 10+ the OS shows a system dialog to join the network (WifiNetworkSpecifier). That join is app-scoped and may not appear as a saved system network.

iOS

In Xcode, enable:

Hotspot Configuration
Access Wi-Fi Information
Link NetworkExtension.framework

And in Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location is used to read the current Wi-Fi name and join a network.</string>

Apple does not allow scanning nearby Wi-Fi. getWifiList() returns SSIDs this app has configured, not every hotspot in range.

Status values

Value	Meaning
`connected`	Joined the requested SSID
`alreadyConnected`	Already on that SSID
`notConnected`	Join failed or was cancelled
`platformNotSupported`	OS version cannot configure Wi-Fi
`profileAlreadyInstalled`	iOS already has a profile for this SSID
`locationNotAllowed`	Location permission or services denied

Example

See the example/ app for a small UI that lists networks, shows the current SSID, and connects with a passphrase.

Buscar pacotes, repositórios e categorias de apps