Skip to content

Setting up development environment

Jump to bottom
Jürgen Hock edited this page Feb 2, 2014 · 6 revisions

Software dependencies to acquire

Fundamental development kits:

Optional command line tools:

An IDE of your choice:

Specific Linux dependencies:

  • GNU C Library 2.7 or greater
  • Some additional 32-bit libraries on 64-bit systems

Basic installation of development tools

Choose a root directory for development tools, e.g. ~/android. It is necessary to have write permissions in this directory!

Extract the Java and Android stuff in corresponding child directories like jdk, sdk and ndk.

Put IDE files into eclipse or idea child directory.

Create a shell environment profile, e.g. androidrc:

ANDROID_HOME=~/android
export JAVA_HOME=$ANDROID_HOME/jdk
export ANDROID_SDK_HOME=$ANDROID_HOME/sdk
export ANDROID_NDK_ROOT=$ANDROID_HOME/ndk
export PATH=$PATH:$JAVA_HOME/bin:$ANDROID_SDK_HOME/tools:$ANDROID_SDK_HOME/platform-tools:$ANDROID_NDK_ROOT

Simply call this profile every time before executing development tools.

Lauch the Android SDK manager android and install at least:

  • Android SDK tools
  • Android SDK Platform-tools
  • Android SDK Build-tools
  • Android 2.2 (API 8) / SDK Platform

Lauch the prefered IDE, install missing plugins like ADT, configure it for specific needs.

Source code preparation

Clone the GitHub repository, e.g. into ~/voicesmith:

git clone --recurse https://github.com/jurihock/voicesmith.git ~/voicesmith

In the future pull the latest changes as stated below:

cd ~/voicesmith

git pull && git submodule update --init --recursive

Make twice a simple configuration file, which contains the Android SDK path:

echo "sdk.dir=~/android/sdk" > ~/voicesmith/voicesmith/local.properties
echo "sdk.dir=~/android/sdk" > ~/voicesmith/greendroid/GreenDroid/local.properties

Finally change into working directory and make a test build:

cd ~/voicesmith/voicesmith
. ~/android/androidrc

make build
make release

If the build fails, install missing software dependencies.

IDE project preparation

In addition to the main source files, Voicesmith project contains a separate library for custom GUI controls:

~/voicesmith/greendroid/GreenDroid

Read corresponding IDE manual pages, how to handle Android library projects:

Specific IDE project settings are not provided with the source code, except of the Ant build settings.

You're be able to build and debug Voicesmith from the IDE on a hardware device. The device emulator doesn't work properly.

Furthermore you need to manually call make build again after changing the native code in the jni project directory.

Clone this wiki locally