app_api 是一个用于 Flutter 应用的接口集成插件，它可以帮助开发者更方便地管理和调用 API 接口。以下是使用 app_api 插件的基本步骤和示例代码。

1. 添加依赖

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

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

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

2. 初始化 AppApi

在你的应用的入口文件（通常是 main.dart）中初始化 AppApi。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 初始化 AppApi
    AppApi.initialize(baseUrl: 'https://your-api-endpoint.com');

    return MaterialApp(
      title: 'Flutter AppApi Example',
      home: MyHomePage(),
    );
  }
}

3. 定义 API 接口

你可以通过继承 ApiService 类来定义你的 API 接口。

import 'package:app_api/app_api.dart';

class UserApiService extends ApiService {
  UserApiService() : super(path: '/users');

  Future<dynamic> getUsers() async {
    return await get('');
  }

  Future<dynamic> getUserById(int id) async {
    return await get('/$id');
  }

  Future<dynamic> createUser(Map<String, dynamic> userData) async {
    return await post('', data: userData);
  }

  Future<dynamic> updateUser(int id, Map<String, dynamic> userData) async {
    return await put('/$id', data: userData);
  }

  Future<dynamic> deleteUser(int id) async {
    return await delete('/$id');
  }
}

4. 使用 API 服务

在你的页面或业务逻辑中使用定义好的 API 服务。

import 'package:flutter/material.dart';
import 'package:app_api/app_api.dart';
import 'user_api_service.dart'; // 导入你定义的 API 服务

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<dynamic> users = [];
  final UserApiService userApiService = UserApiService();

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

  Future<void> fetchUsers() async {
    try {
      final response = await userApiService.getUsers();
      setState(() {
        users = response;
      });
    } catch (e) {
      print('Failed to fetch users: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Users'),
      ),
      body: ListView.builder(
        itemCount: users.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(users[index]['name']),
            subtitle: Text(users[index]['email']),
          );
        },
      ),
    );
  }
}

5. 处理错误和异常

在实际应用中，你可能需要处理 API 调用中的错误和异常。app_api 提供了基本的错误处理机制，你可以根据需要自定义错误处理逻辑。

Future<void> fetchUsers() async {
  try {
    final response = await userApiService.getUsers();
    setState(() {
      users = response;
    });
  } on ApiException catch (e) {
    print('API Error: ${e.message}');
  } catch (e) {
    print('An error occurred: $e');
  }
}

6. 配置请求头和其他选项

你可以在 AppApi.initialize 中配置全局的请求头、超时时间等选项。

AppApi.initialize(
  baseUrl: 'https://your-api-endpoint.com',
  headers: {
    'Authorization': 'Bearer your-token',
    'Content-Type': 'application/json',
  },
  timeout: Duration(seconds: 30),
);

7. 使用拦截器

app_api 支持拦截器，你可以在请求发送前或响应接收后执行一些操作。

AppApi.initialize(
  baseUrl: 'https://your-api-endpoint.com',
  interceptors: [
    (request) {
      print('Request: ${request.method} ${request.url}');
      return request;
    },
    (response) {
      print('Response: ${response.statusCode} ${response.body}');
      return response;
    },
  ],
);