WiFiFlutter| wifi_iot

Flutter Network pub.dev pub points popularity likes


Introduction

Plugin Flutter which can handle WiFi connections (AP, STA)

Becareful, some commands as no effect on iOS because Apple don't let us to do whatever we want...

WiFi connections

Description Android iOS
Enabling / Disabling WiFi module :warning:(3a) :x:
Getting WiFi status :white_check_mark: :x:
Scanning for networks, with "already-associated" flag :white_check_mark:(4) :x:
Connecting / Disconnecting on a network in WPA / WEP :white_check_mark:(3b) :white_check_mark:(1)
Registering / Unregistering a WiFi network :white_check_mark:(3c) :warning:(2)
Getting informations like : :white_check_mark: :white_check_mark:
- SSID :white_check_mark: :white_check_mark:
- BSSID :white_check_mark: :white_check_mark:
- Current signal strength :white_check_mark: :x:
- Frequency :white_check_mark: :x:
- IP :white_check_mark: :white_check_mark:

:white_check_mark:(1) : On iOS, you can only disconnect from a network which has been added by your app. In order to disconnect from a system network, you have to connect to an other!

:warning:(2) : On iOS, you can forget a WiFi network by connecting to it with the joinOnce flag to true!

:warning:(3): Wifi API changes in Android SDK >= 29, restricts certain behaviour:

  • a. Enable/Disable Wifi Module is deprecated and will always fail [docs]. If you want to open "Wifi Setting" in that case then, set the shouldOpenSettings: true when calling setEnabled.
  • b. Note for connecting to Wifi -
    • (i) WEP security is deprecated and will always fail.
    • (ii) By default the connection would not have internet access and will be disconnected when the app is closed (if permanent network is required(Check :warning:(3c)), use "Register Network" feature) [docs)].
    • (iii) To connect to network with internet use withInternet which is a different API underneath (this API will not disconnect to network after app closes, therefore use removeWifiNetwork method to remove/disconnect network added in previous session) [docs].
    • (iv) Will have to use forceWifiUsage(true) to route app traffic via connected access point, similarly can be disabled to route traffic via cellular network (for internet). This is not enabled by default and left upto to the user.
  • c. Registering Wifi Network, will require user approval - and the network saved would not be controlled by the app (for deletion, updation, etc) [docs];

:warning:(4): This functionality is "discontinued" - checkout new wifi_scan plugin (also by WiFiFlutter) instead.

Additional Wifi protocols on Android side like - Wifi Direct, Wifi Aware, etc are in active discussion at #140. Encourage you to engage if you want this features.

Access Point

Description Android iOS
Getting the status of the Access Point (Disable, disabling, enable, enabling, failed) :white_check_mark: :x:
Enabling / Disabling Access Point :white_check_mark:(1b) :x:
Getting / Setting new credentials (SSID / Password) :warning:(1b - iii) :x:
Enabling / Disabling the visibility of the SSID Access Point :warning:(1a) :x:
Getting the clients list (IP, BSSID, Device, Reachable) :warning:(1a) :x:

:warning:(1): Wifi API changes in Android SDK 26 and 29, restricts certain behaviour:

  • a. This has been deprecated and will always fail for >= 26 Android SDK.
  • b. Uses startLocalOnlyHotspot API to request enabling or disabling WiFi AP for >= 26 Android SDK. This can only be used to communicate between co-located devices connected to the created WiFi Hotspot. Note -
    • (i) Enabling and Disabling WiFi AP needs to request location permission.
    • (ii) The network created by this method will not have Internet access.
    • (iii) There's no way for the user to set WiFi AP's SSID and Passphrase, they are automatically generated by the OS.
    • (iv) This is actually a "request" and not a "command", as the LocalOnlyHotspot is shared (potentially) across applications and therefore a request to enable/disable may not not necessarily trigger the immediate execution of it.

For now, there is no way to set the access point on iOS...

Xcode build (iOS >= 8.0)

To be able to build with Xcode, you must specify use_frameworks! in your Podfile to allow building Swift into static libraries.

Troubleshooting

Don't hesitate and come here, we will be happy to help you!

Contributors ✨

Thanks goes to these 💖 people for their contributions.

This project follows the all-contributors specification. Contributions of any kind welcome!

Libraries

wifi_iot