apollographql/apollo-ios

Apollo iOSは、Swiftで書かれた強型キャッシュ型のGraphQLクライアントです。

GraphQLサーバーに対してクエリやミューテーションを実行し、結果をクエリ固有のSwift型として返します。つまり、JSONの解析や辞書のやり取り、クライアントに手動で正しい型に値をキャストさせる手間が不要です。また、モデル型はUIが使うGraphQL定義から生成されるため、自分で書く必要もありません。

生成される型はクエリごとに異なるため、クエリの一部として実際に指定したデータのみにアクセスできます。フィールドを指定しなければ、対応するプロパティにアクセスできません。つまり、Swiftのタイプチェッカーを使って、データアクセスのエラーがコンパイル時に必ず現れるか確認できるということです。Xcodeとの連携により、UIコードと対応するGraphQL定義を並べて操作でき、クエリドキュメントの検証やインラインのエラー表示も可能です。

Apollo iOS is a strongly-typed, caching GraphQL client, 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: 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.