Flutter谷歌图书API集成插件google_books的使用

在本教程中，我们将学习如何在Flutter应用中使用google_books插件来获取图书信息。该插件可以帮助你轻松地集成Google Books API，从而获取书籍详情。

安装插件

首先，在你的pubspec.yaml文件中添加google_books依赖：

dependencies:
  flutter:
    sdk: flutter
  google_books: ^0.1.0 # 请检查最新的版本号

然后运行flutter pub get命令以安装依赖项。

配置权限

确保在AndroidManifest.xml中添加网络访问权限（位于android/app/src/main/目录下）：

<uses-permission android:name="android.permission.INTERNET"/>

对于iOS，确保在Info.plist文件中添加网络访问权限（位于ios/Runner/目录下）：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

使用插件

接下来，我们将编写一个简单的Flutter应用来展示如何使用google_books插件获取并显示书籍信息。

示例代码

首先，创建一个新的Flutter项目，或者在现有项目中添加以下代码。

main.dart

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Google Books API Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: BookSearchPage(),
    );
  }
}

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

class _BookSearchPageState extends State<BookSearchPage> {
  final TextEditingController _searchController = TextEditingController();
  List<Map<String, dynamic>> _books = [];

  void searchBooks(String query) async {
    if (query.isEmpty) return;

    try {
      final response = await GoogleBooks.search(query);
      setState(() {
        _books = response['items'];
      });
    } catch (e) {
      print('Error fetching books: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('搜索书籍'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          children: [
            TextField(
              controller: _searchController,
              decoration: InputDecoration(
                labelText: '请输入书名或作者',
                border: OutlineInputBorder(),
              ),
              onSubmitted: (_) => searchBooks(_searchController.text),
            ),
            SizedBox(height: 10),
            Expanded(
              child: ListView.builder(
                itemCount: _books.length,
                itemBuilder: (context, index) {
                  final book = _books[index];
                  return ListTile(
                    leading: Image.network(book['volumeInfo']['imageLinks']?['thumbnail'] ?? ''),
                    title: Text(book['volumeInfo']['title']),
                    subtitle: Text(book['volumeInfo']['authors'].join(', ')),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

代码解释

1. 导入必要的库：

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

2. 初始化应用：

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

3. 创建主应用结构：

   class MyApp extends StatelessWidget {
     [@override](/user/override)
     Widget build(BuildContext context) {
       return MaterialApp(
         title: 'Google Books API Demo',
         theme: ThemeData(
           primarySwatch: Colors.blue,
         ),
         home: BookSearchPage(),
       );
     }
   }
   

4. 定义搜索页面：

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

5. 实现搜索逻辑：

   class _BookSearchPageState extends State<BookSearchPage> {
     final TextEditingController _searchController = TextEditingController();
     List<Map<String, dynamic>> _books = [];
   
     void searchBooks(String query) async {
       if (query.isEmpty) return;
   
       try {
         final response = await GoogleBooks.search(query);
         setState(() {
           _books = response['items'];
         });
       } catch (e) {
         print('Error fetching books: $e');
       }
     }
   

6. 构建UI：

   [@override](/user/override)
   Widget build(BuildContext context) {
     return Scaffold(
       appBar: AppBar(
         title: Text('搜索书籍'),
       ),
       body: Padding(
         padding: const EdgeInsets.all(8.0),
         child: Column(
           children: [
             TextField(
               controller: _searchController,
               decoration: InputDecoration(
                 labelText: '请输入书名或作者',
                 border: OutlineInputBorder(),
               ),
               onSubmitted: (_) => searchBooks(_searchController.text),
             ),
             SizedBox(height: 10),
             Expanded(
               child: ListView.builder(
                 itemCount: _books.length,
                 itemBuilder: (context, index) {
                   final book = _books[index];
                   return ListTile(
                     leading: Image.network(book['volumeInfo']['imageLinks']?['thumbnail'] ?? ''),
                     title: Text(book['volumeInfo']['title']),
                     subtitle: Text(book['volumeInfo']['authors'].join(', ')),
                   );
                 },
               ),
             ),
           ],
         ),
       ),
     );
   }