Flutter网络代理配置插件flutter_proxy_native的使用

一个 Flutter 插件，用于自动获取系统的代理（Proxy）设置，并方便地应用于 Dio 网络请求库。

功能

• 自动检测系统代理: 自动获取 iOS 、 Android 或 MacOS 设备上的系统代理配置。
• Dio 集成: 简化 Dio 网络请求库的代理设置流程。

安装

要开始使用 flutter_proxy_native，请将以下依赖添加到你的 pubspec.yaml 文件中：

dependencies:
  flutter_proxy_native: ^最新版本

然后运行以下命令来安装依赖：

flutter pub get

使用方法

在你的 Dart 代码中，首先导入插件：

import 'package:flutter_proxy_native/flutter_proxy_native.dart';

然后，使用 flutter_proxy_native 获取系统代理，并设置给 Dio：

var proxy = await FlutterProxyNative.getSystemProxy();
Dio dio = Dio();
dio.options = dio.options.copyWith(
  httpClientAdapter: ProxyHttpClientAdapter(proxy: proxy),
);

示例

查看 example 文件夹获取更多关于如何在你的项目中使用 flutter_proxy_native 的示例。

以下是完整的示例代码：

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

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

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

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

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = '未知';
  String _systemProxy = '未知';
  final _flutterProxyPlugin = FlutterProxyNative();

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

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    String platformVersion;
    String systemProxy;
    // 平台消息可能会失败，所以我们使用 try/catch 来处理 PlatformException。
    // 我们还处理了消息可能返回 null 的情况。
    try {
      platformVersion =
          await _flutterProxyPlugin.getPlatformVersion() ?? '未知平台版本';
      systemProxy = await _flutterProxyPlugin.getSystemProxy() ?? "未知系统代理";
    } on PlatformException {
      platformVersion = '获取平台版本失败。';
      systemProxy = '获取系统代理失败。';
    }

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('运行于: $_systemProxy\n'),
        ),
      ),
    );
  }
}