Native Ping Checker #

A Flutter plugin for checking internet connectivity using native ICMP ping.

Features #

• Native ICMP ping (no HTTP requests)
• Windows & Android support
• Simple Map-based configuration
• All configuration fields are required
• Automatic periodic checking
• Stream-based status updates

Installation #

dependencies:
  native_ping_checker: ^0.0.1

Usage #

import 'package:native_ping_checker/native_ping_checker.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  try {
    await NativePingChecker.init(
      config: {
        'target': '8.8.8.8',
        'pingCount': 5,
        'timeoutMs': 2000,
        'minSuccessCount': 3,
        'checkIntervalSeconds': 30,
      },
      autoStartPeriodicCheck: true,
      onStatusChange: (isConnected) {
        print('Connection: ${isConnected ? "Online" : "Offline"}');
      },
    );

    runApp(MyApp());
  } on PingConfigException catch (e) {
    print(e.message);
  }
}

Configuration #

All fields are required:

API #

Initialize #

await NativePingChecker.init(
  config: {...},
  autoStartPeriodicCheck: true,  // default: true
  onStatusChange: (isConnected) {},
);

Check Once #

bool isOnline = await NativePingChecker.checkConnection();

Stream #

NativePingChecker.connectionStream.listen((isConnected) {
  print('Status: $isConnected');
});

Control #

NativePingChecker.startPeriodicCheck();
NativePingChecker.stopPeriodicCheck();
NativePingChecker.dispose();

Properties #

bool lastStatus = NativePingChecker.lastStatus;
bool isRunning = NativePingChecker.isPeriodicCheckRunning;
bool isInit = NativePingChecker.isInitialized;
PingConfig config = NativePingChecker.config;

Platform Support #

License #

MIT License