2. 添加GraphQL模式
本教程使用的是你作为Apollo全栈教程的一部分所构建的GraphQL服务器的一个修改版本GraphQL服务器的一部分。Apollo全栈教程。您可以访问该服务器的Apollo Studio沙盒探索器来探索其模式,无需登录:
您会知道这个沙盒实例指向我们的服务器,因为其URLhttps://apollo-fullstack-tutorial.herokuapp.com
位于页面左上角旁边的框中。如果沙盒正常连接,您将看到一个绿色的小点:
该模式定义了您的服务器可以执行哪些 GraphQL 操作。在左上角,点击模式图标以获取对您模式的概览:
在 参考 选项卡中,您现在可以查看作为该API消费者可以获得的所有内容的列表,以及所有对象上可用的 字段。
下载您服务器的模式
Apollo Kotlin 需要一个模式来从您的查询生成类型安全的模型和代码。有多种方式可以获取模式。例如,您可以去 SDL 选项卡并使用 Apollo Studio Sandbox 下载原始的 SDL 模式。
在本教程中,我们将使用由我们的插件自动创建的 downloadApolloSchema
Gradle 任务。由于 GraphQL 支持 内省,这将与任何启用 内省 的 GraphQL 终端一起工作。
从项目的根目录运行以下命令
./gradlew :app:downloadApolloSchema --endpoint='https://apollo-fullstack-tutorial.herokuapp.com/graphql' --schema=app/src/main/graphql/schema.graphqls
请注意,分配给 --schema
的路径是相对于项目根目录的。
这将从您的终端下载一个 schema.graphqls
文件到 app/src/main/graphql/schema.graphqls
。
您应该仍然有来自 上一步 的黄色横幅,A project sync may be necessary for the IDE to work properly.
。现在是时候点击 现在同步。
如果一切顺利,Apollo Kotlin 现在已添加到您的项目中。接下来,编写第一个查询 使用此模式。