strapi4_client 是一个用于在 Flutter 应用中与 Strapi CMS 进行交互的客户端插件。它简化了与 Strapi API 的通信，使得开发者可以更轻松地在 Flutter 应用中获取、创建、更新和删除 Strapi 中的数据。

以下是如何在 Flutter 项目中使用 strapi4_client 的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  strapi4_client: ^0.0.1  # 请使用最新版本

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

2. 初始化 Strapi 客户端

在你的 Flutter 应用中，首先需要初始化 Strapi 客户端。通常你可以在 main.dart 或某个单独的配置文件中进行初始化。

import 'package:strapi4_client/strapi4_client.dart';

void main() {
  // 初始化 Strapi 客户端
  final strapi = Strapi(
    baseUrl: 'https://your-strapi-instance.com', // 你的 Strapi 实例的 URL
  );

  runApp(MyApp(strapi: strapi));
}

class MyApp extends StatelessWidget {
  final Strapi strapi;

  MyApp({required this.strapi});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Strapi Demo',
      home: MyHomePage(strapi: strapi),
    );
  }
}

3. 使用 Strapi 客户端进行 CRUD 操作

在 MyHomePage 或其他页面中，你可以使用 strapi 实例来进行各种操作。

获取数据

class MyHomePage extends StatefulWidget {
  final Strapi strapi;

  MyHomePage({required this.strapi});

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<dynamic> items = [];

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

  Future<void> fetchData() async {
    try {
      final response = await widget.strapi.find('collection-name'); // 替换为你的集合名称
      setState(() {
        items = response.data;
      });
    } catch (e) {
      print('Error fetching data: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Strapi Data'),
      ),
      body: ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(items[index]['title']), // 替换为你的字段名称
          );
        },
      ),
    );
  }
}

创建数据

Future<void> createItem() async {
  try {
    final response = await widget.strapi.create('collection-name', {
      'title': 'New Item',
      'description': 'This is a new item',
    });
    print('Item created: ${response.data}');
  } catch (e) {
    print('Error creating item: $e');
  }
}

更新数据

Future<void> updateItem(String id) async {
  try {
    final response = await widget.strapi.update('collection-name', id, {
      'title': 'Updated Item',
    });
    print('Item updated: ${response.data}');
  } catch (e) {
    print('Error updating item: $e');
  }
}

删除数据

Future<void> deleteItem(String id) async {
  try {
    await widget.strapi.delete('collection-name', id);
    print('Item deleted');
  } catch (e) {
    print('Error deleting item: $e');
  }
}

4. 处理认证

如果你的 Strapi 实例需要认证，你可以使用 strapi 客户端提供的认证方法。

Future<void> login() async {
  try {
    final response = await widget.strapi.login(
      identifier: 'your-username',
      password: 'your-password',
    );
    print('Login successful: ${response.data}');
  } catch (e) {
    print('Error logging in: $e');
  }
}

5. 处理错误

在使用 strapi4_client 时，确保你处理了可能的错误，例如网络错误或 API 错误。

try {
  final response = await widget.strapi.find('collection-name');
  setState(() {
    items = response.data;
  });
} catch (e) {
  print('Error: $e');
}