VideoLAN Wiki - User contributions [en]

AndroidCompile

2012-06-26T09:12:44Z

Adridu59: /* Building */ Update build instructions + various + cosmetics

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion'', and very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
# Create a working directory ''android''.
# Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
# Decompress into ''android'' folder.
# Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
# In the tool, install '''"SDK Platform Android 4.0, API 14"''', and follow the instructions.

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

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website: http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ==
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 to your $PATH

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

=== Devices ===

You need to export the ABI for your device. <code>armeabi-v7a</code> is for devices with ARMv7 or above, any other device uses <code>armeabi</code>.
export ANDROID_ABI=armeabi-v7a
or
export ANDROID_ABI=armeabi

If you plan to use an armeabi-v7a device that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]
export NO_NEON=1

If you plan to use an armeabi device that does not support FPU, you need a build without FPU
export NO_FPU=1

If you plan to use an ARMv5 armeabi device (read: Android Emulator), you need a build without ARMv6
export NO_ARMV6=1

==== Examples====
* For a normal (2012 consumer phone or tablet), like Cortex-A8 or Cortex-A9
export ANDROID_ABI=armeabi-v7a
* For a Tegra2 device
export ANDROID_ABI=armeabi-v7a
export NO_NEON=1
* For an ARMv6 device
export ANDROID_ABI=armeabi
* For an ARMv6 device without FPU
export ANDROID_ABI=armeabi
export NO_FPU=1
* For an ARMv5 device or the emulator
export ANDROID_ABI=armeabi
export NO_ARMV6=1

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

== Building ==
=== Get VLC Source ===
Clone the source from the VLC git!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder, signed with a debug key.

In order to build a non-debug package:
sh compile.sh release

'''Note:''' At this point, you will get an unsigned release apk in the bin/ folder, which you will have to sign and [http://developer.android.com/tools/help/zipalign.html zipalign].

==== Package in Eclipse [optional] ====
# In Eclipse, create a ''new Android Project from existing source'' by importing from the ''vlc-android'' path.
# Export unsigned/signed apk.

'''Note:''' Building against JDK6 is recommended for optimal compatibility (Set ''Java Compiler Compliance'' to 1.6).

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

===Outdated autotools-dev===
If you get the following error message you may have have an outdated version of autotools-dev:
Invalid configuration `arm-linux-androideabi': system `androideabi' not recognized
You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree]. These files are typically located in /usr/share/misc on Debian based distributions.

[[Category:Building]]

AndroidCompile

2012-06-12T18:41:24Z

Adridu59: /* Android SDK */ Cosmetics.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#In the tool, install '''"SDK Platform Android 4.0, API 14"''', and follow the instructions.

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

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

Set $NO_NDK_V7 if your NDK predates NDK v7. Do not set this if you are using NDK v7, NDK v8, etc...

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

==== Devices ====
If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

If you plan to use the build for a Tegra 2 device:

export TEGRA2=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

'''Note:''' Building against JDK6 is recommended for optimal compatibility (Set Java Compiler Compliance to 1.6).

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

===Outdated autotools-dev===
If you get the following error message you may have have an outdated version of autotools-dev:
Invalid configuration `arm-linux-androideabi': system `androideabi' not recognized
You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree]. These files are typically located in /usr/share/misc on Debian based distributions.

[[Category:Building]]

AndroidCompile

2012-06-12T18:29:53Z

Adridu59: Remove the API 14 (4.0) replacement thing. We target API 14 in project.properties but we need to keep Gingerbread compatibility.

AndroidCompile

2012-06-04T12:50:32Z

Adridu59: /* Android NDK */ Minor path correction.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#In the tool, install '''"SDK Platform Android 4.0, API 14"''', and follow the instructions.

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

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

==== Devices ====
If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

If you plan to use the build for a Tegra 2 device:

export TEGRA2=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

'''Note:''' Building against JDK6 is recommended for optimal compatibility (Set Java Compiler Compliance to 1.6).

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-06-04T12:49:23Z

Adridu59: /* Package in Eclipse */ Added JDK6 note.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#In the tool, install '''"SDK Platform Android 4.0, API 14"''', and follow the instructions.

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

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

==== Devices ====
If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

If you plan to use the build for a Tegra 2 device:

export TEGRA2=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

'''Note:''' Building against JDK6 is recommended for optimal compatibility (Set Java Compiler Compliance to 1.6).

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-06-04T12:46:03Z

Adridu59: /* Devices */ Cleanup + cosmetics.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#In the tool, install '''"SDK Platform Android 4.0, API 14"''', and follow the instructions.

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

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

==== Devices ====
If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

If you plan to use the build for a Tegra 2 device:

export TEGRA2=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-10T18:10:30Z

Adridu59: Revert note about NDKv7.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-10T16:36:06Z

Adridu59: Added a note regarding NDKv7.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

'''Note:''' If you have NDKv7, the NO_NDK_V7 variable must remain unset (do not use NO_NDK_V7=0).

Add some useful binaries to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T21:13:34Z

Adridu59: Updated SDK&NDK entries

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===Android SDK===
#Create a working directory ''android''.
#Go to [http://developer.android.com/sdk/index.html Android SDK page] and download the latest SDK for linux.
#Decompress into ''android'' folder.
#Run ''tools/android'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===Android NDK===
# Check that the SDK installation is correct.
# Go to [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the latest NDK for linux.
# Decompress into ''android'' folder, next to your android-sdk-linux_x86 folder.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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

If you do not use the NDK v7 (note: the build script will try to detect the SDK version)

export NO_NDK_V7=1

Add some useful binaries to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T21:06:09Z

Adridu59: Added a note regarding built file.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

'''Note:''' At this point, you will get an autogenerated debug apk in the bin/ folder. In order to build a non-debug or custom package, use Eclipse as described below.

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T21:02:53Z

Adridu59: Added a note regarding NEON.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

'''Note:''' If you want to get a NEON build, the NO_NEON variable must remain unset (do not use NO_NEON=0).

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T21:01:13Z

Adridu59: Cosmetics.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

===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.

'''Note:''' On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T21:00:44Z

Adridu59: Added indigo builds note.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

===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.

Note: On Debian-based distributions it is better to download Eclipse indigo builds from the official website : http://www.eclipse.org/downloads/, otherwise it can lead to an error when importing the ADT plugin (see following).

====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 > 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'' > ''Window'' > ''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 ===
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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-04-05T20:57:21Z

Adridu59: Removed android-ndk xml file which is outdated and unneeded.

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

==Eclipse, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

===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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

===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 > 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'' > ''Window'' > ''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 ===
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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-02-25T23:31:47Z

Adridu59: /* Linux and autotools */

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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

'''Note''': If you use the Android v7 NDK, replace your /vlc-android/build.xml file as follows:

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<project name="VLC" default="help">


<loadproperties srcFile="local.properties" />


<property file="ant.properties" />


<loadproperties srcFile="project.properties" />


<fail
message="sdk.dir is missing. Make sure to generate local.properties using 'android update project'"
unless="sdk.dir"
/>






<import file="${sdk.dir}/tools/ant/build.xml" />

</project>
</pre>

===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 > 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'' > ''Window'' > ''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 ===
==== Linux and autotools ====
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'' (or ''ant''), ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

==== Environment ====

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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]

AndroidCompile

2012-02-25T23:28:21Z

Adridu59:

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'' (from the command line you can also run: "tools/android update sdk -u -t platform,platform-tool,extra")
#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.

===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.

'''Note''': If you use the Android v7 NDK, replace your /vlc-android/build.xml file as follows:

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<project name="VLC" default="help">


<loadproperties srcFile="local.properties" />


<property file="ant.properties" />


<loadproperties srcFile="project.properties" />


<fail
message="sdk.dir is missing. Make sure to generate local.properties using 'android update project'"
unless="sdk.dir"
/>






<import file="${sdk.dir}/tools/ant/build.xml" />

</project>
</pre>

===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 > 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'' > ''Window'' > ''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 ===
==== Linux and autotools ====
* You '''MUST''' be on Linux, and a recent one.
* You '''MUST''' have installed: ''apache-ant'', ''autoconf'', ''automake'', ''autopoint'', ''libtool'', ''gawk'' (or ''nawk''), ''gcc'', ''g++'', ''pkg-config'', ''cmake'', ''patch'', ''subversion''. And very up-to-date versions of those tools.
* You '''MUST''' install: ''git''.

==== Environment ====

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 to your $PATH

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

If you plan to use the emulator or if you have a phone that does not support NEON, you need a build without [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]]

export NO_NEON=1

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

== Building ==
=== Get VLC Source ===
Use the VLC git repository to get the source!

In your ''android'' folder, run:

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

==== Compile ====
'''Read''' compile.sh first, as it contains some very useful important information. Then run it:
sh compile.sh

==== Package in Eclipse ====
# In Eclipse, create a new Android project from existing source by giving the vlc-android path.
# Compile your project using Eclipse.

=== Run ===
Run it and enjoy!

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

[[Category:Building]]