system_network_proxy_web 是一个 Flutter 插件，用于在 Web 平台上配置系统网络代理。这个插件可以帮助你在 Flutter Web 应用中设置或获取系统的网络代理配置。

安装

首先，你需要在 pubspec.yaml 文件中添加 system_network_proxy_web 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  system_network_proxy_web: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

使用

1. 设置代理

你可以使用 SystemNetworkProxyWeb.setProxy 方法来设置系统的网络代理配置。

import 'package:system_network_proxy_web/system_network_proxy_web.dart';

Future<void> setProxy() async {
  try {
    await SystemNetworkProxyWeb.setProxy(
      host: 'proxy.example.com',
      port: 8080,
      bypass: ['localhost', '127.0.0.1'],
    );
    print('Proxy set successfully');
  } catch (e) {
    print('Failed to set proxy: $e');
  }
}

2. 获取代理配置

你可以使用 SystemNetworkProxyWeb.getProxy 方法来获取当前的系统代理配置。

import 'package:system_network_proxy_web/system_network_proxy_web.dart';

Future<void> getProxy() async {
  try {
    final proxy = await SystemNetworkProxyWeb.getProxy();
    print('Proxy Host: ${proxy.host}');
    print('Proxy Port: ${proxy.port}');
    print('Bypass List: ${proxy.bypass}');
  } catch (e) {
    print('Failed to get proxy: $e');
  }
}

3. 清除代理配置

你可以使用 SystemNetworkProxyWeb.clearProxy 方法来清除系统的代理配置。

import 'package:system_network_proxy_web/system_network_proxy_web.dart';

Future<void> clearProxy() async {
  try {
    await SystemNetworkProxyWeb.clearProxy();
    print('Proxy cleared successfully');
  } catch (e) {
    print('Failed to clear proxy: $e');
  }
}

注意事项

1. 平台支持：system_network_proxy_web 插件仅支持 Web 平台。如果你需要在其他平台（如 Android、iOS）上配置代理，你需要使用其他插件或平台特定的方法。

2. 浏览器限制：由于浏览器的安全限制，某些浏览器可能不允许通过 JavaScript 直接修改系统代理配置。因此，插件在某些浏览器中可能无法正常工作。

3. 用户权限：修改系统代理配置通常需要管理员权限。因此，在 Web 应用中直接修改代理配置可能会受到限制。

示例代码

以下是一个完整的示例代码，展示了如何设置、获取和清除系统代理配置：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('System Network Proxy Web Example')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: setProxy,
                child: Text('Set Proxy'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: getProxy,
                child: Text('Get Proxy'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: clearProxy,
                child: Text('Clear Proxy'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> setProxy() async {
    try {
      await SystemNetworkProxyWeb.setProxy(
        host: 'proxy.example.com',
        port: 8080,
        bypass: ['localhost', '127.0.0.1'],
      );
      print('Proxy set successfully');
    } catch (e) {
      print('Failed to set proxy: $e');
    }
  }

  Future<void> getProxy() async {
    try {
      final proxy = await SystemNetworkProxyWeb.getProxy();
      print('Proxy Host: ${proxy.host}');
      print('Proxy Port: ${proxy.port}');
      print('Bypass List: ${proxy.bypass}');
    } catch (e) {
      print('Failed to get proxy: $e');
    }
  }

  Future<void> clearProxy() async {
    try {
      await SystemNetworkProxyWeb.clearProxy();
      print('Proxy cleared successfully');
    } catch (e) {
      print('Failed to clear proxy: $e');
    }
  }
}