Flutter网络代理管理插件proxy_manager的使用

简介

proxy_manager 是一个用于在 Flutter 应用中管理和设置系统代理的插件。它支持所有桌面平台（Windows、Linux (KDE/GNOME/DDE) 和 macOS）。

功能

• 设置或清除所有桌面平台的系统代理设置
  • Windows
  • Linux (KDE/GNOME/DDE)
  • macOS

示例

基本用法

// 单例实例
ProxyManager manager = ProxyManager();

// 设置 HTTP 代理
await manager.setAsSystemProxy(ProxyTypes.http, "127.0.0.1", 1087);

// 设置 HTTPS 代理
await manager.setAsSystemProxy(ProxyTypes.https, "127.0.0.1", 1087);

// 设置 SOCKS4/5 代理
await manager.setAsSystemProxy(ProxyTypes.socks, "127.0.0.1", 1080);

完整示例

以下是一个完整的示例应用，展示了如何在 Flutter 应用中使用 proxy_manager 插件。

main.dart

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:proxy_manager/proxy_manager.dart';

final proxyManager = ProxyManager();

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  final _proxyManagerPlugin = ProxyManager();

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，因此我们在一个异步方法中初始化
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能会失败，所以我们使用 try/catch 来处理 PlatformException
    // 我们还处理了消息可能返回 null 的情况
    try {
      platformVersion = await _proxyManagerPlugin.getPlatformVersion() ??
          'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件在异步平台消息传输过程中被从树中移除，我们希望丢弃回复而不是调用 setState 更新我们不存在的外观
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('Running on: $_platformVersion\n'),
              ElevatedButton(
                onPressed: () async {
                  await _proxyManagerPlugin.setAsSystemProxy(ProxyTypes.http, "127.0.0.1", 1087);
                  ScaffoldMessenger.of(context).showSnackBar(
                    SnackBar(content: Text('HTTP proxy set to 127.0.0.1:1087')),
                  );
                },
                child: Text('Set HTTP Proxy'),
              ),
              ElevatedButton(
                onPressed: () async {
                  await _proxyManagerPlugin.setAsSystemProxy(ProxyTypes.https, "127.0.0.1", 1087);
                  ScaffoldMessenger.of(context).showSnackBar(
                    SnackBar(content: Text('HTTPS proxy set to 127.0.0.1:1087')),
                  );
                },
                child: Text('Set HTTPS Proxy'),
              ),
              ElevatedButton(
                onPressed: () async {
                  await _proxyManagerPlugin.setAsSystemProxy(ProxyTypes.socks, "127.0.0.1", 1080);
                  ScaffoldMessenger.of(context).showSnackBar(
                    SnackBar(content: Text('SOCKS proxy set to 127.0.0.1:1080')),
                  );
                },
                child: Text('Set SOCKS Proxy'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

说明

1. 导入依赖：首先导入 flutter 和 proxy_manager 包。
2. 创建单例实例：创建 ProxyManager 的单例实例。
3. 初始化平台状态：在 initState 方法中初始化平台状态，获取平台版本信息。
4. 设置代理：在 build 方法中添加按钮，点击按钮时设置不同类型的代理，并显示提示信息。

通过以上步骤，你可以在 Flutter 应用中轻松管理和设置系统代理。希望这个示例对你有所帮助！