1.2.16

Implemented enhancements:

• Added new Auth methods: 'requestToken', 'authorize','createTokenRequest' #460

Fixed bugs:

• authHeaders type conversion on Android Plugin is incorrect #444
• iOS _CastError exception #355

Closed issues:

• How to handle when user auth changes? [#459](https://github
  .com//issues/459)
• Expose href from ErrorInfo in bubbled exceptions #441
• java.util.HashMap cannot be cast to io.ably.lib.types.Param #439

Merged pull requests:

• Add numbers strategy for Gson to prevent changing int to double #462 (Afur)
• Expose error info in AblyException toString #447 (davyskiba)

1.2.15

Full Changelog

Fixed bugs:

• Update ably-android dependency to version 1.2.13 or later #430, fixed in: Update ably-android to 1.2.15 #435 (JakubJankowski)
• Android application got crash on notification receive in killed state using Ably notifications #429, fixed in: Main thread fix #431 (ikbalkaya) - reverting the change made under #291, released at version 1.2.9
• Building Example App on Android fails #418, fixed in: Fix missing App ID build error in example app #421 (ikurek)
• Fix for running didFinishLaunchingWithOptions #433 (Neelansh-ns)

Closed issues:

• Deprecated API usage warning for fallbackHostsUseDefault #416, fixed in: Added lint ignore on deprecated fields #423 (ikurek)

1.2.14

Full Changelog

Implemented enhancements:

• Add Flutter and/or Dart runtime version to Ably-Agent header, if possible #286
• Throw errors instead of returning null when serialization/ deserialization fails #149
• Custom Transport Parameters (Params) #108

Fixed bugs:

• Check requirements and update for Flutter 3.0.0 #394
• Upgrade ably-java dependency to version 1.2.12 #385
• Swift Compiler Error (Xcode): Definition conflicts with previous value #347
• Update errorReason on Realtime.connection #120
• Logging and error handling for ObjC stream listeners #399
• Fixed argument error in Swift implementation of Crypto.generateRandomKey #377
• Fixed iOS push module compilation issue on some versions of XCode #373
• Updated realtime connection to update errorReason #365

Closed issues:

• Check compatibility with XCode 13 #389
• Document public members of classes #380
• Ably iOS interferes with firebase_messaging #378
• Sort named constructor parameters alphabetically #351
• Use named arguments for options classes and make all fields private #61

1.2.13

Full Changelog

Implemented enhancements:

• Drop support for Android v1 embedding API #178
• Defaults: Generate environment fallbacks #47

Fixed bugs:

• Android only - Returning a TokenDetails with 'issued' and 'expires' values in epoch milliseconds throws java error #356
• Fix AblyException assigning 'Message' to 'Code' field #349
• Investigate and fix encryption in sample app #334
• Execution failed for task ':ably_flutter:compileDebugJavaWithJavac' while running integration test for android device #322
• Realtime types (e.g. RealtimeHistoryParams) extending Rest ones (e.g. RestHistoryParams) can cause problems (crashes) #241
• Fix LogHandler (use it) #238
• Broken dartdoc link generated from readme #110

Closed issues:

• Ably interferes with firebase_messaging #346
• Missing link to ApplicationState in documentation #335
• Write integration tests for realtime channel specs #332
• Consider Simplifying AblyMessage #329
• Upgrade firebase-messaging to version 23.0.0 #320
• Example App should be able to build and run without Firebase configured via google-services.json #318
• No need for GitHub workflows to explicitly run flutter pub get in the example folder #317
• Example App should be able to build and run without ABLY_API_KEY #316
• resultForDeactivate and resultForActivate are set to null in some situations in Android plugin #304
• Test device activation, subscription, receiving messages and deactivation #153
• Add docstring for "spec" folder #29

1.2.12

Full Changelog

Fixed bugs:

• Android: IllegalStateException in Crypto CBCCipher's decrypt method #314, fixed by updating to ably-android version 1.2.11 #319 (QuintinWillison)
• Android: 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)
• Deprecated Android embedding version #311, fixed in #312 (ikurek)

Merged pull requests:

• Readme enchancements for example app #309 (ikurek)

1.2.11

Full Changelog

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.

• Update to ably-cocoa v.1.2.10 #305 (QuintinWillison)

Fixed bugs:

• Customer reporting issue with NPE on Android push notifications #298

Merged pull requests:

• Checked for nullity of activation / deactivation results #303 (ikbalkaya)
• Correct the migration guide #301 (QuintinWillison)
• Add workaround for firebase messaging #289 (ikbalkaya)

1.2.10

Full Changelog

Bug Fix:

This bug affects customers using message content encryption alongside 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.

• Bug: Updating Realtime channel options doesn’t update the options of its REST counterpart #296, caused by ably/ably-cocoa#1265
• Fix: Update to ably-cocoa v.1.2.9 #299 (QuintinWillison), using ably/ably-cocoa#1266 (lawrence-forooghian)

1.2.9

Full Changelog

Bug Fixes:

• Push device registration does not clear/reset device details on iOS #287, fixed in #293 (QuintinWillison)
• Our PN broadcast receiver issue causes ANR on Android #290, fixed in #291 (ikbalkaya)

1.2.8

Bug Fix:
Push activation not completing on iOS when running in release configuration #276,
fixed in #277 (ben-xD)

1.2.7

Full Changelog

Implemented enhancements:

• Replace optional fields with default values #230
• Refactor example app to be more readable #212
• AuthCallback and InstanceStore Refactoring and documentation #250 (ben-xD)
• Serialize LogLevel using constants #244 (ben-xD)
• Replace deprecated method calls in tests #243 (ben-xD)
• Example app: Paginated results viewer widget #242 (ben-xD)
• Example app: Move out Realtime and Rest UI to separate widget and service #240 (ben-xD)
• Example app: Extract System Details sliver into new widget #239 (ben-xD)
• Hide API key secret inside API key UI #237 (ben-xD)
• Rename pushSetOnBackgroundMessage to pushBackgroundFlutterApplicationReadyOnAndroid #236 (ben-xD)
• Add default values to ClientOptions #233 (ben-xD)

Fixed bugs:

• Clear iOS platform instances synchronously #249 (ben-xD)

Closed issues:

• 1.2.6 java.lang.NullPointerException when stream fails to close #274
• 1.2.6 java.lang.NullPointerException when using token auth #272
• setMockMethodCallHandler is deprecated. Use tester.binding.defaultBinaryMessenger.setMockDecodedMessageHandler instead #173

Merged pull requests:

• Rename inconsistent methods to be more consistent #248 (ben-xD)
• Use Objective-C standard style for LogLevel enum #246 (ben-xD)
• Platform encapsulation #235 (ben-xD)