Changelog: Twilio Conversations Android SDK

• Always access the latest documentation.

Support for previous versions of the Conversations SDKs

Twilio Conversations SDKs use Semantic Versioning. Twilio supports version N-1 for 12 months after the first GA release of version N. We recommend that you upgrade to the latest version as soon as possible to avoid any breaking changes.

Support for 1.x ceased on October 19, 2022.

Support for 2.x ceased on January 4, 2023.

Support for 3.x will cease on August 18, 2023.

Support for 4.x will cease on February 8, 2024.

Please upgrade to the latest version.

Changelog

Conversations 5.1.1 (May 15, 2023)

• aar
• SHA-256: 9f16e761aad94c1df57005e901425c5beb75750d229a3a1331940f2267400455
• Documentation

Changes

• Fixed a crash when both Sync SDK and Conversations SDK are in the same app.

Conversations 5.1.0 (March 13, 2023)

• aar
• SHA-256: 0bd6d47cb2984444d2ad9b7cd963c673fe3b31f01338878c7cfb65c2506610a7
• Documentation

Changes

• Added support for Content API

Conversations 5.0.0 (February 8, 2023)

• aar
• SHA-256: e806407d7c50be0744aff35e65f9a0012985e8ea624693df004fb3e991ef8431
• Documentation

Changes

• Bumped the kotlin version to v1.8.0

Breaking Changes

• Bumped Android minSdkVersion to 21

Conversations 4.0.2 (November 1, 2022)

• aar
• SHA-256: 655bab9a0c654d46a68cf4435814e2f5fb437454ccb788df4a716a6915d7f6f7
• Documentation

Changes

• Bump the ktor dependency to v2.1.2

Conversations 4.0.1 (September 29, 2022)

• aar
• SHA-256: 7b81154168fa8db48790344d446c26ceac2478f01094be325ce71386b0a83b90
• Documentation

Changes

• Fixed crash on device connectivity changes
• targetSdkVersion bumped to android-33

Conversations 4.0.0 (August 18, 2022)

• aar
• SHA-256: e9f2e50fe85dd56c7736d87b646f42a7d3ba03d7c5581d4e784102c44986d210
• Documentation

Changes

• Reduced the SDK footprint: AAR library has decreased in size by 6,86 %
• Significantly improved stability by refactoring transport layer to eliminate race conditions by design
• Added retrier logic for commands (like sendMessage, createConversation etc. which re-sends command in case when connection lost before reply for command arrived)

Breaking Changes

• For the UNAUTHORIZED error the ErrorInfo.code is now 5 (was 1)
• In edge cases error codes and messages changed to more informative. So if your app relies on any specific error codes and/or messages - these cases should be double checked after updating to this version.

Conversations 3.1.0 (March 2, 2022)

• aar
• SHA-256: 0ac6fe437bd93eb2678170552e73ec30f59382f226efdea63c9ef55703cf5b62
• Documentation

Changes

• Improved client synchronization time for users with many Conversations and Participants.

Conversations 3.0.1 (February 7, 2022)

• aar
• SHA-256: dbc578634a14867350e056f8d79eb079cf2caa537eb3bf2344c88fe329582ac7
• Documentation

Changes

• Added Kotlin extensions functions. For instance, it's now possible to send message in a way that is more idiomatic to Kotlin:

import com.twilio.conversations.extensions.sendMessage

val message = conversation.sendMessage {
    body = "Hello!"
}

Conversations 3.0.0 (January 4, 2022)

• aar
• SHA-256: f91addc480ba0e1040e187a6527b89cda90af3ce9a6e1772c94e6635f87a8351
• Documentation

Changes

• Added multiple media support. Messages can now contain both text and media. A message can have more than one Media. See ConversationLimits.

Breaking changes

• Message.Type and Message.hasMedia are removed. Use Message.getAttachedMedia().isEmpty() instead.
• Message.getMediaSid is removed. Use Media.getSid instead.
• Message.getFileName is removed. Use Media.getFileName instead.
• Message.getMediaType is removed. Use Media.getContentType instead.
• Message.getMediaSize is removed. Use Media.getSize instead.
• Message.getMediaContentTemporaryUrl is removed. Use Message.getTemporaryContentUrlsForAttachedMedia or Message.getTemporaryContentUrlsForMedia or Media.getTemporaryContentUrl instead.
• Message.Options and Conversation.sendMessage(options) are removed. Use Conversation.prepareMessage instead.
• Message.getMessageBody is renamed to Message.getBody.
• Message.updateMessageBody is renamed to Message.updateBody.

Conversations 2.0.0 (October 19, 2021)

• aar
• SHA-256: f746e085d3e95d45f98a4489a49080347cf0bf05850f0695243224b38b219d9d
• Documentation

Breaking changes

• Major under-the-hood improvement (the “Sessionless” protocol). This improvement is designed primarily for improved reliability. While this is not a breaking code change, it does carry a meaningful impact on timing:
  • SDK commands will return success or failure up to ~10% more quickly than before.
  • Real-time updates of data are now likely to arrive after the command completes. For example, Conversation.updateAttributes() will resolve successfully while Conversation#attributes still contains the old value. To see the new value, we recommend waiting for an #updated event.
• Some error messages have changed. For example, trying to leave a conversation you’re not part of will return error 50432, Participant not found instead of 50400, User not member of channel.
• Passing null to Conversation.sendMessage will result in the message body being an empty string.
• User.updateFriendlyName no longer accepts null as the value.
• Conversation.updateFriendlyName no longer accepts null as the value.

Conversations 1.6.0 (July 23, 2021)

• aar
• SHA-256: a0c5e8acd95ed33d33098f51181a1cf1ab0d7c9837c92333e79ffa4311347c66
• Documentation

Changes

• Added proxy support for uploading media.

Note

SDK fully supports proxy with authentication only on Android versions with API 22 and newer. This limitation affects only media messages. Proxy without authentication will work with older APIs as well as newer ones.

Conversations 1.5.0 (June 29, 2021)

• aar
• SHA-256: 6d5f16b67f815c5b33a2c97550c5888175b3dc7ad57b7864f0d4853ae5c8f6ba
• Documentation

Changes

• Fixed a crash when InputStream.read() throws an exception while uploading media. Now Conversation.sendMessage() returns an error in this case.
• Reduced the SDK footprint.

Conversations 1.4.1 (April 27, 2021)

• aar
• SHA-256: 25c2891017e4384a86869913069212946d5f4748a58c88879ec09acad79b7721
• Documentation

Changes

• Fixed a reconnection issue after restoring application from background.

Conversations 1.4.0 (April 21, 2021)

• aar
• SHA-256: b81452c6f19e09fc1062f721644a2274dd6e17d81837b24ba14d5a2155a4e5e1
• Documentation

Changes

• Fixed a bug when getters in NotificationPayload returned incorrect values.
• Introduced the methods getValue() and fromInt() for all public enums.

Conversations 1.3.1 (March 11, 2021)

• aar
• SHA-256: a1f7950265edb3fbc27febc14afd2bd7c07494aa9305c5e96854aa0498a355f4
• Documentation

Changes

• Fixed a bug when user update event with reason ReachabilityOnline is not received in some cases.

Note

Starting from this release, all artifacts are published on mavenCentral instead of jcenter. Additionally, the root build.gradle has to be updated by adding the mavenCentral() repository:

allprojects {
    repositories {
        mavenCentral()
    }
}

Conversations 1.2.0 (November 24, 2020)

• aar
• SHA-256: 0de52b367c1f3494ef6d2b6b6e2264e23452bb65f3672072acdaac9727ba9495
• Documentation

Changes

• Added support for connection via proxy. See ConversationsClient.Properties.Builder.setUseProxy().
• Fixed a bug when onConversationDeleted isn’t triggered when a participant is removed by the other user.
• Fixed a bug which could lead to an app getting stuck at client synchronization.

Conversations 1.1.0 (October 14, 2020)

• aar
• SHA-256: 3907e77c485463bc23eb6b23c3e7d5af59692438be61f81f9565fee7e9e51870
• Documentation

Changes

• Added detailed delivery receipts. See Message.getDetailedDeliveryReceiptList().

Conversations 1.0.1 (September 30, 2020)

• aar
• SHA-256: 85cb7ff0ce9b8390d39433acb393d5f91f1372f418e97002f5a1fb5760606aac
• Documentation

Changes

• Fixed a crash when invoking Message.getAggregatedDeliveryReceipt().

Conversations 1.0.0 (September 28, 2020)

• aar
• sha256 fc6d48a6c8f7d97be7984d2bd7d7ccbfa3950ce7d8e9defa08478da4b087e18e
• Documentation

Changes

• First public release of the new Conversations product.