Flutter客户端集成插件tenor_client的使用

Flutter客户端集成插件tenor_client的使用

Tenor Client

tenor_client 是一个用于获取GIF的客户端。

安装 💻

注意事项：为了开始使用 Tenor Client，您的机器上必须安装了 <a href="https://dart.dev/get-dart">Dart SDK</a>。

在您的 pubspec.yaml 文件中添加 tenor_client：

dependencies:
  tenor_client:

然后运行以下命令以安装它：

dart pub get

持续集成 🤖

Tenor Client 自带了一个由 <a href="https://github.com/VeryGoodOpenSource/very_good_workflows">Very Good Workflows</a> 提供的 GitHub Actions 工作流。您可以根据需要添加自己的 CI/CD 解决方案。默认情况下，每次拉取请求和推送都会触发 CI 对代码进行格式化、静态分析和测试，以确保代码的一致性和正确性。该项目使用 <a href="https://pub.dev/packages/very_good_analysis">Very Good Analysis</a> 进行严格的分析选项，并使用 <a href="https://github.com/marketplace/actions/very-good-coverage">Very Good Workflows</a> 来强制执行代码覆盖率。

运行测试 🧪

要运行所有单元测试，请执行以下命令：

dart pub global activate coverage 1.2.0
dart test --coverage=coverage
dart pub global run coverage:format_coverage --lcov --in=coverage --out=coverage/lcov.info

要查看生成的覆盖率报告，可以使用 <a href="https://github.com/linux-test-project/lcov">lcov</a>。

# 生成覆盖率报告
genhtml coverage/lcov.info -o coverage/

# 打开覆盖率报告
open coverage/index.html

示例代码

以下是使用 tenor_client 的完整示例代码：

import 'package:example/pages/autocomplete_page.dart';
import 'package:example/pages/list_page.dart';
import 'package:example/pages/trending_page.dart';
import 'package:flutter/material.dart';
import 'package:tenor_client/tenor_client.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late TenorClient _tenorClient;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化 TenorClient，替换为您自己的 API Key
    _tenorClient = TenorClient(
      apiKey: '<INSERT-KEY-HERE>',
      countryCode: 'GB',
      clientKey: 'example_app',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
      routes: {
        // 添加路由到不同的页面
        '/list': (context) => ListPage(
              tenorClient: _tenorClient,
            ),
        '/trending': (context) => TrendingPage(
              tenorClient: _tenorClient,
            ),
        '/autocomplete': (context) => AutocompletePage(
              tenorClient: _tenorClient,
            ),
      },
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 添加按钮导航到不同的页面
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).pushNamed('/list');
              },
              child: const Text('List Page'),
            ),
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).pushNamed('/trending');
              },
              child: const Text('Trending Page'),
            ),
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).pushNamed('/autocomplete');
              },
              child: const Text('Autocomplete Page'),
            ),
          ],
        ),
      ),
    );
  }
}