apollo-ios Logo

apollo-ios

Swift 开发的高性能 GraphQL 客户端库

ApolloGraphQLiOSSwift缓存Github开源项目

apollo-ios 是一个 Swift 编写的 GraphQL 客户端库,提供强类型查询结果和自动缓存功能。它支持执行 GraphQL 查询和变更,自动生成模型类型,并管理客户端数据一致性。该库简化了 iOS、macOS、tvOS 和 watchOS 平台的应用开发,支持 Swift Package Manager 和 CocoaPods 集成。

Apollo GraphQL

GitHub Action 状态 MIT 许可证 支持的平台: iOS, macOS, tvOS, watchOS

支持 Swift 5.7 兼容 Swift 包管理器 兼容 CocoaPods

☑️ Apollo 客户端用户调查
您最喜欢 Apollo iOS 的哪些方面?哪些方面需要改进?请通过参与一分钟调查告诉我们。您的回答将帮助我们了解 Apollo iOS 的使用情况,使我们能够更好地为您服务。

Apollo iOS 是一个强类型的、支持缓存的 GraphQL 客户端,使用 Swift 编写

它允许您对 GraphQL 服务器执行查询和变更操作,并以查询特定的 Swift 类型返回结果。这意味着您不必处理 JSON 解析,或传递字典并让客户端手动将值转换为正确的类型。您也不必自己编写模型类型,因为这些类型是从您的 UI 使用的 GraphQL 定义生成的。

由于生成的类型是查询特定的,您只能访问您实际在查询中指定的数据。如果您没有请求某个字段,您将无法访问相应的属性。实际上,这意味着您现在可以依靠 Swift 类型检查器来确保数据访问错误在编译时就能显示出来。通过我们的 Xcode 集成,您可以方便地并排处理 UI 代码和相应的 GraphQL 定义,它甚至会验证您的查询文档,并内联显示错误。

Apollo iOS 不仅仅是简单地在 GraphQL 服务器上运行您的查询:它规范化查询结果以构建您数据的客户端缓存,并在执行进一步的查询和变更时保持更新。这意味着您的 UI 始终保持内部一致性,并且可以用最少的查询次数与服务器上的状态保持完全同步。

这种具有值语义的模型、单向数据流和自动一致性管理的组合,导致了一个非常强大和优雅的编程模型,可以让您消除常见的粘合代码,并大大简化应用程序开发。

入门

如果您是 Apollo iOS 新手,我们推荐阅读我们的入门指南

还有全面的文档,包括API 参考

Carthage/XCFramework 支持

Apollo iOS 仓库不再包含 Xcode 项目,因此如果您使用 Carthage 或需要构建 XCFrameworks 以在开发环境中使用,您应该使用我们创建的 apollo-ios-xcframework 仓库。该仓库包含一个使用 Tuist 生成的 Xcode 项目,可用于此目的,并且标签与 Apollo iOS 的发布版本匹配。

发布和更新日志

所有发布版本都有详细记录,我们维护着一个更新日志,其中详细说明了库的所有变更。

路线图

路线图是一份高级文档,描述了该项目的下一个主要步骤或里程碑。我们始终欢迎来自社区的功能请求和贡献。

贡献

如果您想贡献,请参阅 Apollo 贡献者指南

维护者

Apollo 是谁?

Apollo 构建开源软件和图平台,以统一您的应用和服务中的 GraphQL。我们通过以下方式帮助您更快地发布:

  • Apollo Studio – 一个免费的、端到端的平台,用于管理您的 GraphQL 生命周期。在托管注册表中跟踪您的 GraphQL 模式,为图中的所有内容创建单一真实来源。Studio 提供了一个 IDE(Apollo Explorer),因此您可以探索数据、协作查询、观察使用情况并安全地进行模式更改。
  • Apollo Federation – 构建分布式图的行业标准开放架构。使用 Apollo 的网关将多个子图组合成一个统一的图,确定查询计划,并在您的服务之间路由请求。
  • Apollo Client – 最受欢迎的 Web GraphQL 客户端。Apollo 还构建和维护 Apollo iOSApollo Kotlin
  • Apollo Server – 一个生产就绪的 JavaScript GraphQL 服务器,可连接到任何微服务、API 或数据库。兼容所有流行的 JavaScript 框架,可部署在无服务器环境中。

学习如何使用 Apollo 构建

查看 Odyssey 学习平台,这是开始您的 GraphQL 之旅的理想场所,提供视频和交互式代码挑战。加入 Apollo 社区,与 GraphQL 社区互动并获得技术帮助。