nanc_api_local 是一个用于在 Flutter 中访问本地 API 接口的插件。它允许你在 Flutter 应用中轻松地与本地服务或 API 进行通信。以下是如何使用 nanc_api_local 插件的详细步骤：

1. 添加依赖

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

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

然后运行 flutter pub get 来获取依赖。

2. 导入包

在你的 Dart 文件中导入 nanc_api_local 包：

import 'package:nanc_api_local/nanc_api_local.dart';

3. 初始化插件

在使用插件之前，你需要先初始化它。通常你可以在 main.dart 中的 main 函数中进行初始化：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  NancApiLocal.initialize();
  runApp(MyApp());
}

4. 创建 API 请求

你可以使用 NancApiLocal 类来创建和发送 API 请求。以下是一个简单的示例，展示如何发送一个 GET 请求：

Future<void> fetchData() async {
  try {
    final response = await NancApiLocal.get('/api/data');
    if (response.statusCode == 200) {
      // 处理成功响应
      print('Data: ${response.body}');
    } else {
      // 处理错误响应
      print('Error: ${response.statusCode}');
    }
  } catch (e) {
    // 处理异常
    print('Exception: $e');
  }
}

5. 发送 POST 请求

你也可以发送 POST 请求，并传递数据：

Future<void> sendData() async {
  try {
    final response = await NancApiLocal.post(
      '/api/data',
      body: {'key': 'value'},
    );
    if (response.statusCode == 200) {
      // 处理成功响应
      print('Data sent successfully');
    } else {
      // 处理错误响应
      print('Error: ${response.statusCode}');
    }
  } catch (e) {
    // 处理异常
    print('Exception: $e');
  }
}

6. 处理响应

你可以根据响应的状态码和内容来处理不同的情况。例如，你可以解析 JSON 数据：

Future<void> fetchAndParseData() async {
  try {
    final response = await NancApiLocal.get('/api/data');
    if (response.statusCode == 200) {
      final Map<String, dynamic> data = jsonDecode(response.body);
      print('Parsed Data: $data');
    } else {
      print('Error: ${response.statusCode}');
    }
  } catch (e) {
    print('Exception: $e');
  }
}

7. 错误处理

在处理网络请求时，务必处理可能发生的错误和异常。你可以使用 try-catch 块来捕获异常，并根据需要进行处理。

8. 其他 HTTP 方法

nanc_api_local 插件还支持其他 HTTP 方法，例如 PUT、DELETE 等。你可以使用类似的方式发送这些请求：

Future<void> updateData() async {
  try {
    final response = await NancApiLocal.put(
      '/api/data/1',
      body: {'key': 'new_value'},
    );
    if (response.statusCode == 200) {
      print('Data updated successfully');
    } else {
      print('Error: ${response.statusCode}');
    }
  } catch (e) {
    print('Exception: $e');
  }
}

9. 配置插件

你可以根据需要对插件进行配置，例如设置超时时间、添加请求头等。具体的配置选项可以参考插件的官方文档。

10. 使用示例

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

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  NancApiLocal.initialize();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Nanc API Local Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: fetchData,
            child: Text('Fetch Data'),
          ),
        ),
      ),
    );
  }

  Future<void> fetchData() async {
    try {
      final response = await NancApiLocal.get('/api/data');
      if (response.statusCode == 200) {
        print('Data: ${response.body}');
      } else {
        print('Error: ${response.statusCode}');
      }
    } catch (e) {
      print('Exception: $e');
    }
  }
}