如何在Flutter应用中实现对维基百科、亚马逊等指定站点的搜索功能

前置依赖准备 #

你需要先在项目中引入两个核心依赖：

• 网络请求库dio：用于调用各站点的搜索接口，拉取结构化的搜索结果数据
• 跳转工具url_launcher：用于处理用户点击结果后，拉起对应站点的官方APP，无对应APP时自动降级到浏览器打开页面

你可以直接在pubspec.yaml中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  dio: ^5.4.0
  url_launcher: ^6.2.4

添加后执行flutter pub get完成依赖安装。

各站点搜索逻辑实现 #

亚马逊搜索功能 #

1. 接口调用：你可以选择对接亚马逊官方商品搜索接口，或者第三方聚合的亚马逊搜索接口，将用户输入的关键词做URL编码后作为请求参数传入接口即可。不需要结构化展示的极简场景下，也可以直接构造亚马逊搜索页面链接，直接跳转搜索结果页。
2. 结果展示：拿到接口返回的JSON数据后，自行定义实体类解析商品标题、封面图、价格、详情页链接等字段，用ListView/GridView组件在应用内渲染展示即可。
3. 跳转逻辑：用户点击单个商品时，调用url_launcher的launchUrl方法传入商品详情链接，系统会自动识别本地是否安装亚马逊APP，已安装则直接拉起APP打开对应商品页，未安装则跳转浏览器打开。

维基百科搜索功能 #

维基百科提供免费的公开搜索API，调用逻辑和亚马逊类似：将用户输入的关键词作为参数传入搜索接口，解析返回的词条标题、摘要、词条链接字段后渲染到页面，点击时用url_launcher打开词条链接即可，同样支持优先拉起维基百科官方APP。

核心代码示例 #

搜索请求示例 #

import 'package:dio/dio.dart';

// 自定义亚马逊商品实体类
class AmazonProduct {
  final String title;
  final String coverUrl;
  final String price;
  final String detailUrl;

  AmazonProduct({required this.title, required this.coverUrl, required this.price, required this.detailUrl});

  factory AmazonProduct.fromJson(Map<String, dynamic> json) {
    return AmazonProduct(
      title: json['title'],
      coverUrl: json['cover_url'],
      price: json['price'],
      detailUrl: json['detail_url'],
    );
  }
}

// 亚马逊搜索方法
Future<List<AmazonProduct>> searchAmazon(String keyword) async {
  final encodedKeyword = Uri.encodeComponent(keyword);
  final response = await Dio().get('你的亚马逊搜索接口地址?k=$encodedKeyword');
  return (response.data['product_list'] as List).map((item) => AmazonProduct.fromJson(item)).toList();
}

跳转逻辑示例 #

import 'package:url_launcher/url_launcher.dart';

Future<void> openProductDetail(String url) async {
  final targetUri = Uri.parse(url);
  if (await canLaunchUrl(targetUri)) {
    // 优先用外部应用打开，触发对应站点APP拉起逻辑
    await launchUrl(targetUri, mode: LaunchMode.externalApplication);
  }
}

注意事项 #

• 调用各站点接口前需要仔细阅读对应平台的接口使用规范，遵守调用频率限制，避免被接口限流封禁
• 安卓端需要在AndroidManifest.xml中添加url_launcher所需的网址查询权限，iOS端需要在Info.plist中添加对应站点的URL Scheme白名单，避免出现跳转失败的问题
• 用户输入的关键词必须做URL编码处理，避免关键词包含特殊字符时出现请求错误

内容的提问来源于stack exchange，提问作者akhicoda