Lumicall is an open source project

This project is licensed to you under the terms of the GNU General Public License v3

What this means in practice is that if you extend this code in any way, you are obliged to share the source code with the community. You can't just make a derivative product and distribute it through Google Play in binary format only.

Browse the source code online

You can browse the source code using the Github - Lumicall repository

Getting the pre-requisites

Build tools

Getting the code

The code is hosted on Github.

mkdir -p ~/ws
git clone git://github.com/opentelecoms-org/lumicall.git ~/ws/lumicall
cd ~/ws/lumicall
git submodule init
git submodule update

Building the JNI code

There is some JNI code. It is NOT automatically built by Eclipse.

This code provides the SILK and G.729 and some other codecs.

You must have the Android Native Development Kit (NDK) installed. See the NDK online documentation for installation instructions

You only need to re-build the JNI code in these circumstances:

Eclipse clean/build functions will NOT detect when this code must be rebuilt - you must do this manually.

To build the JNI code, just execute the ndk-build command from the command line, for example:

$ cd ~/ws/lumicall
$ ${NDK_HOME}/ndk-build

All JNI modules should be built and copied to libs/armeabi-v7a. See jni/README.txt for more details about building for other architectures and debugging JNI.

Prepare the Android artifacts

This step is mandatory. Run the following command and various artifacts such as local.properties are created in the root of the build tree:

android update project --path . --target android-8

The properties file

The assets/ directory contains sample files, app.properties-*

Copy one of them to create a new file, app.properties and edit the values to match your site

A symlink to one of the existing files is also valid

Without this file, Eclipse will still build the application, but certain parts of the application will not work correctly when it is installed on a phone.

Building the code with Apache Ant

If you prefer running the build with ant, you can try it now

Just go to the root of the Lumicall repository you have cloned and run the command

$ ant

and after a brief wait, you should see

BUILD SUCCESSFUL
Total time: 34 seconds
$

Building the code with Eclipse

Build problems and tips

Getting help

If you are developing with Lumicall and want to participate in the community, please join the mailing list for developers.