Flutter网络工具插件 network_tools_flutter 的使用

network_tools_flutter 是一个强大的 Flutter 插件，提供了多种网络相关的功能，如 mDNS 搜索、Ping 设备和端口扫描等。本文将介绍如何在 Flutter 项目中使用该插件。

功能

该插件扩展了 network_tools 库的功能，使其能够在 Flutter 环境下运行，并解决了平台限制问题。

开始使用

添加依赖

首先，在 pubspec.yaml 文件中添加 network_tools_flutter 和 path_provider 依赖：

dependencies:
  flutter:
    sdk: flutter
    
  network_tools_flutter: ^1.0.4
  path_provider: ^2.1.2

初始化插件

在 main() 函数中初始化插件：

import 'package:flutter/material.dart';
import 'package:network_tools_flutter/network_tools_flutter.dart';
import 'package:path_provider/path_provider.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final appDocDirectory = await getApplicationDocumentsDirectory();
  await configureNetworkToolsFlutter(appDocDirectory.path, enableDebugging: true);
  runApp(const MyApp());
}

注意：请确保调用 configureNetworkToolsFlutter 方法时传递正确的应用文档目录路径。

示例 Demo

下面是一个完整的示例 Demo，展示了如何使用 network_tools_flutter 插件进行 Ping 设备、端口扫描和 mDNS 搜索等功能。

主界面

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  const MyHomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home'),
      ),
      body: Column(
        crossAxisAlignment: CrossAxisAlignment.center,
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          TextButton(
            onPressed: () {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) => const PingableDevices(),
                ),
              );
            },
            child: const Text('Pingable Devices'),
          ),
          const SizedBox(height: 20, width: double.infinity),
          TextButton(
            onPressed: () {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) => const PortScannerPage(),
                ),
              );
            },
            child: const Text('Port Scanner'),
          ),
          const SizedBox(height: 20, width: double.infinity),
          TextButton(
            onPressed: () {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) => const MdnsScannerPage(),
                ),
              );
            },
            child: const Text('mDNS Scanner'),
          ),
        ],
      ),
    );
  }
}

权限配置

Android

对于 Android 平台，确保最低 API 级别为 21，并在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />

iOS

对于 iOS 平台，在 Info.plist 文件中添加以下权限（替换服务类型为你自己的）：

<key>NSLocalNetworkUsageDescription</key>
<string>Required to discover local network devices</string>
<key>NSBonjourServices</key>
<array>
    <string>_http._tcp</string>
</array>