Flutter宝可梦信息查询插件pokedex的使用

Flutter宝可梦信息查询插件pokedex的使用

pokedex 是一个用于访问宝可梦数据的Dart库。它封装了PokeAPI，可以方便地在Flutter应用中查询各种宝可梦信息。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
    pokedex: ^0.3.0

然后运行 dart pub get 或 flutter pub get 来安装该库。

现在你可以在Dart代码中使用：

import 'package:pokedex/pokedex.dart';

使用

首先创建一个 Pokedex 实例：

final dex = Pokedex();

简单请求

示例代码

import 'package:pokedex/pokedex.dart';

Future<void> main() async {
  final pokedex = Pokedex();

  // 获取特定宝可梦物种的信息
  final aegislashSpecies = pokedex.pokemonSpecies.get(name: 'aegislash');
  print(aegislashSpecies);

  // 通过名称获取宝可梦
  final aegislashBlade = await pokedex.pokemon.get(name: 'aegislash-blade');
  final aegislashShield = await pokedex.pokemon.get(id: 'aegislash-shield');

  // 通过ID获取宝可梦
  aegislashBlade = await pokedex.pokemon.get(id: 10026);
  aegislashShield = await pokedex.pokemon.get(id: 681);
}

终点端点

每个终点端点都支持通过 id 或 name 参数进行查询。你可以参考 PokeAPI v2 文档 了解更多关于数据结构的信息。

草莓

Pokedex().berries.get(name: 'cheri').then((response) {
  print(response);
});

竞赛

Pokedex().contestTypes.get(name: 'cool').then((response) {
  print(response);
});

遇见

Pokedex().encounterMethods.get(name: 'walk').then((response) {
  print(response);
});

进化

Pokedex().evolutionChains.get(id: 1).then((response) {
  print(response);
});

游戏

Pokedex().generations.get(name: 'generation-i').then((response) {
  print(response);
});

物品

Pokedex().items.get(name: 'master-ball').then((response) {
  print(response);
});

地点

Pokedex().locations.get(name: 'sinnoh').then((response) {
  print(response);
});

机器

Pokedex().machines.get(id: 2).then((response) {
  print(response);
});

技能

Pokedex().moves.get(name: 'pound').then((response) {
  print(response);
});

宝可梦

Pokedex().pokemon.get(name: 'clefairy').then((response) {
  print(response);
});

实用工具

Pokedex().languages.get(name: 'ja').then((response) {
  print(response);
});

根端点

每个端点还提供了 getPage 方法来获取分页项目。可以通过配置 offset 和 limit 来控制起始位置和获取数量。

Pokedex().pokemon.getPage(offset: 34, limit: 10).then((response) {
  print(response);
});

或者你可以使用 getAll 方法来获取所有项目。

Pokedex().pokemon.getAll().then((response) {
  print(response);
});

每个端点还提供了 getByUrl 方法来根据提供的URL获取特定项目。

Pokedex().pokemon.getByUrl('https://pokeapi.co/api/v2/pokemon/274/').then((response) {
  print(response);
});

示例代码

以下是完整的示例代码：

import 'package:pokedex/pokedex.dart';

Future<void> main() async {
  final pokedex = Pokedex();

  // 通过Future
  pokedex.pokemonSpecies.get(name: "aegislash").then((aegislashSpecies) {
    print(aegislashSpecies);
  });

  // 通过async函数
  final aegislashBlade = await pokedex.pokemon.get(name: "aegislash-blade");
  print(aegislashBlade);

  // 通过ID获取宝可梦
  final aegislashShield = await pokedex.pokemon.get(id: 681);
  print(aegislashShield);

  // 获取宝可梦物种列表
  final pokemonSpeciesResources = (await pokedex.pokemonSpecies.getPage(limit: 100)).results;
  for (final resource in pokemonSpeciesResources) {
    final species = await pokedex.pokemonSpecies.getByUrl(resource.url);
    print(species);
  }

  // 获取所有草莓
  final berryResources = (await pokedex.berries.getAll()).results;
  for (final resource in berryResources) {
    final berry = await pokedex.berries.getByUrl(resource.url);
    print(berry);
  }

  // 通过URL获取物品
  final item = await pokedex.items.getByUrl('https://pokeapi.co/api/v2/item/100');
  print(item);
}