Releases: google/guava
33.4.0
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.4.0-jre</version>
<!-- or, for Android: -->
<version>33.4.0-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Exposed additional Java 8 APIs to Android users. (6082782, 9b0109c, 6ace8bc, b650b9f, c6c2680, 984f713, f9f3fff, cdc2254)
base
: DeprecatedCharsets
constants in favor ofStandardCharsets
. We will not remove the constants, but we recommend usingStandardCharsets
for consistency. (45e6be2)base
: AddedToStringHelper.omitEmptyValues()
. (f5ec2ab)collect
: Added an optimizedcopyOf
method toTreeRangeMap
. (a46565d)collect.testing
: Fixed@Require
annotations so that features implied by absent features are not also required to be absent. (81be061)io
: ChangedByteSink
andCharSink
to no longer callflush()
in some cases beforeclose()
. This is a no-op for well-behaved streams, which internally flush their data as part of closing. However, we have discovered some stream implementations that have overriddenclose()
to do nothing, including not to flush some buffered data. If this change causes problems, the simplest fix is usually to change theclose()
override to at least callflush()
. (6ace8bc)net
: AddedHttpHeaders.ALT_SVC
andMediaType.CBOR
. (503ba42, 7c0bf08)
33.3.1
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.3.1-jre</version>
<!-- or, for Android: -->
<version>33.3.1-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Added
j2objc-annotations
to the Gradle runtime classpath to stop producing an Android Gradle Plugin error. (a3b5188)
33.3.0
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.3.0-jre</version>
<!-- or, for Android: -->
<version>33.3.0-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
base
: Removed@Beta
from theDuration
overload ofSuppliers.memoizeWithExpiration
. (76fca99)cache
: AddedCacheBuilder
Duration
overloads toguava-android
. (a5f9bca)collect
: Removed@Beta
from theguava-android
Collector
APIs. (c86c09d)collect
: AddedImmutableMultimap.builderWithExpectedKeys
andImmutableMultimap.Builder.expectedValuesPerKey
. (c3d5b17)graph
: ImprovedGraphs.hasCycle
to avoid causingStackOverflowError
for long paths. (63734b9)net
: Addedtext/markdown
toMediaType
. (2466a09)net
: DeprecatedHttpHeaders
constant forSec-Ch-UA-Form-Factor
in favor ofSec-Ch-UA-Form-Factors
to follow the latest spec. (b310b7e)testing
: Changed some test libraries to throwAssertionError
(instead of the more specificAssertionFailedError
) in some cases. (fdfbed1)
33.2.1
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.2.1-jre</version>
<!-- or, for Android: -->
<version>33.2.1-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
net
: ChangedInetAddress
-String
conversion methods to preserve the IPv6 scope ID if present. The scope ID can be necessary for IPv6-capable devices with multiple network interfaces. However, preserving it can also lead to problems for callers that rely on the returned values not to include the scope ID:- Callers might compensate for the old behavior of the methods by appending the scope ID to a returned string themselves. If so, you can update your code to stop doing so at the same time as you upgrade Guava. Of, if your code might run against multiple versions of Guava, you can check whether Guava has included a scope ID before you add one yourself.
- Callers might pass the returned string to another system that does not understand scope IDs. If so, you can strip the scope ID off, whether by truncating the string form at a
%
character (leaving behind any trailing]
character in the case offorUriString
) or by replacing the returnedInetAddress
with a new instance constructed by callingInetAddress.getByAddress(addr)
. java.net.InetAddress
validates any provided scope ID against the interfaces available on the machine. As a result, methods inInetAddresses
may now fail if the scope ID fails validation.- Notable cases in which this may happen include:
- if the code runs in an Android app without networking permission
- if code passes
InetAddress
instances or strings across devices
- If this is not the behavior that you want, then you can strip off the scope ID from the input string before passing it to Guava, as discussed above. (3f61870)
- Notable cases in which this may happen include:
33.2.0
Android users: Please test recent Guava versions
If you know of Guava Android users who have not yet upgraded to at least release 33.0.0, please encourage them to upgrade, preferably to today's release, 33.2.0. These releases have begun adding Java 8+ APIs to guava-android
. While we don't anticipate problems, we do anticipate that any unexpected problems could force a disruptive rollback. To minimize any disruption, we'd like to catch any such problems early.
Please let us know of any problems you encounter.
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.2.0-jre</version>
<!-- or, for Android: -->
<version>33.2.0-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Dropped testing for Android versions before Lollipop (API Level 21). Guava may stop working under older versions in the future, or it may have done so already.
- Fixed a GWT compilation breakage under Gradle. (858caf4)
collect
: Made ourCollector
APIs (e.g.,ImmutableList.toImmutableList()
) available inguava-android
. More Java 8 APIs will follow in future releases. (96fca0b)- As always, streams are available to Android code only when that code enables library desugaring or targets a new enough API Level (24 (Nougat) for many stream APIs). (But note that we test only with library desugaring, so we don't currently know if API Level 24 is high enough to use our
Collector
APIs unless you have also enabled library desugaring.) Guava users who avoid theCollector
APIs do not need to meet this requirement.
- As always, streams are available to Android code only when that code enables library desugaring or targets a new enough API Level (24 (Nougat) for many stream APIs). (But note that we test only with library desugaring, so we don't currently know if API Level 24 is high enough to use our
collect
: Fixed a potentialNullPointerException
inImmutableMap.Builder
on a rare code path. (70a9811)net
: AddedHttpHeaders
constantsAd-Auction-Allowed
,Permissions-Policy-Report-Only
, andSec-GPC
. (7dc01ed, 41d0d9a, 38c8017)
33.1.0
Request for Android users
If you know of Guava Android users who have not yet upgraded to at least the previous release 33.0.0, please encourage them to do so. Starting with that version, we are experimenting with including Java 8+ APIs in guava-android
. Before we commit to adding such APIs, we want as much testing as we can get: If we later expose a set of Java 8+ APIs and then discover that they break users, we won't want to remove them, as the removal would break users, too.
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.1.0-jre</version>
<!-- or, for Android: -->
<version>33.1.0-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Updated our Error Prone dependency to 2.26.1, which includes a JPMS-ready jar of annotations. If you use the Error Prone annotations in a modular build of your own code, you may need to add a
requires
line for them. (d48c6df, c6e91c4) base
: Added aDuration
overload forSuppliers.memoizeWithExpiration
. (76e46ec)base
: Deprecated the remaining two overloads ofThrowables.propagateIfPossible
. They won't be deleted, but we recommend migrating off them. (cf86414)cache
: Fixed a bug that could cause false "recursive load" reports during refresh. (0e1aebf)graph
: Changed the return types oftransitiveClosure()
andreachableNodes()
toImmutable*
types.reachableNodes()
already returned an immutable object (even though that was not reflected in the declared return type);transitiveClosure()
used to return a mutable object. The old signatures remain available, so this change does not break binary compatibility. (09e655f)graph
: Changed the behavior of views returned by graph accessor methods that take a graph element as input: They now throwIllegalStateException
when that element is removed from the graph. (8dca776)hash
: OptimizedChecksum
-based hash functions for Java 9+. (afb35a5)testing
: ExposedFakeTicker
Duration
methods to Android users. (f346bbb)util.concurrent
: Deprecated the constructors ofUncheckedExecutionException
andExecutionError
that don't accept a cause. We won't remove these constructors, but we recommend migrating off them, as users of those classes often assume that instances will contain a cause. (1bb3c43)util.concurrent
: Improved the correctness of racy accesses for J2ObjC users. (d3232b7)
33.0.0
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.0.0-jre</version>
<!-- or, for Android: -->
<version>33.0.0-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- This version of
guava-android
contains some package-private methods whose signature includes the Java 8Collector
API. This is a test to identify any problems before we expose those methods publicly to users. Please report any problems that you encounter. (73dbf7e) - Changed various classes to catch
Exception
instead ofRuntimeException
even when onlyRuntimeException
is theoretically possible. This can help code that throws undeclared exceptions, as some bytecode rewriters (e.g., Robolectric) and languages (e.g., Kotlin) do. (c294c23, 747924e, b2baf48) - Added an
Automatic-Module-Name
tofailureaccess
, Guava's one strong runtime dependency. (280b5d2) reflect
: Inguava-android
only, removedInvokable.getAnnotatedReturnType()
andParameter.getAnnotatedType()
. These methods never worked in an Android VM, and to reflect that, they were born@Deprecated
,@Beta
, and@DoNotCall
. They're now preventing us from rolling out some new Android compatibility testing. This is the only binary-incompatible change in this release, and it should have no effect in practice. Still, we bump the major version number to follow Semantic Versioning. (045cd84)util.concurrent
: Changed our implementations to avoid eagerly initializing loggers during class loading. This can help performance, especially under Android. (4fe1df5)
32.1.3
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>32.1.3-jre</version>
<!-- or, for Android: -->
<version>32.1.3-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Changed Gradle Metadata to include dependency versions directly. This may address "Could not find
some-dependency
" errors that some users have reported (which might be a result of users' excludingguava-parent
). (c6d35cf) collect
: ChangedMultisets.unmodifiableMultiset(set).removeIf(predicate)
to throw an exception always, even if nothing matchespredicate
. (61dbccf)graph
: Fixed the behavior ofGraph
/ValueGraph
views for a node when that node is removed from the graph. (9507996)io
: FixedFiles.createTempDir
andFileBackedOutputStream
under Windows services, a rare use case. (The fix actually covers only Java 9+ because Java 8 would require an additional approach. Let us know if you need support under Java 8.) (f87f68c)net
: MadeMediaType.parse
allow and skip over whitespace around the/
and=
separator tokens in addition to the;
separator, for which it was already being allowed. (2786f83)util.concurrent
: TweakedFutures.getChecked
constructor-selection behavior: The method continues to prefer to call constructors with aString
parameter, but now it breaks ties based on whether the constructor has aThrowable
parameter. Beyond that, the choice of constructor remains undefined. (For this and other reasons, we discourage the use ofgetChecked
.) (59cfb22)
32.1.2
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>32.1.2-jre</version>
<!-- or, for Android: -->
<version>32.1.2-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Removed the section of our Gradle metadata that caused Gradle to report conflicts with
listenablefuture
. (9ed0fa6) - Changed our Maven project to avoid affecting which version of Mockito our Gradle users see. (71a16d5)
collect
: Under J2CL, exposedImmutableList
andImmutableSet
methodscopyOf
andof
for JavaScript usage. (b41968f)net
: OptimizedInternetDomainName
construction. (3a1d18f, eaa62eb)
32.1.1
Maven
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>32.1.1-jre</version>
<!-- or, for Android: -->
<version>32.1.1-android</version>
</dependency>
Jar files
Guava requires one runtime dependency, which you can download here:
Javadoc
JDiff
Changelog
- Fixed our broken Gradle metadata from 32.1.0. Sorry again for the trouble. If you use Gradle, please still read the release notes from that version: You may still see errors from the new checking that the metadata enables, and the release notes discuss how to fix those errors.