Apollo iOS is a strongly-typed, caching GraphQL client for iOS, written in Swift.
It allows you to execute queries and mutations against a GraphQL server, and returns results as query-specific Swift types. This means you donβt have to deal with parsing JSON, or passing around dictionaries and making clients cast values to the right type manually. You also don't have to write model types yourself, because these are generated from the GraphQL definitions your UI uses.
As the generated types are query-specific, you're only able to access data you actually specify as part of a query. If you don't ask for a field, you won't be able to access the corresponding property. In effect, this means you can now rely on the Swift type checker to make sure errors in data access show up at compile time. With our Xcode integration, you can conveniently work with your UI code and corresponding GraphQL definitions side by side, and it will even validate your query documents, and show errors inline.
Apollo iOS does more than simply run your queries against a GraphQL server however. It normalizes query results to construct a client-side cache of your data, which is kept up to date as further queries and mutations are run. This means your UI is always internally consistent, and can be kept fully up-to-date with the state on the server with the minimum number of queries required.
This combination of models with value semantics, one way data flow, and automatic consistency management, leads to a very powerful and elegant programming model that allows you to eliminate common glue code and greatly simplifies app development.
Documentation can be found here.
The most recent version of Apollo iOS is currently in beta. Documentation will be updated over the next few days, but for now note that you'll have to install a prerelease version of apollo-codegen
to use it:
npm install -g apollo-codegen@next
Include the following in your Podfile
:
pod 'Apollo', '~> 0.6.0-beta'
The core Apollo
framework comes with an in-memory cache. You can include an experimental SQLite-based persistent cache by adding the following:
pod 'Apollo/SQLite', '~> 0.6.0-beta'
Include the following in your Cartfile
:
github "apollographql/apollo-ios" "0.6.0-beta.1"
Unfortunately Carthage doesn't support resolving prelease versions, so you'll have to update this for new betas.
Because Carthage doesn't allow specifying individual targets, this will build both the core Apollo
framework and the experimental SQLite-based persistent cache. If you don't need the SQLite support, only drag Apollo
into your project, avoiding ApolloSQLite
and SQLite.swift
.
This project is being developed using Xcode 8 and Swift 3.
If you open Apollo.xcodeproj
, you should be able to run the tests of the Apollo target.
Some of the tests run against a simple GraphQL server serving the Star Wars example schema (see installation instructions there).
If you'd like to contribute, please refer to the Apollo Contributor Guide.