/apollo-android

:robot:  A strongly-typed, caching GraphQL client for the JVM, Android, and Kotlin multiplatform.

Primary LanguageJavaMIT LicenseMIT

Apollo Android

GitHub license Slack Join the community CI Maven Central OSS Snapshots

Apollo Android 3 is available in alpha. It is still in active development, and we'd love for folks to test it out. See the v3 documentation and please report any issues!

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
  • Reactive bindings for: RxJava2, RxJava3, Coroutines, Reactor and Mutiny

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:

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

The latest version is Maven Central

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 Mutiny support
  implementation("com.apollographql.apollo:apollo-mutiny-support:x.y.z")
  // optional: for Reactor support
  implementation("com.apollographql.apollo:apollo-reactor-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.

Community integrations

Additional resources

Who is Apollo?

Apollo Graph, Inc. creates industry-leading tools for building applications with GraphQL:

  • Apollo Client – The most popular GraphQL client for the web. Apollo also builds and maintains Apollo iOS and Apollo Android.
  • Apollo Server – Build a production-ready JavaScript GraphQL server with a schema-first approach.
  • Apollo Studio – A turnkey portal for GraphQL developers, featuring a powerful GraphQL IDE (the Apollo Explorer), metrics reporting, schema search, and documentation.
  • Apollo Federation – Create and manage a single data graph composed of subgraphs that can be developed independently.

We are fully committed to advancing the frontier of graph development with open-source libraries, hosted software tooling, developer extensions, and community contributions.