repository·main·Indexed 26 days ago
https://github.com/apollographql/apollo-iosA professional GraphQL client for Swift supporting iOS, macOS, watchOS, tvOS, and visionOS. Features include intelligent in-memory or SQLite caching, robust code generation for GraphQL models, and intuitive APIs. The 1.0 codegen introduces immutable response objects, GraphQLNullable for precise nullability handling, and support for multi-module projects via SPM and CocoaPods.
Apollo iOS is a strongly typed, Swift-first GraphQL client. The core library provides the essential components for GraphQL integration, including:
@semanticNonNull and @catch, following the work of the GraphQL Nullability Working Group.The new Apollo iOS Codegen is designed to address limitations in previous versions by focusing on the following key areas:
structs that store a single pointer to a data dictionary. This minimizes memory overhead and avoids the data duplication associated with mapping fields to stored properties.SQLiteNormalizedCache as a NormalizedCache implementation to persist Apollo cache data between application runs. It is the primary supported mechanism for SQLite-backed persistence in Apollo iOS.A major overhaul of the caching mechanisms is planned for the 3.0 release. Key initiatives include:
@stream directive is planned for a future release. This directive, alongside @defer, enables incremental delivery of data as part of the evolving GraphQL specification.The ApolloAPI library contains the internal models shared between the Apollo client and the models generated by ApolloCodegenLib.
Important Usage Note: For most use cases, you should not need to import ApolloAPI directly into your code. The models generated by the Apollo code generator already import ApolloAPI and expose the necessary functionality. You can typically use your generated models without importing the full Apollo client.
The Apollo iOS 1.0 code generation introduces several architectural changes designed to reduce generated code size and improve readability. Key improvements include:
SelectionSet, simplifying data consumption.??) with a dedicated GraphQLNullable enum to clearly distinguish between GraphQL null and Swift nil.__typename, making execution more efficient and code more compact.JSONObject (i.e., [String: AnyHashable]). This is intended for projects with custom data models or strict binary size constraints.GraphQLNullable enum. This allows you to explicitly distinguish between a field being absent from the response, being explicitly null, or containing a value.You can configure your generated response objects to provide data in a specific shape by explicitly copying a referenced fragment into a nested field on a TypeCase. This allows you to create composed types (e.g., a type that is both Pet and WarmBlooded) even if the selections are redundant in the GraphQL query. This ensures your generated models provide fields in the exact way you want to consume them in your application.
query {
allAnimals {
species
... on Pet {
...PetDetails
... on WarmBlooded {
...WarmBloodedDetails
}
}
...WarmBloodedDetails
}
}
fragment PetDetails on Pet {
humanName
favoriteToy
}
fragment WarmBloodedDetails on WarmBlooded {
bodyTemperature
}