NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #2059 most downloaded on pub.dev
A wrapper around Ably's Cocoa and Java client library SDKs, providing iOS and Android support.
Last release 6 months ago
09 Apr 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 45 of 45 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
49 releases · first in 2021
One column per quarter.
Fix exceptions when FlutterEngine is suspended during event emission #595
Updated ably-java dependency to 1.6.0
ably-java dependency to 1.6.0Updated ably-cocoa dependency to 1.2.53
ably-cocoa dependency to 1.2.53Fixed the issue when the device locale has its own digits symbols #581
Added stable 64-bit ID generation for streams and improve platform reset handling #573
Added ability to opt out of iOS push notifications #560
Fixed NullPointerException #568
Fixed Flutter 3.29 compatibility issues
Full Changelog Fixed bugs: Error on Android Build #551
Not compiling on fresh new Android project #550
Fixed bugs:
Nothing published for this version
Updated ably-cocoa dependency to 1.2.33
ably-cocoa dependency to 1.2.33Fixed bugs:
title field in the push notification should be nullable #532Updated ably-android dependency to 1.2.40
Message extras deserialization not working \#523
This release improves support for Android 19
This release improves support for Android 19
ably-android dependency to 1.2.38This release includes a new privacy manifest as required under new Apple guidelines.
This release includes a new privacy manifest as required under new Apple guidelines.
ably-cocoa dependency to 1.2.30This release contains Ably Push Notification improvements
This release contains Ably Push Notification improvements
ably-cocoa dependency to 1.2.29ably-android dependency to 1.2.36Updated ably-cocoa dependency to 1.2.27
ably-cocoa dependency to 1.2.27When the app comes back to the foreground from the background \#504
ably-cocoa dependency is bumped to 1.2.24
ably-cocoa dependency is bumped to 1.2.24setOnBackgroundMessage not getting along with async/await \#496
ably-android dependency is bumped to 1.2.33
ably-android dependency is bumped to 1.2.33ably-cocoa dependency is bumped to 1.2.23
ably-cocoa dependency is bumped to 1.2.23Closed issues:
loading LocalDevice hit Unhandled Exception \#491
prevent app crash during method channel call \#489
Closed issues:
\[Android\] Encrypted channels periodically throws java.util.ConcurrentModificationException \#483
Closed issues:
Ably causes runner to crash in XCode 15 \#480
Closed issues:
This release includes important bug fixes that affect the SDKs reconnection behaviour when the connection between client and server goes quiet. Previously the SDK would incorrectly wait up to 120 seconds since last activity - this is now reduced to ~25 seconds.
A significant number of peripheral fixes are also included to improve stability and reliability.
There are no API breaking changes, however a few behavioural changes arise from the fixes:
authCallback is now bounded by realtimeRequestTimeout (default 10s) - previously unbounded. A callback that took longer and still succeeded will now fail the auth attempt. authUrl was already bounded, by the separate httpRequestTimeout, and is unaffected by this change.
realtimeRequestTimeout is now a public ClientOptions property, it was previously internal.
HeartbeatMonitorDelay rejects values below 1ms - previously accepted, but led to unintentional side-effects.
Connection.Key and Id read as null during a CLOSED/FAILED state-change callback (cleared before the event is emitted), and are now retained through SUSPENDED. connectionId no longer changes after a long disconnection, since the client always attempts a resume now. Use ChannelStateChange.Resumed to detect a fresh connection.
Connection.CreateRecoveryKey() returns a key while SUSPENDED, where it previously returned empty.
Some minor ErrorInfo messages and codes have changed.
Andy, Technical Lead, Ably Chat
Fix java/android custom fallbacks \#470
Realtime connection with authUrl causes crash on iOS \#465
Added new Auth methods: 'requestToken', 'authorize','createTokenRequest' \#460
Implemented enhancements:
Fixed bugs:
Closed issues:
href from ErrorInfo in bubbled exceptions #441Merged pull requests:
Deprecated API usage warning for fallbackHostsUseDefault \#416, fixed in: Added lint ignore on deprecated fields \#423 (ikurek)
Fixed bugs:
ably-android dependency to version 1.2.13 or later #430, fixed in: Update ably-android to 1.2.15 #435 (JakubJankowski)1.2.9Closed issues:
Add Flutter and/or Dart runtime version to Ably-Agent header, if possible \#286
Implemented enhancements:
Fixed bugs:
ably-java dependency to version 1.2.12 #385errorReason #365Closed issues:
Drop support for Android v1 embedding API \#178
Implemented enhancements:
Fixed bugs:
RealtimeHistoryParams) extending Rest ones (e.g. RestHistoryParams) can cause problems (crashes) #241Closed issues:
ApplicationState in documentation #335firebase-messaging to version 23.0.0 #320google-services.json #318flutter pub get in the example folder #317ABLY_API_KEY #316Deprecated Android embedding version \#311, fixed in \#312 (ikurek)
Fixed bugs:
IllegalStateException in Crypto CBCCipher's decrypt method #314, fixed by updating to ably-android version 1.2.11 #319 (QuintinWillison)java.lang.ArrayIndexOutOfBoundsException thrown by AblyInstanceStore's setPaginatedResult method #308, fixed in #321 (QuintinWillison)ChannelStateChange property resumed should not be nullable #297, fixed in #313 (ikurek)Merged pull requests:
We made a change, released in version 1.2.9, which we suspect has been causing issues for some customers. This release reverts that change.
Reverted Bug Fix:
We made a change, released in version 1.2.9, which we suspect has been causing issues for some customers. This release reverts that change.
ably-cocoa v.1.2.10 #305 (QuintinWillison)Fixed bugs:
Merged pull requests:
This bug affects customers using message content encryption alongisde channel history for a single Ably client instance. It only affects the iOS runti
Bug Fix:
This bug affects customers using
message content encryption
alongisde
channel history
for a single Ably client instance.
It only affects the iOS runtime (not an issue on Android).
History REST requests, on iOS only, were incorrectly returning encrypted payloads,
despite encryption having been enabled via the Realtime channel setOptions API.
ably-cocoa v.1.2.9 #299 (QuintinWillison), using ably/ably-cocoa#1266 (lawrence-forooghian)Push device registration does not clear/reset device details on iOS \#287, fixed in \#293 (QuintinWillison)
Bug Fixes:
Bug Fix: Push activation not completing on iOS when running in release configuration \#276, fixed in \#277 (ben-xD)
Replace deprecated method calls in tests \#243 (ben-xD)
Implemented enhancements:
pushSetOnBackgroundMessage to pushBackgroundFlutterApplicationReadyOnAndroid #236 (ben-xD)Fixed bugs:
Closed issues:
setMockMethodCallHandler is deprecated. Use tester.binding.defaultBinaryMessenger.setMockDecodedMessageHandler instead #173Merged pull requests:
Make the symmetric encryption UI more usable \#229 (ben-xD)
Implemented enhancements:
notification in RemoteMessage #224 (ben-xD)setOptions to complete the Future (previously did not call result.success) and remove side effects in example app #222 (ben-xD)Fixed bugs:
FlutterError through MethodChannel. It is not supported and crashes the app. #214Merged pull requests:
Enhancement/push UI improvement for debugging \#218 (ben-xD)
Upgrade ably cocoa \#209 (ben-xD)
Implemented enhancements:
Fixed bugs:
Merged pull requests:
This release lowers the minimum version of Flutter required to use Ably Flutter to 2.2.3.
This release lowers the minimum version of Flutter required to use Ably Flutter to 2.2.3.
Merged pull requests:
This release adds support for push notifications, including device activation with Ably (including device registration with APNs / FCM), subscribing d
This release adds support for push notifications, including device activation with Ably (including device registration with APNs / FCM), subscribing devices for push notifications and handling the push notifications in your Flutter application, without writing iOS or Android code. Check out the push notifications documentation for more information. We also fixed some bugs that were either reported in Github issues or found internally.
Implemented enhancements:
Fixed bugs:
java.lang.Exception: Invalid authCallback response #156java.lang.Exception: Invalid authCallback response on Flutter Android #121Closed issues:
package:pedantic with package:flutter_lints #168No authentication information provided #167The plugin ably_flutter could not be built URGENT #129Merged pull requests:
invalid authCallback response when using token authentication #164 (ben-xD)CONTRIBUTING.md #163 (ben-xD)This is a preview release of v1.2.2, which adds support for push notifications, including device activation with Ably (including device registration w
This is a preview release of v1.2.2, which adds support for push notifications, including device activation with Ably (including device registration with APNs / FCM) and subscribing devices for push notifications. Check out the dedicated documentation (PushNotifications.md) and the example app (push_notification_service.dart) for more information.
Implemented enhancements:
Merged pull requests:
Investigate libraries that can help leverage our push implementation \#142
Implemented enhancements:
Closed issues:
Merged pull requests:
Add support message extras and its extensions \[TM2i\] \#123 (tiholic), fixing \#11
Presence subscription example \#53
With this release we are conforming our version numbering to match that used in our other client libraries. This reflects the fact that this plugin is
With this release we are conforming our version numbering to match that used in our other client libraries. This reflects the fact that this plugin is heading towards compliance with version 1.2 of our Features Specification, also aligning with the underlying implementations of ably-cocoa and ably-java.
Fixed bugs:
Closed issues:
Merged pull requests:
Your coding agent can read these notes before it upgrades. Set up the MCP server →