LeOS-Genesis/BUILD.md

This document explains how to properly build an Android package of Orbot from source.

Orbot includes, in the external directory, git repo submodules of:

• JTorControl: The Tor Control Library for Java
• BadVPN
• JSocks

Please install the following prerequisites (instructions for each follows):

• Android Software Development Kit or SDK (for Java code): http://developer.android.com/sdk/index.html (Android Studio)
• Android Native Development Kit or NDK (for C/C++ code) http://developer.android.com/sdk/ndk/index.html (This can be installed through Android Studio's SDK Manager)

Be sure that you have all of the git submodules up-to-date:

git submodule update --init --recursive

You then need to run "ndk-build" and the following commands to compile and prepare Orbot's native code:

UNIX:

	cd orbotservice/src/main
	ndk-build (located in Android/Sdk/ndk/VERSION/)
	mv libs/armeabi-v7a/pdnsd libs/armeabi-v7a/pdnsd.so
	mv libs/arm64-v8a/pdnsd libs/arm64-v8a/pdnsd.so
	mv libs/x86/pdnsd libs/x86/pdnsd.so
	mv libs/x86_64/pdnsd libs/x86_64/pdnsd.so

Windows:

	cd orbotservice\src\main
	ndk-build.cmd (located in Android\Sdk\ndk\VERSION\) 
	ren libs\armeabi-v7a\pdnsd pdnsd.so
	ren libs\arm64-v8a\pdnsd pdnsd.so
	ren libs\x86\pdnsd pdnsd.so
	ren libs\x86_64\pdnsd pdnsd.so

Now build the Android app using Android Studio/gradle

This will produce an unsigned Orbot package APK.

To produce a usable package, you'll need to sign the .apk. The basics on signing can be found on the Android developer site:

http://developer.android.com/guide/publishing/app-signing.html