README.md

NFD on Android
==============

[![Build Status](https://travis-ci.org/named-data-mobile/NFD-android.svg?branch=master)](https://travis-ci.org/named-data-mobile/NFD-android)

## Prerequisites

To compile code, the following is necessary

- Recent version of [Android SDK](http://developer.android.com/sdk/index.html), android-23 SDK
  and 23.0.2 build tools (for build), android-19 SDK (for compatibility), and several other SDK
  components
- [CrystalX Android NDK](https://www.crystax.net/en/download) version 10.3.1
- Prebuilt version of OpenSSL library

Example script for Ubuntu 14.04 to get all dependencies, download SDK and NDK:

    CRYSTAX_NDK_VERSION=10.3.1
    SDK_VERSION=24.4.1

    BUILD_TOOLS_VERSION=23.0.2
    COMPILE_SDK_VERSION=23

    sudo apt-get install -y build-essential git openjdk-7-jdk unzip
    sudo apt-get install -y lib32stdc++6 lib32z1 lib32z1-dev

    wget https://www.crystax.net/download/crystax-ndk-$CRYSTAX_NDK_VERSION-linux-x86_64.tar.xz
    tar xf crystax-ndk-$CRYSTAX_NDK_VERSION-linux-x86_64.tar.xz
    rm crystax-ndk-$CRYSTAX_NDK_VERSION-linux-x86_64.tar.xz

    wget http://dl.google.com/android/android-sdk_r$SDK_VERSION-linux.tgz
    tar zxf android-sdk_r$SDK_VERSION-linux.tgz
    rm android-sdk_r$SDK_VERSION-linux.tgz

    export ANDROID_HOME=`pwd`/android-sdk-linux
    export PATH=${PATH}:${ANDROID_HOME}/tools:${ANDROID_HOME}/platform-tools

    echo "y" | android update sdk --filter platform-tools,build-tools-$BUILD_TOOLS_VERSION,android-$COMPILE_SDK_VERSION,extra-android-support,extra-android-m2repository,extra-google-m2repository --no-ui --all --force
    echo "y" | android update sdk --filter "android-19" --no-ui --all --force

To create prebuilt OpenSSL libraries:

    git clone https://github.com/crystax/android-vendor-openssl.git
    cd crystax-ndk-$CRYSTAX_NDK_VERSION
    ./build/tools/build-target-openssl.sh ../android-vendor-openssl/

Alternatively, you can use precompiled versions (currently, available for CrystaX NDK 10.3.1 only):

    cd crystax-ndk-10.3.1/sources
    curl -L -o openssl.tar.gz https://github.com/named-data-mobile/crystax-prebuilt-openssl/archive/crystax-10.3.1.tar.gz
    tar zx --strip-components 1 -C openssl -f openssl.tar.gz
    rm openssl.tar.gz

## Building


    git clone --recursive http://gerrit.named-data.net/NFD-android
    echo sdk.dir=`pwd`/android-sdk-linux > NFD-android/local.properties
    echo ndk.dir=`pwd`/crystax-ndk-10.3.1 >> NFD-android/local.properties
    cd NFD-android

    ./gradlew assembleRelease


## Setting up environment using Vagrant

The development setup can be set up with [Vagrant](https://www.vagrantup.com/) and scripts provided
in `.vagrant/` folder.  After vagrant command-line is installed, the following will create VM
environment and fetch all necessary dependencies:

    cd .vagrant
    vagrant up
    vagrant ssh

Refer to vagrant documentation for more information.