Getting started with guava

Remarks#

This section provides an overview of what guava is, and why a developer might want to use it.

It should also mention any large subjects within guava, and link out to the related topics. Since the Documentation for guava is new, you may need to create initial versions of those related topics.

Versions#

Version	Release Date
r01%	2009-09-15
r02	2010-01-04
r03	2010-04-09
r04	2010-04-27
r05	2010-05-28
r06	2010-07-07
7.0	2010-09-22
8.0	2011-01-27
9.0	2011-04-07
10.0	2011-09-28
11.0	2011-12-18
12.0	2012-04-30
13.0	2012-08-03
14.0	2013-02-25
15.0	2013-09-06
16.0	2014-01-17
17.0	2014-04-22
18.0	2014-08-25
19.0	2015-12-09

% did not include Google Collections, which existed separately at that time

Note: Releases 1.0 through 11.0 require JDK 1.5 or newer. Releases 12.0 through 20.0 require JDK 1.6 or newer. Release 21.0 is expected to require JDK 1.8 or newer.

Setup

Dependency on Guava can be added in your Java project by using any build system.

Maven:

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>19.0</version>
</dependency>

Gradle:

dependencies {
  compile 'com.google.guava:guava:19.0'
}

Ivy

<dependency org="com.google.guava" name="guava" rev="19.0" />

Buildr

compile.with 'com.google.guava:guava:jar:19.0'

Manual Dependency

You can also just manually download JARs from Guava’s release page for the classes, sources and javadocs.

Note that JDK 1.6 or newer is required for Guava 12.0 through 20.0. See Version list for more info. Guava users who target Java 5 should use the Guava JDK5 backport. This includes users who target Android Froyo and earlier.