alt_rick_and_morty 是一个用于 Flutter 的插件，它提供了与 Rick and Morty API 交互的功能，允许开发者轻松获取与《瑞克和莫蒂》动画系列相关的数据，如角色、地点、剧集等信息。

安装插件

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

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

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

使用插件

1. 导入插件

在你的 Dart 文件中导入 alt_rick_and_morty 插件：

import 'package:alt_rick_and_morty/alt_rick_and_morty.dart';

2. 初始化插件

你可以通过 AltRickAndMorty 类来与 API 进行交互。通常不需要显式初始化，直接使用即可。

final rickAndMorty = AltRickAndMorty();

3. 获取数据

alt_rick_and_morty 提供了多种方法来获取不同的数据。以下是一些常见的用法示例：

获取所有角色

void fetchCharacters() async {
  try {
    final characters = await rickAndMorty.getCharacters();
    print(characters);
  } catch (e) {
    print('Error fetching characters: $e');
  }
}

获取单个角色

void fetchCharacter(int id) async {
  try {
    final character = await rickAndMorty.getCharacter(id);
    print(character);
  } catch (e) {
    print('Error fetching character: $e');
  }
}

获取所有地点

void fetchLocations() async {
  try {
    final locations = await rickAndMorty.getLocations();
    print(locations);
  } catch (e) {
    print('Error fetching locations: $e');
  }
}

获取单个地点

void fetchLocation(int id) async {
  try {
    final location = await rickAndMorty.getLocation(id);
    print(location);
  } catch (e) {
    print('Error fetching location: $e');
  }
}

获取所有剧集

void fetchEpisodes() async {
  try {
    final episodes = await rickAndMorty.getEpisodes();
    print(episodes);
  } catch (e) {
    print('Error fetching episodes: $e');
  }
}

获取单个剧集

void fetchEpisode(int id) async {
  try {
    final episode = await rickAndMorty.getEpisode(id);
    print(episode);
  } catch (e) {
    print('Error fetching episode: $e');
  }
}

4. 处理分页

Rick and Morty API 支持分页，你可以通过传递 page 参数来获取特定页的数据。

void fetchCharactersByPage(int page) async {
  try {
    final characters = await rickAndMorty.getCharacters(page: page);
    print(characters);
  } catch (e) {
    print('Error fetching characters: $e');
  }
}

5. 过滤数据

你还可以通过传递过滤参数来获取特定的数据。例如，获取所有状态为“Alive”的角色：

void fetchAliveCharacters() async {
  try {
    final characters = await rickAndMorty.getCharacters(filter: CharacterFilter(status: 'Alive'));
    print(characters);
  } catch (e) {
    print('Error fetching characters: $e');
  }
}

示例代码

以下是一个完整的示例，展示如何使用 alt_rick_and_morty 插件获取并显示角色列表：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: CharacterListScreen(),
    );
  }
}

class CharacterListScreen extends StatefulWidget {
  [@override](/user/override)
  _CharacterListScreenState createState() => _CharacterListScreenState();
}

class _CharacterListScreenState extends State<CharacterListScreen> {
  List<Character> characters = [];
  bool isLoading = true;

  [@override](/user/override)
  void initState() {
    super.initState();
    fetchCharacters();
  }

  void fetchCharacters() async {
    try {
      final rickAndMorty = AltRickAndMorty();
      final fetchedCharacters = await rickAndMorty.getCharacters();
      setState(() {
        characters = fetchedCharacters;
        isLoading = false;
      });
    } catch (e) {
      print('Error fetching characters: $e');
      setState(() {
        isLoading = false;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Rick and Morty Characters'),
      ),
      body: isLoading
          ? Center(child: CircularProgressIndicator())
          : ListView.builder(
              itemCount: characters.length,
              itemBuilder: (context, index) {
                final character = characters[index];
                return ListTile(
                  leading: Image.network(character.image),
                  title: Text(character.name),
                  subtitle: Text(character.status),
                );
              },
            ),
    );
  }
}