Apollo 客户端入门教程

1. 项目目录结构及介绍

Apollo 客户端的 Github 仓库中包含了以下主要目录和文件：

• README.md: 项目的基本信息和简介。
• src: 源代码目录，包括客户端的主要实现。
• packages: 分包目录，包含了 Apollo 客户端的不同组件和库。
• docs: 文档相关的内容。
• examples: 示例应用目录，用于演示如何使用 Apollo 客户端。
• scripts: 项目构建和脚本相关的文件。
• test: 测试用例和测试配置。
• tsconfig.json, tsconfig.tests.json: TypeScript 配置文件。
• package.json, package-lock.json: npm 包管理和依赖锁定信息。

2. 项目启动文件介绍

Apollo 客户端的核心是 src/index.js（或对应的 TypeScript 文件 src/index.ts），这是一个入口点，通常用于导出 Apollo Client 实例。例如，以下是一个简单的设置示例：

// src/index.js
import { ApolloClient } from 'apollo-client';
import { HttpLink } from 'apollo-link-http';
import { InMemoryCache } from 'apollo-cache-inmemory';

const httpLink = new HttpLink({ uri: 'http://localhost:4000/graphql' });
const client = new ApolloClient({
  link: httpLink,
  cache: new InMemoryCache(),
});

export default client;

在这个例子中，ApolloClient 是初始化的核心，它被配置了一个 HTTP 连接 (HttpLink) 和一个缓存实例 (InMemoryCache)。http://localhost:4000/graphql 是你的 GraphQL 服务器的地址。

3. 项目的配置文件介绍

在 Apollo 客户端中，配置主要通过创建 Apollo Client 的实例进行。一些关键配置项包括：

link

这是 Apollo 的中间件链，负责处理网络请求。例如，我们使用了 HttpLink 来处理向 GraphQL 服务器发送的请求。

cache

cache 用于存储从服务器获取的数据。InMemoryCache 是默认的内存中缓存实现。

除此之外，ApolloClient 初始化还可以接受其他配置项，如 connectToDevTools (是否启用图形化调试工具) 和 defaultOptions (全局查询选项)。具体配置方式取决于你的应用程序需求。

要运行示例或者自定义项目，请确保安装所有依赖并遵循 package.json 中的脚本指示。通常，这会涉及执行像 npm install 或者 yarn 之类的命令来安装依赖，然后运行 npm run start 或 yarn start 启动应用。

更多详细信息可参考 Apollo 官方文档：

• Apollo Client 文档
• 快速上手指南