This code is using Twilio Chat, which we intend to sunset on July 25, 2022. The new great product to be used instead is Twilio Conversations. The Conversations Demo Application is available in twilio-conversations-demo-kotlin. It is an example of good app architecture and demonstrates best practices in implementing Twilio-based Conversations.
This repository remains available in case you want to improve your existing Chat Application. For new applications it is highly recommended to start with twilio-conversations-demo-kotlin.
This demo app SDK version:
Latest available SDK version: 
Welcome to the Chat Demo application. This application demonstrates a basic chat client with the ability to create and join channels, invite other members into the channels and exchange messages.
What you'll minimally need to get started:
- A clone of this repository
- A way to create a Chat Service Instance and generate client tokens
- Google Play Services library : Follow the instructions here
Generate google-services.json file and place it under app/.
Set the value of ACCESS_TOKEN_SERVICE_URL in gradle.properties file to point to a valid Access-Token server.
So your Access-Token server should provide valid token for valid credentials by URL:
$ACCESS_TOKEN_SERVICE_URL?identity=<USER_PROVIDED_USERNAME>&password=<USER_PROVIDED_PASSWORD>
and return HTTP 401 if case of invalid credentials.
Create the gradle.properties file if it doesn't exist with the following contents:
ACCESS_TOKEN_SERVICE_URL=http://example.com/get-token/
NOTE: no need for quotes around the URL, they will be added automatically.
You can also pass these parameters to gradle during build without need to create a properties file, as follows:
./gradlew app:assembleDebug -PACCESS_TOKEN_SERVICE_URL=http://example.com/get-token/
If you want to see crashes reported to crashlytics:
-
In order to see native crashes symbolicated upload symbols into the Firebase console:
./gradlew app:assembleBUILD_VARIANT
./gradlew app:uploadCrashlyticsSymbolFileBUILD_VARIANT
for example to upload symbols for debug build type run:
./gradlew app:assembleDebug
./gradlew app:uploadCrashlyticsSymbolFileDebug
Read more about Android NDK crash reports.
- Login into application and navigate to
Menu -> Simulate crash inin order to check that crashes coming into Firebase console.
Run ./gradlew app:assembleDebug to fetch Twilio SDK files and build application.
You can import this project into Android Studio and then build as you would ordinarily. The token server setup is still important.
Build in debug configuration, this will enable verbose logging.
MIT