491721466452121d810afebbe529162cc684a45e
[vlc/vlc-android.git] / extras / package / android / HOWTO
1 Basic how to compile VLC on Android platform.
2
3 - Get Eclipse, the Android SDK and the Android NDK.
4 - Read the Android HOWTO and setup all that stuff correctly.
5    - Get the Android SDK Platform 2.2 and 2.3 API (version 8 and (9 or 10)), 
6       or modify numbers in configure.sh and vlc-android/default.properties.
7    - Create an AVD with this platform.
8
9 - Set $ANDROID_NDK to point to your android NDK directory
10    export ANDROID_NDK=/path/to/android-ndk
11
12 - If you plan to use the emulator, you need a build without neon
13    export NO_NEON=1
14   make sure it is set for both the contribs bootstrap next and the configure.sh later.
15
16 - Build the contribs
17    cd extras/contrib
18    ./bootstrap -t arm-eabi -d android
19    make
20    cd -
21
22 - Bootstrap VLC from the root vlc directory:
23    ./bootstrap
24 - Create a build directory:
25    mkdir builddir
26 - Go to this directory:
27    cd builddir
28 - Launch the Android configure script:
29    ../extra/package/android/configure.sh
30 - Start the VLC compilation with:
31    ./compile
32   Some module cannot be compiled at this time, just skip them with "./compile -k"
33
34 - Go to the extra/package/android directory:
35    cd extra/package/android
36 - Build the JNI interface for libvlc
37    VLC_BUILD_DIR=path_to_vlc_builddir ANDROID_SDK=path_to_android_sdk make
38
39 - In Eclipse, create a new Android project from existing source by giving the extra/platform/android/vlc-android path.
40 - Compile your project using Eclipse (or make will do it with ant if available).
41 - Run it and enjoy!
42