ssid_resolver_flutter 1.0.3

A flutter plugin to resolve the SSID of the connected WiFi network, or simply: 'Get my Wifi Name'

ssid_resolver_flutter - "Get my Wifi Name"

A flutter plugin to resolve the SSID of the connected WiFi network, or simply: "Get my Wifi Name". For iOS and Android. This implementation uses the latest Android and iOS APIs as of January 2025.

This plugin is based on my two standalone implementations for iOS (https://github.com/raoulsson/ssid-resolver-ios) and Android (https://github.com/raoulsson/ssid-resolver-android).

Android	iOS
Not all permissions granted	Not all permissions granted
OS dialog to grant permissions	OS dialog to grant permissions
All permissions granted	All permissions granted
Network SSID resolved	Network SSID resolved

Usage and Configuration

SSID Resolution Flow

The SSID resolver provides three key methods:

• resolveSSID(): Returns the connected WiFi SSID or 'Unknown'
• checkPermissionStatus(): Verifies required permissions
• requestPermission(): Handles permission requests

Typical Usage Flow

1. Check permission status
2. Request permissions if needed
3. Resolve SSID

Note: On iOS, WiFi access requires location permissions, even with XCode WiFi capability configured.

Usage

The plugin is available on pub.dev. To use the plugin in your project, add ssid_resolver_flutter as a dependency in your pubspec.yaml file:

  ssid_resolver_flutter: ^x.y.z

copied to clipboard

In the folder example/lib you can find examples app that use this plugin, see below for a more detailed discussion. The important configuration parts for iOS and Android are listed below.

iOS Permission Configuration

Needs these permissions in the Info.plist file:

    <key>NSLocationWhenInUseUsageDescription</key>
    <string>This app needs access to location to determine the WiFi information.</string>
    <key>NSLocationUsageDescription</key>
    <string>This app needs access to location to determine the WiFi information.</string>
    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
    <string>This app needs access to location to determine the WiFi information.</string>
    <key>com.apple.developer.networking.wifi-info</key>
    <true/>

copied to clipboard

And also the "Access WiFi Information". Either open <project_root>/ios/Runner/Runner.xcodeproj in XCode and go to "Signing & Capabilities". Add the "Access WiFi Information" capability.

Add WiFi Capability 1	Add WiFi Capability 2

This should produce the file <project_root>/ios/Runner/Runner.entitlements with this content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.networking.wifi-info</key>
    <true/>
</dict>
</plist>

copied to clipboard

Android Permission Configuration

For Android, the AndroidManifest.xml file needs these permissions:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

copied to clipboard

And also the following queries:

<queries>
    <package android:name="com.google.android.gms" />
    <package android:name="com.android.settings" />
</queries>

copied to clipboard

Examples

The plugin is used in the example app in the example/lib folder. Use the debug_app.dart to fix your permissions issues. The example app demonstrates the usage of the plugin in a simple way, showing all the granted and missing permissions. Note that only the location permissions need user consent and the other ones have to be granted in the AndroidManifest.xml and Info.plist files, as mentioned above.

1. Using SSIDResolver Mixin

The easiest and fastest way to use the plugin is by applying the mixin: SSIDResolverMixin. This will handle the permission requests and SSID resolution for you. Simply add the mixin to your view and implement the onSSIDResolved method. Here the complete code:

    class MyClientOne extends StatefulWidget {
      const MyClientOne({super.key});
      @override
      State<MyClientOne> createState() => _MyClientOneState();
    }
    
    class _MyClientOneState extends State<MyClientOne> with SSIDResolverMixin<MyClientOne> {
      String _ssid = '';
    
      @override
      void onSSIDChanged(String ssid) {
        setState(() => 
          _ssid = ssid
        );
      }
    
      @override
      Widget build(BuildContext context) {
        return Center(
          child: Text(_ssid),
        );
      }
    }

copied to clipboard

This code will trigger the permission request dialog if needed and resolve the SSID in one step. The source code is here: ssidresolver_mixin_example.dart.

2. Using SSIDHelper

Usually the location permission is given once, after the app is downloaded and started for the first time. Therefore, if you have multiple screens, before you need the SSID, you can request the permission on app startup and then simply resolve the SSID later on in the code.

On a flutter screen that is shown after startup, do the initialization in the initState method:

    final ssidHelper = SSIDHelper();
    
    @override
    void initState() {
      super.initState();
      _ssidManager.initialize();
    }
    
    @override
    void dispose() {
      _ssidManager.dispose();
      super.dispose();
    }

copied to clipboard

This will trigger the permission request dialog if needed. After that, on a follow up screen, you can do the actual resolving, which now should work on the first run, if granted:

    Future<void> _resolveSSID() async {
      final ssid = await ssidHelper.getSSID();
      setState(() => _ssid = ssid);
    }

copied to clipboard

These two steps are combined in the example app: ssidhelper_example.dart. You will notice that the SSID only resolves after you click the button for the second time.

3. "Do It Yourself"

This example shows how to use the plugin "hands-on". To get the permissions, the OS opens it's own modal dialog and the later returns to the app. If you need full control over the process, you therefore need to use the WidgetsBindingObserver, register your class as an observer and implement the didChangeAppLifecycleState method. Have a look at the "Do It Yourself" implementation that can be found in the example app folder here: do_it_yourself_example.dart.

Below is part of the source code. In the case permissions are not yet granted, the OS will take over and show the permission dialog. Thus, when the app is resumed, the observer will check the permission status and continue the flow.

class _MyClientThreeState extends State<MyClientThree> with WidgetsBindingObserver {
  final _ssidResolver = SSIDResolver();
  String _ssid = '';
  bool _isRequestingPermission = false;
  Timer? _permissionCheckTimer;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    _permissionCheckTimer?.cancel();
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.resumed && _isRequestingPermission) {
      _checkPermissionAndContinue();
    }
  }

  Future<void> _checkPermissionAndContinue() async {
    _permissionCheckTimer?.cancel();
    _isRequestingPermission = false;

    final permissionStatus = await _ssidResolver.checkPermissionStatus();
    if (permissionStatus.isGranted) {
      final ssid = await _ssidResolver.resolveSSID();
      setState(() => _ssid = ssid);
    } else {
      setState(() => _ssid = "Permission denied");
    }
  }

  Future<void> _getSSID() async {
    setState(() => _ssid = "Checking permissions...");

    final initialStatus = await _ssidResolver.checkPermissionStatus();
    if (initialStatus.isGranted) {
      final ssid = await _ssidResolver.resolveSSID();
      setState(() => _ssid = ssid);
      return;
    }

    _isRequestingPermission = true;
    await _ssidResolver.requestPermission();

    // Check immediately in case no modal was shown
    await Future.delayed(const Duration(milliseconds: 100));
    if (!_isRequestingPermission) return;

    await _checkPermissionAndContinue();

    // Set up periodic checks in case the app didn't lose focus
    _permissionCheckTimer = Timer.periodic(
      const Duration(milliseconds: 100),
          (_) => _checkPermissionAndContinue(),
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
          ...
          // SSID Result Display
          Container(
            padding: const EdgeInsets.all(12),
            decoration: BoxDecoration(
              color: const Color(0xFFE0E0E0),
              borderRadius: BorderRadius.circular(8),
            ),
            child: Text(
              _ssid,
              textAlign: TextAlign.center,
              style: const TextStyle(
                color: Color(0xFF142467),
                fontSize: 30,
                fontWeight: FontWeight.bold,
              ),
            ),
          ),
          ...
    );
  }
}

copied to clipboard

If you need to know the SSID on load, you can call _getSSID() in the initState method.

Troubleshooting

If you run into permissions issues, make sure to check the permissions in the AndroidManifest.xml and Info.plist files as described above and try running the app on a real device instead of the emulator. iOS will not give you a SSID on the simulator.

Also run the example app: debug_app.dart and check the output. That should show which permissions are missing.

I hope this helps.

License

Copyright 2025 Raoul Marc Schmidiger ([e-mail])

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.