k_network 是一个基于 Dio 的 Flutter 网络请求插件，它简化了网络请求的过程，并提供了一些便捷的功能。以下是使用 k_network 进行网络请求的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 k_network 依赖：

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

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

2. 初始化 KNetwork

在使用 k_network 之前，通常需要在应用的某个地方（如 main.dart 中）进行初始化：

import 'package:k_network/k_network.dart';

void main() {
  KNetwork.init(
    baseUrl: 'https://api.example.com', // 你的API基础URL
    interceptors: [
      // 可以添加自定义拦截器
      LogInterceptor(), // 用于打印请求日志
    ],
  );
  runApp(MyApp());
}

3. 发起网络请求

k_network 提供了 get, post, put, delete 等方法来发起网络请求。以下是一些示例：

发起 GET 请求

import 'package:k_network/k_network.dart';

Future<void> fetchData() async {
  try {
    final response = await KNetwork.get('/endpoint');
    print(response.data); // 打印响应数据
  } catch (e) {
    print('Error: $e');
  }
}

发起 POST 请求

import 'package:k_network/k_network.dart';

Future<void> postData() async {
  try {
    final response = await KNetwork.post(
      '/endpoint',
      data: {
        'key1': 'value1',
        'key2': 'value2',
      },
    );
    print(response.data); // 打印响应数据
  } catch (e) {
    print('Error: $e');
  }
}

发起 PUT 请求

import 'package:k_network/k_network.dart';

Future<void> updateData() async {
  try {
    final response = await KNetwork.put(
      '/endpoint',
      data: {
        'key1': 'updatedValue1',
        'key2': 'updatedValue2',
      },
    );
    print(response.data); // 打印响应数据
  } catch (e) {
    print('Error: $e');
  }
}

发起 DELETE 请求

import 'package:k_network/k_network.dart';

Future<void> deleteData() async {
  try {
    final response = await KNetwork.delete('/endpoint');
    print(response.data); // 打印响应数据
  } catch (e) {
    print('Error: $e');
  }
}

4. 处理响应

k_network 的响应对象与 Dio 的响应对象相同，通常包含以下属性：

• data: 响应的数据（通常是 JSON 格式）。
• statusCode: HTTP 状态码。
• statusMessage: 状态信息。

你可以根据需要对响应数据进行处理。

5. 错误处理

k_network 会自动处理一些常见的网络错误，但你也可以在 catch 块中自定义错误处理逻辑。

try {
  final response = await KNetwork.get('/endpoint');
  print(response.data);
} catch (e) {
  if (e is DioError) {
    print('DioError: ${e.message}');
  } else {
    print('Error: $e');
  }
}

6. 添加拦截器

你可以在初始化时添加拦截器，或者在运行时动态添加。拦截器可以用于日志记录、添加请求头、处理错误等。

KNetwork.init(
  baseUrl: 'https://api.example.com',
  interceptors: [
    InterceptorsWrapper(
      onRequest: (options, handler) {
        // 在请求前添加一些逻辑
        options.headers['Authorization'] = 'Bearer token';
        return handler.next(options);
      },
      onResponse: (response, handler) {
        // 处理响应
        return handler.next(response);
      },
      onError: (DioError e, handler) {
        // 处理错误
        return handler.next(e);
      },
    ),
  ],
);