Introduction
A strongly-typed, caching GraphQL client for the JVM, Android and Kotlin multiplatform
Apollo Android
Apollo Android is a GraphQL client that generates Java and Kotlin models from GraphQL queries. These models give you a type-safe API to work with GraphQL servers. Apollo helps you keep your GraphQL query statements together, organized, and easy to access.
This library is designed primarily with Android in mind, but you can use it in any Java/Kotlin app.
Features
- Java and Kotlin code generation
- Queries, Mutations and Subscriptions
- Reflection-free parsing of responses
- HTTP cache
- Normalized cache
- File uploads
- Custom scalar types
- Support for RxJava2, RxJava3, and Coroutines
Getting started
If you are new to GraphQL, check out the tutorial that will guide you through building an Android app using Apollo, Kotlin and coroutines.
If you'd like to add Apollo Android to an existing project:
- Get started with Kotlin shows how to add Apollo Android to a Kotlin project.
- Get started with Java shows how to add Apollo Android to a Java project.
- Get started with Multiplatform (Experimental) shows how to add Apollo Android to a Multiplatform project. This is still under heavy development and APIs may change without warning.
Advanced topics
Check the project website for in depth documentation about caching, plugin configuration, android, file upload, coroutines, rxjava2, rxjava3, persisted queries, no runtime, migrations and much more...
IntelliJ Plugin
The JS Graphql IntelliJ Plugin provides auto-completion, error highlighting, and go-to-definition functionality for your .graphql
files. You can create a .graphqlconfig
file to use GraphQL scratch files to work with your schema outside product code (such as to write temporary queries to test resolvers).
Releases
Check the changelog for the release history.
Releases are hosted on Jcenter and Maven Central. The plugin is additionally hosted on the Gradle Plugin Portal
plugins {
id("com.apollographql.apollo").version("x.y.z")
}
repositories {
mavenCentral()
}
dependencies {
implementation("com.apollographql.apollo:apollo-runtime:x.y.z")
// optional: if you want to use the normalized cache
implementation("com.apollographql.apollo:apollo-normalized-cache-sqlite:x.y.z")
// optional: for coroutines support
implementation("com.apollographql.apollo:apollo-coroutines-support:x.y.z")
// optional: for RxJava3 support
implementation("com.apollographql.apollo:apollo-rx3-support:x.y.z")
// optional: Most of apollo-android does not depend on Android in practice and runs on any JVM or on Kotlin native. apollo-android-support contains a few Android-only helper classes. For an example to send logs to logcat or run callbacks on the main thread.
implementation("com.apollographql.apollo:apollo-android-support:x.y.z")
// optional: if you just want the generated models and parsers and write your own HTTP code/cache code, you can remove apollo-runtime
// and use apollo-api instead
implementation("com.apollographql.apollo:apollo-api:x.y.z")
}
Snapshots
Latest development changes are available in Sonatype's snapshots repository:
repositories {
maven {
url = uri("https://oss.sonatype.org/content/repositories/snapshots/")
}
}
Requirements
Apollo Android runs on the following platforms:
- Android API level 15+
- JDK 8+
- iOS 13+
Contributing
If you'd like to contribute, please see Contributing.md.
Additional resources
- A journey to Kotlin multiplatform: how the project was moved to Kotlin multiplatform, talk given at Kotliners in June 2020.
- #125, Fragmented Podcast: Why's and How's about Apollo Android and the entire journey.
- GraphQL.org for an introduction and reference to GraphQL itself.
- apollographql.com to learn about Apollo open-source and commercial tools.
- The Apollo blog for long-form articles about GraphQL, feature announcements for Apollo, and guest articles from the community.
- The Apollo Twitter account for in-the-moment news.