This repository is deprecated
The new version of the Chat Demo Application is available in twilio-chat-demo-kotlin. It is an example of better app architecture and demonstrates best practices in implementing Twilio-based Chat.
Chat Demo Application Overview
This is Kotlin version of the Demo app
For the Java version you can look here.
Getting Started
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
Building
Add google-services.json
Generate google-services.json file and place it under chat-demo-android/
.
ACCESS_TOKEN_SERVICE_URL
Set the value of Set the value of ACCESS_TOKEN_SERVICE_URL
in gradle.properties
file to point to a valid Access-Token server.
Create that 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 this parameter to gradle during build without need to create a properties file, as follows:
./gradlew assembleDebug -PACCESS_TOKEN_SERVICE_URL=http://example.com/get-token/
Optionally setup Firebase Crashlytics
If you want to see crashes reported to crashlytics:
-
In order to see native crashes symbolicated upload symbols into the Firebase console:
./gradlew chat-demo-android:assembleBUILD_VARIANT
./gradlew chat-demo-android:uploadCrashlyticsSymbolFileBUILD_VARIANT
for example to upload symbols for debug
build type run:
./gradlew chat-demo-android:assembleDebug
./gradlew chat-demo-android:uploadCrashlyticsSymbolFileDebug
Read more about Android NDK crash reports.
- Login into
chat-demo-android
application and navigate toMenu -> Options -> Simulate crash
in order to check that crashes coming into Firebase console.
Build
Run ./gradlew assembleDebug
to fetch Twilio SDK files and build application.
Android Studio
You can import this project into Android Studio and then build as you would ordinarily. The token server setup is still important.
Debug
Build in debug configuration, this will enable verbose logging.
License
MIT