SubQuery开发者指南丨Hello World Explained

在 Hello World 快速入门指南中，我们运行了一些简单的命令，并很快就启动并运行了一个示例。 这使您可以确保具备所有先决条件，并且可以使用本地 Playground 进行简单查询以从 SubQuery 获取您的第一个数据。 让我们来仔细看看所有这些命令的含义。

01

subql init

我们运行的第一个命令是 ：subql init --starter subqlHelloWorld。

这个指令完成了繁重的工作，并为您创建了一大堆文件。 正如官方文档中所述，您将主要处理以下文件：

• project.yaml 中的清单

• schema.graphql 中的 GraphQL 架构

• src/mappings/ 目录中的映射函数

这些文件是我们所做一切的核心。 因此，我们将在另一篇文章中花更多时间来介绍这些文件。 不过现在，只需要知道这样的模式包含了用户可以从 SubQuery API 请求的数据的描述，project yaml 文件包含了“配置”类型参数，当然还有包含了含有 typescript 的 mappingHandlers — 其 typescript 有转换数据的功能。

02

yarn install

我们做的下一件事是 yarn install。 您也可以使用 npm install。

一段简短的历史。Node Package Manager 或 npm 最初于 2010 年发布，是 JavaScript 开发人员中非常流行的包管理器。 它是您在系统上安装 Node.js 时自动安装的默认包。Yarn 最初由 Facebook 于 2016 年发布，旨在解决使用 npm（当时）的一些性能和安全缺陷。

yarn 所做的是查看 package.json 文件并下载各种其他依赖项。package.json 文件看起来没有很多依赖项，但是当您运行该命令时，您会注意到添加了 18,983 个文件。 这是因为每个依赖项也将有自己的依赖项。

03

yarn codegen

然后我们运行 Yarn codegen 或 npm run-script codegen。 这样做是为了获取 GraphQL 架构（在 schema.graphql 中）并生成相关的 typescript 模型文件（因此输出文件将具有 .ts 扩展名）。 您应该永远不会更改任何这些生成的文件，只能更改源 schema.graphql 文件。

04

yarn build

然后执行 yarn build 或 npm run-script build。 这对于经验丰富的程序员来说应该很熟悉。 它创建一个分发文件夹，执行如准备部署的代码优化之类的事情。

05

docker-compose

最后一步是组合 docker 命令 docker-compose pull && docker-compose up （也可以单独运行）。pull 命令从 Docker Hub 获取所有需要的图像，up 命令启动容器。

当容器启动时，您会看到终端吐出大量文本，显示节点和 GraphQL 引擎的状态。 当你看到：

您就知道 SubQuery 节点已开始同步。

06

概括

现在您已经了解了幕后发生的事情，问题是接下来该做什么？ 如果您有信心，可以开始学习如何创建项目并详细了解三个关键文件。 清单文件、GraphQL 架构和映射文件。

或者您可以继续我们的教程部分，我们将学习如何在 SubQuery 的托管基础架构上运行这个 Hello World 示例，我们将学习如何修改 start 块，我们将运行随时可用的开源项目来更深入地了解如何运行 SubQuery 项目。

Website：https://www.subquery.network/

Telegram：https://t.me/subquerynetwork

Twitter：https://twitter.com/subquerynetwork

Medium：https://subquery.medium.com/

Github：https://github.com/subquery/subql

Matrix：https://matrix.to/#/#subquery:matrix.org

Linkedin：https://www.linkedin.com/company/subquery

往期精彩

扫码加入SubQuery官方微信社区