wifi_iot 0.3.10 | Flutter package

| `wifi_iot`

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	⚠️(3a)	❌
Getting WiFi status	✅	❌
Scanning for networks, with "already-associated" flag	✅	❌
Connecting / Disconnecting on a network in WPA / WEP	✅(3b)	✅(1)
Registering / Unregistering a WiFi network	✅(3c)	⚠️(2)
Getting informations like :	✅	✅
- SSID	✅	✅
- BSSID	✅	✅
- Current signal strength	✅	❌
- Frequency	✅	❌
- IP	✅	✅

✅(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!

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

⚠️(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. For Connecting to Wifi, WEP security is deprecated and will always fail, also the network will be disconnected when the app is closed (if permanent network is required(Check ⚠️(3c)), use "Register Network" feature) [docs)]. By default the connection would not have internet access, to connect to network with internet user withInternet which is a different API underneath (this API will not disconnect to network after app closes) [docs].
c. Registering Wifi Network, will require user approval - and the network saved would not be controlled by the app (for deletion, updation, etc) [docs];

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)	⚠️(1b)	❌
Enabling / Disabling Access Point	✅(1c)	❌
Getting / Setting new credentials (SSID / Password)	⚠️(1b)	❌
Enabling / Disabling the visibility of the SSID Access Point	⚠️(1a)	❌
Getting the clients list (IP, BSSID, Device, Reachable)	⚠️(1a)	❌

⚠️(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. This has been deprecated and will always fail for >= 26 Android SDK. There is a way to make "get" methods work for >= 29 Android SDK, but is currently not implemented, request these features if you need them at #134.
c. Uses startLocalOnlyHotspot API to request enabling or disabling WiFi AP for >= 29 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 wonderful people (emoji key):

_Florian 🤔 💻 📖 💡 👀	_yhua537 💻	_{Anhar Ismail} 🎨	_{Tristan Linnell} 🐛	_{Patrick Boos} 💻 💡	_{Sébastien Faye} 💻	_{Ben Hagen} 🐛 💻	_{Võ Ngọc Minh} 🐛	_{Cesar Sanz} 🐛 💻
_Kvikk 💻	_Bob 🐛 💻	_{Richard Tarnoczi} 🐛	_{Matthijs Meulenbrug} 🐛	_{Crifan Li} 🐛 💻	_{Julien Robert} 💻 💡 📖	_{Nicolas Juelle} 🐛 💻 📖	_{Niek van der Maas} 🐛 👀 💻	_{Nicolas B} 🐛
_{Harsh Bhikadia} 💻 👀 🚧 📖 🤔	_{Josip Krnjic} 🐛	_{Conner Aldrich} 🐛	_{Pierre Rossinès} 💻	_andzejsw 🐛	_{Sanjay Sah} 🐛	_Dreamwalker 🐛	_{Kriss_Frost} 🐛	_{Binh Do D.} 🐛
_{Quan Nguyen H. VN.Danang} 💻	_{Guy Luz} 🐛	_yurir 🐛	_BillMac4440 🐛 👀	_{Federico Pellegrin} 💻 👀 🐛 📖	_{Diego Tori} 👀	_IskanderA1 💻	_EgHubs 🐛	_{Maverick G. Fabroa} 💻 💡 📖 👀
_{Benoit Duffez} 🐛	_{Justin DeSimpliciis} 💻	_{Dominik Starke} 🐛 💻	_FelixSmart 🐛	_{Brian Semrau} 🐛	_Hallot 🐛 💻	_{Pedro Albuquerque} 🐛	_Starsoft4u 🐛	_troyredder 🐛