A glossy Matrix collaboration client for Android
  • Java 92.1%
  • JavaScript 4.1%
  • Kotlin 2.9%
  • HTML 0.7%
  • Shell 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Benoit Marty 6c26308eb4 Version ++
2018-06-01 14:27:28 +02:00
docs Docs: Notifications: Update after the new "Keep detailed notifications" setting 2018-03-13 17:58:33 +01:00
gradle/wrapper Upgrade gradle form 3.3 to 4.7 2018-04-27 11:12:58 +02:00
projectFilesBackup/.idea Merge remote-tracking branch 'origin/fix_direct_chat_issues_#706' into develop 2016-11-28 08:21:27 +01:00
tools Add a debug tool to dump the SharedPreferences 2018-05-30 14:59:17 +02:00
vector Update matrix-sdk.aar lib (v0.9.5) 2018-06-01 12:22:44 +02:00
.gitignore remove history 2015-06-02 09:07:40 +02:00
.travis.yml Disable email notification 2018-05-16 14:56:35 +02:00
AUTHORS.rst Update AUTHORS 2018-03-14 11:24:30 +01:00
build.gradle Version ++ 2018-06-01 14:27:28 +02:00
build_fdroid_apk.sh Update to the latest jitsi libs 2018-01-16 16:35:11 +01:00
build_jitsi_libs.sh Update to the latest jitsi libs 2018-01-16 16:35:11 +01:00
build_matrix_sdk_lib.sh Update to the latest jitsi libs 2018-01-16 16:35:11 +01:00
build_olm_lib.sh Update to the latest jitsi libs 2018-01-16 16:35:11 +01:00
build_riot_apks.sh Improve build script (also double build on Jenkins has been removed. Jenkins only call this script) 2018-05-30 14:59:17 +02:00
CHANGES.rst Version ++ 2018-06-01 14:27:28 +02:00
compile_with_sdk_lib.sh Add scripts to switch SDK between lib/project. 2018-05-15 17:16:13 +02:00
compile_with_sdk_project.sh Add scripts to switch SDK between lib/project. 2018-05-15 17:16:13 +02:00
CONTRIBUTING.rst remove the execution permission on the RST files 2017-03-13 09:27:14 +01:00
google-services.json migrate_gcm_to_fcm 2017-04-18 10:23:41 +02:00
gradle.properties Upgrade gradle form 3.3 to 4.7 2018-04-27 11:12:58 +02:00
gradlew remove history 2015-06-02 09:07:40 +02:00
gradlew.bat remove history 2015-06-02 09:07:40 +02:00
LICENSE remove history 2015-06-02 09:07:40 +02:00
README.md Fix installation referrer documentation (use '%26' to escape '&') and add a Unitary Test 2018-05-24 14:03:23 +02:00
set_debug_env.sh Add scripts to switch SDK between lib/project. 2018-05-15 17:16:13 +02:00
settings.gradle Restore normal configuration 2018-05-29 15:09:00 +02:00
test_referrer.sh Fix installation referrer documentation (use '%26' to escape '&') and add a Unitary Test 2018-05-24 14:03:23 +02:00
trigger_release.sh use a tmp folder to clone the matrix-android-skd git repo 2017-12-22 16:24:49 +01:00

Riot

Riot is an Android Matrix client.

Get it on Google Play

Get it on F-Droid

Build instructions

This client is a standard android studio project.

If you want to compile it in command line with gradle, go to the project directory:

Debug mode:

./gradlew assembleDebug

Release mode:

./gradlew assembleRelease

And it should build the project (you need to have the right android SDKs)

Recompile the provided aar files until we have gradle

generate olm-sdk.aar

sh build_olm_lib.sh

generate matrix-sdk.aar

sh build_matrix_sdk_lib.sh

generate the other aar files

sh build_jitsi_libs.sh

compile the matrix SDK with the Riot-android project

sh set_debug_env.sh

Make your own flavour

Let says your application is named MyRiot : You have to create your own flavour.

Modify riot-android/vector/build.gradle

In "productFlavors" section, duplicate "app" group if you plan to use GCM/FCM or "appfdroid" if don't.

for example, with GCM, it would give

    appmyriot {
        applicationId "im.myriot"
        // use the version name
        versionCode rootProject.ext.versionCodeProp
        versionName rootProject.ext.versionNameProp
        resValue "string", "allow_gcm_use", "true"
        resValue "string", "allow_ga_use", "true"
        resValue "string", "short_flavor_description", "G"
        resValue "string", "flavor_description", "GooglePlay"
    }
  • if you use GCM, duplicate appCompile at the end of this file and replace appCompile by appmyriotCompile.
  • if you don't, update the "if (!getGradle().getStartParameter().getTaskRequests().toString().contains("fdroid"))" to include your flavor.

Create your flavour directory

  • Copy riot-android/vector/src/app or appfroid if you use GCM or you don’t.
  • Rename it to appmyriot.
  • If you use GCM, you will need to generate your own google-services.json.

Customise your flavour

  • Open riot-android/vector/src/appmyriot/AndroidManifest.xml
  • Comment the provider section.
  • Change the application name to myRiot with "android:label="myRiot""
  • Any other field can be customised by adding the resources in this directory classpath.
  • Open Android studio, select your flavour.
  • Build and run the app : you made your first Riot app.

You will need to manage your own provider because "im.vector" is already used (look at VectorContentProvider to manage it).

Customise your application settings with a custom google play link

It is possible to set some default values to Riot with some extra parameters to the google play link.

  • Use the https://developers.google.com/analytics/devguides/collection/android/v4/campaigns URL generator (at the bottom)
  • Set "Campaign Content" with the extra parameters (e.g. is=http://my__is.org%26hs=http://my_hs.org). Please notice the usage of %26 to escape the &
  • Supported extra parameters:
    • is : identity server URL
    • hs : home server URL
  • Generate the customised link
  • The application may have to be installed from the Play Store website (and not from the Play Store application) for this feature to work properly.

FAQ

  1. What is the minimum android version supported?

    the mininum SDK is 16 (android 4.1)

  2. Where the apk is generated?

    Riot/build/outputs/apk