View source for AndroidCompile

This page is an introduction to compilation of VLC for Android on Linux. 

= Eclipse, SDK and NDK installation  =

== Android SDK  ==

#Create a working directory ''android''. 
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download android-sdk_r10-linux_x86.tgz. 
#Decompress into ''android'' folder. 
#Run ''tools/android''. 
#In the tool, install '''"SDK Platform Android 2.3, API 10"''', and follow the instructions.

You can have [http://developer.android.com/sdk/installing.html more details], if needed. 

<br> 

== Android NDK  ==

#Check that the SDK installation is correct. 
#Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page]. 
#Download http://dl.google.com/android/ndk/android-ndk-r5b-linux-x86.tar.bz2. 
#Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

<br> 

== Eclipse  ==

As used by your distribution, install eclipse with your package manager: 

 apt-get install eclipse (debian)
 yum install eclipse (Fedora)
 pacman -S eclipse (Arch)
 emerge -av eclipse-sdk (Gentoo)
 ...

And run it, at least once, and then quit eclipse. 

=== ADT  ===

The '''ADT''' plugin is required to compile on Android. 

#Go to [http://developer.android.com/sdk/eclipse-adt.html#installing ADT page]. 
#Start Eclipse, then select Help &gt; Install New Software.... 
#Add the "ADT Plugin" repository with https://dl-ssl.google.com/android/eclipse/ as '''URL''' 
#Validate and select the checkbox next to Developer Tools and click Next, Next, Finish. 
#Restart Eclipse. 
#Go to ''Menu'' &gt; ''Window'' &gt; ''Preferences...'' and then ''Android'' from the left pane. 
#Point the SDK Location in to your downloaded SDK directory. 
#Ok, and quit Eclipse.

See [http://developer.android.com/sdk/eclipse-adt.html#troubleshooting extra information here]. 

== Environment setup  ==

Be sure to have installed ''git'' and the usual build tools, like ''autotools'', or ''gcc''. 

Set $ANDROID_SDK to point to your android SDK directory 

 export ANDROID_SDK=/path/to/android-sdk

Set $ANDROID_NDK to point to your android NDK directory 

 export ANDROID_NDK=/path/to/android-ndk

Add some useful binaries in your path 

 export PATH=$PATH:$ANDROID_SDK/tools:$ANDROID_SDK/platform-tools

If you plan to use the emulator, you need a build without neon 

 export NO_NEON=1

Those exports must be set at all times, notably for the contribs and the configure. 

= Get VLC Source  =

Use the VLC git repository to get the source! 

In your ''android'' folder, run: 

 git clone git://git.videolan.org/vlc/vlc-android.git

== Contribs  ==

We need 3rd party libraries. We will fetch them from the Internetz. 

 cd extras/contrib
 ./bootstrap -t arm-eabi -d android
 make
 cd -

This '''will''' take time. This is perfectly normal. 

== Configure VLC  ==

Run: 

 ./bootstrap

If this step fails, you are missing some build tools. See [[Compile]]. 

 mkdir build
 cd build
 ../extras/package/android/configure.sh

== Compile VLC  ==

Just run: 

 ./compile -k

== Package VLC  ==

=== JNI  ===

Build the JNI interface for libvlc 

 cd ../extras/package/android
 VLC_BUILD_DIR=../../../build VLC_CONTRIB=../../contrib make

=== Package in eclipse  ===

#In Eclipse, create a new Android project from existing source by giving the extra/platform/android/vlc-android path. 
#Compile your project using Eclipse.

<br> 

== Run  ==

Run it and enjoy! 

== Debug<br>  ==

[http://developer.android.com/guide/developing/debugging/ddms.html DDMS] 

[http://developer.android.com/guide/developing/tools/logcat.html Logcat]