Skip to content

Commit fd5873e

Browse files
authored
Merge pull request #1264 from ably/release/2.2.0
Release 2.2.0
2 parents 070c8a0 + 8e8e6f4 commit fd5873e

3 files changed

Lines changed: 30 additions & 7 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,28 @@
11
# Change Log
22

3+
## [2.2.0](https://github.com/ably/ably-pubsub-java/tree/v2.2.0) (2026-11-13)
4+
5+
[Full Changelog](https://github.com/ably/ably-pubsub-java/compare/v2.1.0...v2.2.0)
6+
7+
You can now send push notifications to Android devices through FCM topics. FCM delivers one send to every device subscribed to a topic, so Ably doesn't make one FCM request per device. This suits broadcasts to large audiences, such as live match scores sent to every fan of a team.
8+
9+
### FCM topics
10+
11+
Push admins manage topics through `push.admin.fcmTopics`. Ably resolves devices to their FCM registration tokens and calls FCM with your app's service account, so your code never handles FCM credentials or tokens. [#1260](https://github.com/ably/ably-pubsub-java/pull/1260)
12+
13+
- `get(topic)` subscribes and unsubscribes a single device. It can also subscribe every device registered for a clientId or subscribed to a set of channels, and unsubscribe a clientId's devices.
14+
- `list(deviceId)` returns the topics a device is subscribed to.
15+
- `publish(target, payload)` sends an FCM message and returns its message ID. Create the target with `FcmTopicTarget.topic(...)` for one topic, or `FcmTopicTarget.condition(...)` for a condition combining up to five topics, such as `'team-a' in topics || 'team-b' in topics`. FCM delivers a condition message once to each matching device, even if it is subscribed to more than one of the topics.
16+
17+
On Android, `push.fcmTopics` lets an activated device subscribe itself to topics, unsubscribe and list its topics. These calls authenticate as the device, so they don't need the push-admin capability.
18+
19+
Each method has an `...Async` variant that takes a callback.
20+
21+
### Bug fixes
22+
23+
- A failure handling a successful HTTP response no longer retries the request on a fallback host. Before, an error such as an unexpected response body could send the request again, so a non-idempotent request such as a message edit could run more than once. [#1260](https://github.com/ably/ably-pubsub-java/pull/1260)
24+
- An unexpected exception while handling an HTTP response is now reported as an `AblyException`. Before, an async request's callback was never called. [#1260](https://github.com/ably/ably-pubsub-java/pull/1260)
25+
326
## [2.1.0](https://github.com/ably/ably-pubsub-java/tree/v2.1.0) (2026-11-11)
427

528
[Full Changelog](https://github.com/ably/ably-pubsub-java/compare/v2.0.0...v2.1.0)

‎README.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Use exactly one of `io.ably.pubsub:server` or `io.ably.pubsub:device` in an app.
3232

3333
```kotlin
3434
dependencies {
35-
implementation("io.ably.pubsub:server:2.1.0")
35+
implementation("io.ably.pubsub:server:2.2.0")
3636
}
3737
```
3838

@@ -42,7 +42,7 @@ On Android and on the JVM, Gradle picks the right variant of `io.ably.pubsub:dev
4242

4343
```kotlin
4444
dependencies {
45-
implementation("io.ably.pubsub:device:2.1.0")
45+
implementation("io.ably.pubsub:device:2.2.0")
4646
}
4747
```
4848

@@ -52,7 +52,7 @@ Maven can't pick the variant, so a JVM desktop app names `device-jvm` directly:
5252
<dependency>
5353
<groupId>io.ably.pubsub</groupId>
5454
<artifactId>device-jvm</artifactId>
55-
<version>2.1.0</version>
55+
<version>2.2.0</version>
5656
</dependency>
5757
```
5858

@@ -238,10 +238,10 @@ The packages use OkHttp for HTTP and WebSocket connections. To use the built-in
238238

239239
```kotlin
240240
dependencies {
241-
implementation("io.ably.pubsub:server:2.1.0") {
241+
implementation("io.ably.pubsub:server:2.2.0") {
242242
exclude(group = "io.ably.pubsub", module = "network-client-okhttp")
243243
}
244-
runtimeOnly("io.ably.pubsub:network-client-default:2.1.0")
244+
runtimeOnly("io.ably.pubsub:network-client-default:2.2.0")
245245
}
246246
```
247247

@@ -293,7 +293,7 @@ it on the classpath.
293293

294294
```kotlin
295295
dependencies {
296-
runtimeOnly("io.ably.pubsub:liveobjects:2.1.0")
296+
runtimeOnly("io.ably.pubsub:liveobjects:2.2.0")
297297
}
298298
```
299299

‎gradle.properties‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
GROUP=io.ably.pubsub
2-
VERSION_NAME=2.1.0
2+
VERSION_NAME=2.2.0
33
POM_INCEPTION_YEAR=2015
44
POM_URL=https://github.com/ably/ably-pubsub-java
55
POM_SCM_URL=https://github.com/ably/ably-pubsub-java/

0 commit comments

Comments
 (0)