Email-based instant messaging for Android.
Branch: master
Clone or download
r10s unify quantity strings; always include %d in 'one' because translator…
…s will need to use %d for languages where 'one' does not only mean 1 - and if %d is missing in the source strings, tool may not offer it
Latest commit 76daa92 Feb 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github changed the wording of the issue template to improve the perception o… Jan 28, 2019
.tx update translations Dec 13, 2018
assets remove unused apn database and tools Nov 30, 2018
docs comment Feb 13, 2019
gradle/wrapper Initial commit 🌱 Aug 14, 2018
jni Update messenger-backend submodule. Feb 21, 2019
libs Initial commit 🌱 Aug 14, 2018
res unify quantity strings; always include %d in 'one' because translator… Feb 23, 2019
src closes #685 by strictly defining points in time Feb 22, 2019
store another go, another refined motto and some text changes ;) Feb 14, 2019
tools change deltachat-android-ii to deltachat-android; fix some lineend Jan 21, 2019
.gitattributes Initial commit 🌱 Aug 14, 2018
.gitignore comment Feb 12, 2019
.gitmodules 4 - Add core and initial bindings Aug 16, 2018
AndroidManifest.xml application-id in delta-chat-auth-scheme is optional Feb 20, 2019
CHANGELOG.md add most recent translations to changelog Feb 12, 2019
Dockerfile Initial commit 🌱 Aug 14, 2018
LICENSE Initial commit 🌱 Aug 14, 2018
README.md Updated README.md Feb 21, 2019
build.gradle remove dead references in gradle Feb 18, 2019
gradlew Initial commit 🌱 Aug 14, 2018
gradlew.bat Initial commit 🌱 Aug 14, 2018
proguard-appcompat-v7.pro Initial commit 🌱 Aug 14, 2018
proguard-automation.pro Initial commit 🌱 Aug 14, 2018
proguard-glide.pro Initial commit 🌱 Aug 14, 2018
proguard-jackson.pro Initial commit 🌱 Aug 14, 2018
proguard-retrofit.pro Initial commit 🌱 Aug 14, 2018
proguard-retrolambda.pro Initial commit 🌱 Aug 14, 2018
proguard-rounded-image-view.pro Initial commit 🌱 Aug 14, 2018
proguard-shortcutbadger.pro Initial commit 🌱 Aug 14, 2018
proguard.cfg Allow for customized Background image #50 Oct 12, 2018
standards.md add OAuth2 to standards.md Feb 20, 2019

README.md

Delta Chat Android Client

This is the android client for Delta Chat. It is available on F-Droid and the Google Play Store. The APK can also be downloaded from github (for experienced users only).

For the core library and other common information, please refer to the Delta Chat Core Library.

Screenshot Chat List Screenshot Chat View

Build

When checking out deltachat-android, make sure also to check out the subproject deltachat-core:

  • When using Git, you can do this initially by $ git clone --recursive https://github.com/deltachat/deltachat-android or later by git submodule update --init --recursive. If you do this in your home directory, this results in the folder ~/deltachat-android which is just fine.

  • Alternatively, you can download the deltachat-android zip-file; in this case, also download the deltachat-core zip-file and place its contents to jni/messenger-backend

Then, call ndk-build in the root directory to build the C-part; this also builds deltachat-core. Afterwards run the project in Android Studio. The project requires API 25.

With chance, that's it :) - if not, read on how to setup a proper development environment.

Install Development Environment

  1. Some libs required by Android Studio may be missing on 64 bit Linux machines [Source], so for Ubuntu execute
    $ sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 lib32z1 libbz2-1.0:i386
    and for Fedora execute
    $ sudo yum install zlib.i686 ncurses-libs.i686 bzip2-libs.i686

  2. Download Android Studio from https://developer.android.com (android-studio-ide-...-linux.zip) and unpack the archive which contains a single folder called android-studio; move this folder eg. to ~/android-studio

  3. To launch Android Studio for the first time, open a terminal, navigate to ~/android-studio/bin, execute ./studio.sh and use all standard values from the wizard.

  4. Android Studio now ask you if you want to download an existing project; choose ~/deltachat-android as created in the "Build" chapter (Android Studio starts to build the project, however, there are some steps missing before this will succeed).

  5. As Delta Chat uses API 25 for some reasons, click on the corresponding error message and install "Nougat 7.1.1 (API 25)" and the "Build-Tools" (you should also find the option at "Tools / Android / SDK Manager / SDK Platforms"). Now the build should succeed - but the app still misses the native part.

  6. Download Android NDK Revision 14b from NDK Archives (Newer releases shall not be used currently, they are not compatible, see issues #197, #220, #248) and unzip the archive which contains a single folder called android-ndk-r...; move this folder eg. to ~/android-ndk-r...

  7. Export the folder path to your environment as ANDROID_NDK and add it to PATH. You can archive this eg. by adding the following lines to .bashrc
    export ANDROID_NDK=/home/bpetersen/android-ndk-r...
    export PATH=$PATH:$ANDROID_NDK

The last two steps may be omitted by using the new Android Studio NDK options, however, thus far, we have not found the time to do so.

Credits

The user interface classes are based on the Signal messenger.

License

Licensed under the GPLv3, see LICENSE file for details.

Copyright © 2017-2019 Delta Chat contributors