Skip to content
Connects college students to the Christian club near them, and assists leaders in organizing events.
Kotlin Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.github
app
config/quality
core
draw
emoji
gradle/wrapper
player
suggestions
util
.gitignore
CODE_OF_CONDUCT.md
CODING_STYLE.md
HISTORY.md
LICENSE
PLANNING.md
README.md
SECURITY.md
build.gradle
debug.keystore
dependencies.gradle
gradle.properties
gradlew
gradlew.bat
my-release-key.keystore
settings.gradle

README.md

Rocket.Chat logo

Rocket.Chat Android native application

CircleCI Codacy Badge

Get it from the stores

Description

This repository contains all the code related to the Android native application of Rocket.Chat. To send new pull-requests, always use the branch develop as base and open an issue with the description of what you want/need to accomplish, if the issue wasn't created yet.

How to build

  • Make sure that you have the latest Gradle and the Android plugin versions installed. Go to File > Project Structure > Project and make sure that you have the latest versions installed. Refer this to see the compatible versions.
  • Kotlin is already configured in the project. To check, go to Tools > Kotlin > Configure Kotlin in project. A message saying kotlin is already configured in the project pops up. You can update kotlin to the latest version by going to Tools > Kotlin > Configure Kotlin updates and download the latest version of kotlin.

SDK Instructions

  • This version requires the Kotlin SDK for Rocket.Chat. Clone the Kotlin SDK in by running git clone https://github.com/RocketChat/Rocket.Chat.Kotlin.SDK.git.
  • First, a build is required for the SDK, so that required jar files are generated. Make sure that the Android repository and the Kotlin SDK have the same immediate parent directory. Change the current directory to Rocket.Chat.Android/app and run the build-sdk.sh which will result in creating of the required jar file core*.jar and common*.jar in Rocket.Chat.Android/app/libs, by the following steps in your terminal window:
cd Rocket.Chat.Android/app
./build-sdk.sh

Note: You need to have Java 8 as default Java for the system (project won't build when using a Java 9+ version).

How to run

Command Line

  • Connect your physical device to your pc via USB or start an emulator. Run adb devices in terminal. You should see your device in the list of devices.
  • In order to build the debug apk, run ./gradlew assembleDebug. This would generate a debug apk which can be found under Rocket.Chat.Android/app/build/outputs/apk/debug folder with the name app-debug.apk.
  • In order to build and install the apk directly to the connected device, run ./gradlew installDebug.

Android Studio

  • After importing the project in Android Studio, go to Run > Run app and then select your device, or create a new virtual device by following the wizard.

Bug report & Feature request

Are you having a technical issue trying to compile the app, or setting up Push Notifications? Please use our Community Support channel for that: https://forums.rocket.chat/c/community-support. The issues are only supposed to be used for bugs, improvements, and features in the native Android application.

Coding Style

Please follow the official Kotlin coding conventions when contributing.

You can’t perform that action at this time.