Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Changelog: Twilio Chat Android SDK

Latest releases for the Programmable Chat Android SDK

We recommend using these links in your projects. As we patch bugs, these links will automatically be updated with the fixes.

Programmable Chat Android v4.0

Install the Android NDK

Our SDKs use native components that include symbol information to enable tools like Fabric's Crashlytics. In order to improve SDK troubleshooting, these symbols should be part of your build process, but they must be eventually stripped from your final .apk to reduce download size.

In order to produce maximally compact .apk packages, you must install the Android NDK on your build machine. Just by having it installed, symbol stripping will do its work and you'll have the tightest .apk file possible.

Upgrade to Programmable Chat Android SDK v2.0 or higher.

From June 1, 2019 forward, Android SDKs earlier than v2.0 will be deprecated and cease to connect to the Twilio backend. If you still use Chat's 0.x or 1.x iOS SDKs, please leverage our migration guides and update to a later version at your nearest convenience.

With the release of Chat Android 4.0.0 SDK the standalone AccessManager is no longer necessary; its functionality is now integrated into the Chat SDK. Your old implementations that use AccessManager will continue to operate normally, until you implement two new methods on ChatClientListener - onTokenAboutToExpire() and onTokenExpired(). After that you can safely remove AccessManager from your project.

In response to these new delegate methods calls you should query an updated token and set it on your ChatClient instance by using updateToken method.

Changelogs

Links are provided to specific patch versions here. We don't recommend using these links unless you have a specific need for a certain patch of a release.


Programmable Chat Android 4.0.4 (April 11, 2019)

Bug Fixes

  • Improved connection reliability under bad network conditions.
  • Fixed unexpected connectivity errors with code 1401: Unable to establish connection to Twilio Sync service.
  • Fixed behavior for UpdateAttributes in Message and User, now updating with null value calls listener's onError().
  • Improve documentation for Channel Members.

Programmable Chat Android 4.0.3 (February 19, 2019)

Bug Fixes

  • SDK size reduction - it gained over the course of the year, so we sent it to the gym. Native libraries are now repackaged and optimized for size.

Programmable Chat Android 4.0.2 (January 23, 2019)

Bug Fixes

  • Fixed crash on shutdown

Programmable Chat Android 4.0.1 (January 21, 2019)

Bug Fixes

  • Fixed crash on restoring after disconnected or backgrounded state
  • Fixed memory leaks in media upload

Programmable Chat Android 4.0.0 (December 10, 2018)

Breaking Changes

  • Removed previously deprecated Message.getTimeStampAsDate(). Use Message.getDateCreatedAsDate() instead.

Bug Fixes

  • Calling ChatClient.updateToken() may now indicate an error to the listener if the token validation failed.

Changes:

  • Introduced Push Notification Muting, with per-channel user notification preferences.

    • Added Channel.getNotificationLevel() and Channel.setNotificationLevel(NotificationLevel, StatusListener).
    • Added Channel.NotificationLevel enum with values .DEFAULT to receive notifications and .MUTED to suppress them. Upon leaving the channel, the mute setting for this User is reset to .DEFAULT.
    • Added Channel.UpdateReason.NOTIFICATION_LEVEL enum value when notification level changes.

    • NOTE: You need to grant editNotificationLevel permission to the user roles to be able to change this setting. See the Chat Permissions documentation.

  • Added new token lifecycle management delegate callbacks which reduce the need for AccessManager integration when only using one Twilio client SDK:

    • ChatClientListener.onTokenAboutToExpire() is called when a token has 3 minutes or less left until expiry and should be refreshed.
    • ChatClientListener.onTokenExpired() is called when a token is already expired and must be refreshed to reconnect to the service.
  • New logging level android.log.LogLevel.VERBOSE is now supported. Use this value to generate logs when reporting SDK issues to Twilio. As before, the default log setting is .SILENT, producing no SDK debug output at all.

  • Added Member.UpdateReason.ATTRIBUTES enum value. There's currently no way to query member attributes, it will be added in the following SDK version.

  • Added logging of android.os.Build.{BOARD,BRAND,DEVICE,DISPLAY,FINGERPRINT,HARDWARE,MANUFACTURER,MODEL,PRODUCT} on ChatClient startup - this data is logged into the local android log only and is helpful in diagnosing problems, please include it when submitting logs in bug reports!

  • Added @NonNull annotations to methods in Messages class.

  • Overhauled transport and communication layer, significantly improving network traffic overhead and client performance.

  • Provided numerous fixes for improving client stability, focusing on runtime and shutdown crashes.


Programmable Chat Android 3.1.1 (June 19, 2018)

Bug Fixes

Programmable Chat Android 3.1.0 (June 7, 2018)

Deprecations

  • Deprecated Message.getTimeStampAsDate(), use Message.getDateCreatedAsDate() instead.

Changes

  • Added Channels.getSubscribedChannelsSortedBy() to obtain a list of subscribed channels sorted based on a few available criteria: Channel.SortCriterion.LAST_MESSAGE, Channel.SortCriterion.FRIENDLY_NAME, Channel.SortCriterion.UNIQUE_NAME.
  • Added Channel.getLastMessageDate() and Channel.getLastMessageIndex() to obtain information about last message activity in the channel.
  • Added Channel.UpdateReason.LAST_MESSAGE for last channel message change, you can inspect the two above-mentioned properties of the Channel after receiving this update for new values.

Bug Fixes

  • Resolve crash on accessing last messages in the Channel after some patterns of message deletion.
  • Fix local reference table overflow when clearing more than 512 objects from cache.

Programmable Chat Android 3.0.1 (May 22, 2018)

Changes

  • Made disposed object checks non-fatal - they only log an ERROR level message now.

Bug Fixes

  • You must now request at least 1 message from the channel in Messages.getLastMessages() query. It used to be possible to query for 0 messages and receive no results, but not anymore.
  • GDPR-compliance by default - uses log level SILENT to not output anything from SDK by default. Switch to higher debug level using ChatClient.setLogLevel() to receive log messages.

Programmable Chat Android 3.0.0 (April 10, 2018)

This version is a major version bump due to semver. There are a number of incompatible API changes making this bump necessary.

Breaking Changes

These updates have changed the API in a backwards-incompatible manner.

  • ChannelListener.onTypingStarted/onTypingEnded methods now include a Channel in which this event has happened in the signature.
  • Chat messages that include media content previously returned a placeholder string "Media messages are not supported". This has caused some confusion, so these messages now return null body instead. Be careful to handle this case properly because it may cause NPEs in the your application if you don't.
  • Message.getTimeStamp has been renamed Message.getDateCreated for clarity. The returned value has not changed.
  • ChatClientListener.onNotification() method for receiving push notifications has been split into 4 separate methods:
    • onNewMessageNotification(String channelSid, String messageSid, long messageIndex)
    • onAddedToChannelNotification(String channelSid)
    • onInvitedToChannelNotification(String channelSid)
    • onRemovedFromChannelNotification(String channelSid) Now the parameters to these methods are more logical - for example there's no messageSid parameter when it is unused. The new messageIndex parameter provides an easier interface if you need to scroll to a message in the channel from push notification.
  • Behavior of Channel.join and Members.add/addByIdentity has changed - methods will fail if user is already a member of the channel.
  • Previously deprecated methods are now removed:
    • Messages.advanceLastConsumedMessageIndex(), use advanceLastConsumedMessageIndexWithResult() instead.
    • Messages.setLastConsumedMessageIndex(), use setLastConsumedMessageIndexWithResult() instead.
    • Messages.setAllMessagesConsumed(), use setAllMessagesConsumedWithResult() instead.
    • Messages.setNoMessagesConsumed(), use setNoMessagesConsumedWithResult() instead.

Changes

  • Media queueing support has been added for media messages, to better utilize upload bandwidth.
  • Online documentation format has changed to a more usable one (with search).

Bug Fixes

  • CallbackListener for ChatClient.create will be called on the originating thread. Previously it was called from library thread by mistake.
  • Android CA store certificates can be used for connections where possible. This means custom company certificates added on devices should now be honored by the SDK. To enable this feature use ChatClient.Properties.Builder's setDeferCertificateTrustToPlatform(boolean) with value true. By default Twilio-pinned certificate bundle will be used.
  • ChatClientListener.onChannelAdded() will be called regardless of if the channel's status is known yet or not, it was not called before if channel status was not yet determined.
  • Various internal bugfixes.

Programmable Chat Android 2.0.11 (May 24, 2018)

Bug Fixes

  • Fixed crash on shutdown due to local reference table overflow.
  • Made disposed object checks non-fatal - they only log an ERROR level message now.

Programmable Chat Android 2.0.10 (internal release, skipped)

Programmable Chat Android 2.0.9 (internal release, skipped)

Programmable Chat Android 2.0.8 (February 9, 2018)

Bug Fixes

  • Fixed possible crash on shutdown.

Programmable Chat Android 2.0.7 (February 5, 2018)

Changes

  • Updated internal certificate store for upcoming certificate authority changes.

Programmable Chat Android 2.0.6 (January 29, 2018)

Bug Fixes

  • Forward current connection state to the newly added listener. It's impossible to lose client connection state change between client creation and listener assignment now.
  • Implement better multithreading in channel listener callbacks. It's now more robust during concurrent modifications to the channel listeners list.

Programmable Chat Android 2.0.5 (January 10, 2018)

Bug Fixes

  • Optimized SDK speed.
  • Optimized SDK size.
  • Improved stability.

Programmable Chat Android 2.0.4 (December 19, 2017)

Bug Fixes

  • Added back the javadocs that went missing after 2.0.3-rc3

Programmable Chat Android 2.0.3 (December 14, 2017)

Bug Fixes

  • Fixed an issue where shutting down ChatClient on Android Oreo devices (8.0+) could crash.

Programmable Chat Android 2.0.2 (November 9, 2017)

Bug Fixes

  • Fixed an issue where a disposed ChatClient would attempt to reconnect to Twilio on application foregrounding.
  • BEHAVIORAL CHANGE: Bug-fix so joining an already joined channel or attempting to add an already joined member to a channel will now correctly return a failure result.
  • Fixed an issue where the ChatClient could sometimes crash during initialization.
  • Unconsumed messages count on joined channels should immediately reflect changes made by new consumption horizon update methods described below.
  • Improved documentation.

Changes

  • Added logging to reflect ChatClient detecting the application transitioning into the background or foreground.
  • Improvements to memory utilization.
  • Unimplemented Channel.setType() removed from the SDK.
  • Added updated consumption horizon methods which return an updated number of unconsumed messages in the listener callback:
    • setLastConsumedMessageIndexWithResult()
    • advanceLastConsumedMessageIndexWithResult()
    • setAllMessagesConsumedWithResult()
    • setNoMessagesConsumedWithResult()

Deprecations

  • Deprecated old consumption horizon update methods which did not take a completion listener. Please use the newly added methods which do accept a completion listener above.
    • setLastConsumedMessageIndex()
    • advanceLastConsumedMessageIndex()
    • setAllMessagesConsumed()
    • setNoMessagesConsumed()

Programmable Chat Android 2.0.1 (October 11, 2017)

Bug Fixes

  • SDK will no longer crash on client construction on devices prior to API 21.
  • Re-connection to the Chat service will occur faster when bringing the application to the foreground.
  • Both chat client creation and updateToken() once again give feedback if the provided token is expired or otherwise invalid.
  • Fixed an issue where the listener for joinChannel sometimes was not called.
  • Fixed an issue where properties of Message were sometimes not fully populated by the time sendMessage's listener was called.

Programmable Chat Android 2.0.0 (September 18, 2017)

New Features

Changes

  • BREAKING: Added UpdateReasons to onMessageUpdated and onMemberUpdated callbacks.
  • BREAKING: Removed the deprecated enum SynchronizationStrategy.
  • BREAKING: Use Message.Options to construct and sendMessage()
    • You now could fully initialise necessary message attributes before sending it out.
  • BREAKING: Members.add(), .addByIdentity(), .invite(), .inviteByIdentity(), .removeByIdentity() updated to new chat-lib API
  • Return empty JSON object instead of empty string if Message attributes are empty.

Bug Fixes

  • Fixed a crash on API 19 devices that prevented SDK use.

Legacy versions

Programmable Chat Android 1.0.14 (February 5, 2018)

Changes

  • Updated internal certificate store for upcoming certificate authority changes.

Programmable Chat Android 1.0.13 (January 10, 2018)

Bug Fixes

  • Optimized SDK speed.
  • Optimized SDK size.
  • Improved stability.

Programmable Chat Android 1.0.12 (December 19, 2017)

Bug Fixes

  • Fixed an issue where shutting down ChatClient on Android Oreo devices (8.0+) could crash.
  • Fixed an issue where already disposed ChatClient would attempt to reconnect on application foregrounding.
  • Fixed a potential issue where ChatClient could not release some resources on shutdown.
  • Add logging of application backgrounding and foregrounding events to improve debugging.

Programmable Chat Android 1.0.11 (October 11, 2017)

Bug Fixes

  • Fixed an infrequently occurring crash on chat client shutdown.
  • SDK will no longer crash on client construction on devices prior to API 21.
  • Re-connection to the Chat service will occur faster when bringing the application to the foreground.
  • Both chat client creation and updateToken() once again give feedback if the provided token is expired or otherwise invalid.
  • Fixed an issue where the listener for joinChannel sometimes was not called.
  • Fixed an issue where properties of Message were sometimes not fully populated by the time sendMessage's listener was called.

Programmable Chat Android 1.0.10 (August 22, 2017)

Changes

  • Performance enhancements for client startup and data retrieval.

Programmable Chat Android 1.0.9 (July 25, 2017)

Bug Fixes

  • channel.join() listener will be called after joined channel has been completely synchronized.

Programmable Chat Android 1.0.8 (July 5, 2017)

Bug Fixes

  • Fixed issues related to thread management, which in many cases should lead to significant performance gains
  • Fixed crashes on Client shutdown.

Programmable Chat Android 1.0.7 (June 29, 2017)

Bug Fixes

  • Fixed an issue whereby setAllMessagesConsumed() in an empty channel could cause the SDK client to crash.

Programmable Chat Android 1.0.6 (June 21, 2017)

Bug Fixes

  • Fixed an issue whereby GCM/FCM unregistration callbacks were not reliably being called.

Programmable Chat Android 1.0.5 (June 20, 2017)

Bug Fixes

  • Fixed additional issues with some commands not correctly completing - i.e. no success callback nor failure was received. This release fixes cases not addressed by the previous release.
  • Updated documentation to address inconsistencies.
  • Fixed a crash when passing null Properties to ChatClient.create(). An IllegalStateException will now be thrown instead.
  • Updated log messages to not mention non-existing Channel.synchronize() anymore.
  • Addressed status callback threading issues related to Member.getUserDescriptor()/.getAndSubscribeUser().
  • Ensure that Channel listener's synchronisation status callback immediately upon add in all cases.
  • Added creation of notification payload from FCM RemoteMessage contents.
  • Added a new helper method: Channel.SynchronizationStatus.isAtLeast().

Programmable Chat Android 1.0.4 (June 8, 2017)

Bug Fixes

  • Fixed a bug whereby some commands did not correctly complete - i.e. no success callback nor failure was received. This release fixes cases not addressed by the previous release.
  • Fixed a bug whereby SDK would crash in some circumstances while creating a Chat Client instance.

Programmable Chat Android 1.0.3 (June 2, 2017)

Bug Fixes

  • Fixed a bug whereby client initialization did not completed correctly - i.e. no success nor failure callback was received for client creation
  • Fixed a bug whereby some commands did not correctly complete - i.e. no success callback nor failure was received

Programmable Chat Android 1.0.1 (May 24, 2017)

Bug Fixes

  • Fixed a bug whereby after a call to client.shutdown() sometimes caused New Message push registrations to be lost for the endpoint.

Programmable Chat Android 1.0.0 (May 2, 2017)

Changes are grouped by class to ease migration.

ChatClient changes:

  • changed default log level from Log.DEBUG to Log.WARN
  • previously deprecated initialMessageCount setting has been removed
  • removed functions:
    • int getInitialMessageCount()
    • Builder ChatClient.Builder.setInitialMessageCount(int initialMessageCount)
  • UserInfo has been replaced with User/UserDescriptor and direct getting of UserInfo has been replaced with identity getters.
    • replaced UserInfo getMyUserInfo() with String getMyIdentity()
  • added new function to access user information Users getUsers()

ChatClientListener changes:

  • added new functions:
    • void onUserSubscribed(User user)
    • void onUserUnsubscribed(User user)
  • changed functions:
    • renamed onChannelAdd to onChannelAdded
    • renamed onChannelJoin to onChannelJoined
    • renamed onChannelInvite to onChannelInvited
    • renamed onChannelDelete to onChannelDeleted
    • renamed onToastNotification to onNotification
    • renamed onToastSubscribed to onNotificationSubscribed
    • renamed onToastFailed to onNotificationFailed
    • replaced void onChannelChange(Channel) with void onChannelUpdated(Channel, Channel.UpdateReason reason)
    • replaced void onUserInfoChange(UserInfo userInfo, UserInfo.UpdateReason reason) with void onUserUpdated(User user, User.UpdateReason reason)

Channel changes:

  • added new value for Channel.ChannelStatus enum:
    • UNKNOWN - channels returned in ChannelDescriptor do not have status information
  • added new Channel.UpdateReason enum to indicate reason for channel update, with values:
    • STATUS
    • LAST_CONSUMED_MESSAGE_INDEX
    • UNIQUE_NAME
    • FRIENDLY_NAME
    • ATTRIBUTES
  • removed function (you no longer need to explicitly synchronise channels):
    • void synchronize(CallbackListener<Channel>)

ChannelDescriptor changes:

  • added new functions:
    • long getUnconsumedMessagesCount()
    • Channel.ChannelStatus getStatus()

Channels changes:

  • renamed getPublicChannels to getPublicChannelsList
  • added new functions:
    • void getUserChannelsList(CallbackListener<Paginator<ChannelDescriptor>>)
    • List<Channel> getSubscribedChannels()
    • List<Member> getMembersByIdentity(String identity)

ChannelListener changes:

  • changed functions:
    • renamed onMessageAdd to onMessageAdded
    • renamed onMessageChange to onMessageUpdated
    • renamed onMessageDelete to onMessageDeleted
    • renamed onMemberJoin to onMemberJoined
    • renamed onMemberAdd to onMemberAdded
    • renamed onMemberChange to onMemberUpdated
    • renamed onMemberDelete to onMemberDeleted
    • renamed onSynchronizationChange to onSynchronizationChanged

ErrorInfo changes:

  • added new functions:
    • int getStatus()
    • String toString()
  • changed functions:
    • renamed getErrorCode to getCode
    • renamed getErrorText to getMessage

Member changes:

  • added new functions:
    • void getUserDescriptor(CallbackListener<UserDescriptor> listener)
    • void getAndSubscribeUser(CallbackListener<User> listener)
  • changed function:
    • replaced UserInfo getUserInfo() with String getIdentity()

Members changes:

  • added new functions:
    • Channel getChannel()
    • Member getMember(String identity)
    • void add(Member member, StatusListener listener)
    • void invite(Member member, StatusListener listener)
    • void removeByIdentity(String identity, StatusListener listener)
  • changed functions:
    • replaced void getMembers(CallbackListener<Paginator<Member>> listener) with List<Member> getMembersList()
    • renamed removeMember to remove

User changes:

  • renamed UserInfo to User class
  • added new functions:
    • void unsubscribe()
    • boolean isSubscribed()

UserDescriptor changes:

  • added new class UserDescriptor with functions:
    • String getFriendlyName()
    • JSONObject getAttributes()
    • String getIdentity()
    • boolean isOnline()
    • boolean isNotifiable()
    • subscribe(CallbackListener<User> listener)

Users changes:

  • added new class Users with functions:
    • void getChannelUserDescriptors(String channelSid, CallbackListener<Paginator<UserDescriptor>> listener)
    • void getUserDescriptor(String identity, CallbackListener<UserDescriptor> listener)
    • void getAndSubscribeUser(String identity, CallbackListener<User> listener)
    • List<User> getSubscribedUsers()
    • User getMyUser()

Bug fixes

  • Getting non-existing message by index now properly fails.

Programmable Chat Android 0.12.3 (May 19, 2017)

Bug Fixes

  • Fixed an issue whereby Push Credential registrations were firing onSuccess on each state change
  • Fixed a race condition whereby on channel creation, onChannelAdded and onChannelJoined events failed to fire correctly

Programmable Chat Android 0.12.2 (March 30, 2017)

Changes

  • Added FCM support via ChatClient.registerFCMToken(), ChatClient.unregisterFCMToken()
  • Return a proper error if the internal token and a manual token update causes a mismatch
  • Expose additional error codes to client. ErrorInfo.CANNOT_GET_MESSAGE_BY_INDEX and ErrorInfo.MISMATCHING_TOKEN_UPDATE

Bug Fixes

  • Fixed an issue where a certain character caused a crash \v
  • Added missing Message.getTimeStampAsDate()

Programmable Chat Android 0.12.1 (February 23, 2017)

Changes

  • The endpoint_id identifier specified in access tokens is now automatically generated and persisted in the local app storage. The following should be observed with this change:
    • endpoint_id is no longer a required identifier in your generated access tokens, you may omit it from this build forward
    • endpoint_id will be ignored if specified with your access token
  • Fully asynchronous client init
    • Client listener onError() will be called if any service error happens during client creation.
    • Client will not be created in this case.
  • Initial message count is completely ignored by init code, 0 is always used - messages are loaded when a channel is loaded.
  • Security enhancements

Bug Fixes

  • Added missing Channel.getCreatedBy() and ChannelDescriptor.getCreatedBy() to return creator's identity
  • Fixed a bug whereby a constant CPU load was generated by the SDK client when initialized.

Programmable Chat Android 0.11.2 (December 1, 2016)

Changes

  • Added a call to the onClientSynchronization callback in the registered listener upon ChatClient.setListener(), passing the current client synchronization state

Programmable Chat Android 0.11.1 (November 22, 2016)

Bug Fixes

  • Fixed an issue where the getPublicChannels() caused a crash

Programmable Chat Android 0.11.0 (November 21, 2016)

BREAKING

  • Rename IP Messaging to Programmable Chat
  • IPMessagingClient is renamed to ChatClient
  • com.twilio.ipmessaging is renamed to com.twilio.chat
  • AccessManager is removed from SDK

ADDED

  • Channel.removeAllListeners() removes all added listeners.
  • Channel.getMessagesCount()
  • Channel.getUnconsumedMessagesCount()
  • Channel.getMembersCount()
  • Channels.getPublicChannels() returns ChannelDescriptors, and this list is not updated in realtime.
  • onUserInfoUpdated added UpdateReason.

CHANGED

  • BREAKING Do not return IPMessagingClient before it was fully initialised. IPMessagingClient.create() no longer returns a value, you can obtain reference to created IPMessagingClient only in listener's onSuccess() callback.

  • BREAKING Channel.setListener() replaced with addListener() to support assigning multiple listeners

  • BREAKING Channel.removeListener() now accepts listener ptr to remove only that one
  • BREAKING Replace custom CreateChannelListener in Channels.createChannel() with generic CallbackListener<Channel>. Listener's onCreated(Channel) is therefore renamed onSuccess(Channel).

  • BREAKING IPMessagingClient.handleNotification() now accepts NotificationPayload instead of Map<String,String>

  • BREAKING Messages.getMessageByIndex() has been changed to asynchronous interface.

  • BREAKING Members.getMembers() has been changed to asynchronous interface.

  • BREAKING Channel invite logic changes.

  • BREAKING Constants interface is removed, StatusListener and CallbackListener<T> are standalone classes now.

DELETED

  • BREAKING Removed built-in AccessManager, IPMessagingClient.create() now accepts only String token. IPMessagingClient.updateToken() is provided to update it.
  • Use com.twilio:accessmanager-android:0.1.0 from jcenter
  • Removed twilio-common from dependencies.

  • BREAKING Remove previously obsoleted ChannelListener.onAttributesChange()

  • BREAKING Remove previously deprecated Channels.createChannel() with attributes map.

  • BREAKING Remove previously deprecated TwilioIPMessagingSDK

  • BREAKING Remove previously deprecated InitListener

  • BREAKING Remove previously deprecated Messages.getMessages()

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.