这是一份官方指南，指导你如何在 React 或 React Native 应用中借助 react-apollo 来使用 GraphQL。通过 React-Apollo 将 GraphQL 查询绑定到 React 组件，这种方式既简便又强大，因为它帮你做好数据的请求和管理，然后你就可以专心开发 UI。同时，它提供丰富的钩子方法和扩展机制，让你完全可控。
关注 GitHub 上的仓库：React-Apollo，Apollo 客户端 和 本文档。
快速入门
如果你熟悉 Web 开发，但以前没有用过 GraphQL 或 Apollo，不怕，这里有一套简明教程和例子，花几个小时，你就可以成为高级 GraphQL 开发了！如果你熟悉 GraphQL，则可以直接进入安装。
1.简单的例子
快速进入一个简单 app，展示一个用 React Native 与 Apollo 开发的界面。这就是在 Apollo 客户端主页上看到的 app，不过多了一些操作交互的建议，还有更详细的代码解释。
2.全栈 GraphQL + React 教程
本教程将介绍如何搭建 Apollo Client、编写简单服务器，以及如何将它们连接在一起，这个教程几乎每周都在更新。这是由 React-Apollo 的核心开发者 Jonas Helfer 编写的。
3. How to GraphQL
这份社区发起的教程，指导你从零开始构建一个简单的 Hacker News 前端应用。有 React 版，还有其他平台版本。这个「How to GraphQL」教程是由 Graphcool 团队和社区进行维护，还提供一个托管的 GraphQL 后端平台，让你不用写一行代码就可以跑 GraphQL 服务器。
4. 使用与实践
学习完例子和教程，就可以更加深入了。我们花了很多时间编写这份指南，让你可以像看书一样学习一切 Apollo 和 GraphQL 能做的。特别是，查看「使用」部分，了解 querys 和 mutations 等基本功能，而「实践」部分则针对特定场景实现一些更高级的目标，例如服务端渲染。如果你遇到任何问题，随时向 Stack Overflow (带上 apollo 标签) 或 Apollo 社区 Slack 提问！
兼容工具
Apollo 客户端的首要设计原则就是兼容你正在使用的前后端工具。维护人员关注解决这些难题：GraphQL 缓存、请求管理、UI 更新，如果对其他方面有任何技术需求或者不同偏好，我们希望也能做到位。
React 工具
Apollo 经过专门设计，可以跟目前 React 开发者使用的工具很好的结合。下面列举一些：
React Native 和 Expo：Apollo 在 React Native 中开箱即用。它甚至预装在 Expo Snack 中，因此你可以在浏览器中直接构建一个 React Native + Apollo 的应用。
Redux ：Apollo 客户端内部使用 Redux，你可以将其集成到现有 store，使用你喜欢的 Redux 工具，例如 dev tools 或 数据存储持久库。你还可以将 Apollo 与任何其他数据管理库（如 MobX）一起使用。
React Router ：Apollo 客户端完全独立于路由，这意味着你可以使用任何版本的 React Router 或其他适合 React 的路由库。另外搭建服务器端渲染也特别简单。
Recompose ：借助 Recompose，React-Apollo 的高阶组件可以与各种工具结合，为组件增强功能。 读读如何使用它来加载状态和变量、mutations 以及与 Redux container 相结合。
Next.js ：你可以结合轻量级的 Next.js 框架使用 Apollo，实现同构渲染 React 应用。有关详细信息，请查看 这篇文章，或下载 官方示例。
如果你有一个喜欢的 React 工具，但是集成到 Apollo 有些难度，请提一个 issue，我们一起让它更好地集成起来。
GraphQL 服务器
因为 Apollo 不会假定任超出何官方 GraphQL 规范以外的东西，所以它可以应用在各种语言实现的 GraphQL 服务器。它也不对你的 schema 作额外的要求;如果你可以向符合规范的 GraphQL 服务器发送查询，那么 Apollo 就可以处理它。你可以在 graphql.org 上找到一些 GraphQL 服务器的实现。
其他 JS、native平台
这个文档网站是特别针对 React 的，但 Apollo 已为每个客户端平台提供了实现：
- JavaScript
- 原生移动平台
项目目标
Apollo 客户端是 GraphQL 的 JavaScript 客户端。我们让 Apollo 客户端做到：
- 增量可用，你可以在已有的 JavaScript 应用中，对于某一部分 UI 使用 GraphQL。
- 通用兼容，Apollo 可以接受各种不同构建运行的 GraphQL 服务器，以及任何 GraphQL schema。
- 方便监查和理解，你可以使用很好开发工具来确切地了解应用中发生的事情。
- 专为交互式应用程序而设计，因此用户操作后可以立刻看到 UI 改变。
- 社区驱动，所以你可以放心，这个项目会随着需求而不断发展。Apollo 最开始就是跟开发者用户一起开发的，所有项目都开源在 GitHub ，不会有什么你不知道的事情发生。
Apollo 客户端不仅仅是简单地向 GraphQL 服务器发起 query，它会分析你的查询及其结果，然后构建客户端缓存，对于后面的 query 和 mutation，缓存也实时更新。这意味着你的 UI 在客户端内部保持一致，并且用最少的查询次数来与服务器上的状态保持完全同步。
其他 GraphQL 客户端
如果你在考虑是否使用 react-apollo 或其他 GraphQL 客户端，那就要关注各个项目的出发点以及它们的比较。这里列举一些要点：
- Relay 是由 Facebook 为其移动应用程序构建的，主要考虑性能以及满足自家需求的 GraphQL 客户端。它专注如何让查询和组件可以更近更快（co-location）的获得结果，并且对于 GraphQL 的 schema 有一些严格规定，特别是在分页的情况下。 Apollo 有一些与 Relay 类似的功能，但它被设计成一个通用工具，可以适应任何 schema 和前端架构。Relay 的耦合会给某些特定架构带来一些好处，代价是失去了一些灵活性，这也促使 Appolo 社区更快地迭代测试一些实验特性。
- Lokka 是一个简单的 GraphQL JavaScript 客户端，具有基本的查询缓存。Appolo 则复杂一些，围绕着如何更新和重新拉取数据，提供了更贴心的缓存和其他高级功能。
其他资源
- GraphQL.org GraphQL 的介绍和指南，由 Apollo 团队部分编写和维护。
- 我们的网站 了解 Appolo 的开源和商业工具。
- Medium 专栏 提供关于 GraphQL 的文章，包括 Apollo 的功能公告，以及来自社区的文章。
- 我们的 Twitter 提供一些即时消息。