VideoLAN Wiki - User contributions [en]

AndroidCompile

2020-03-11T15:01:28Z

Dekans: Undo revision 62019 by Dekans (talk)

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r21''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2020-03-11T15:01:15Z

Dekans: Undo revision 62020 by Dekans (talk)

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r21''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2020-03-11T15:00:16Z

Dekans: /* Troubleshooting */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r21''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2020-03-11T14:59:56Z

Dekans: /* Android Studio, SDK and NDK installation */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r21''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2020-02-20T14:44:24Z

Dekans: /* Android NDK */

AndroidCompile

2019-12-23T10:36:29Z

Dekans: /* Build LibVLC */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2019-12-23T10:36:13Z

Dekans: /* Build LibVLC */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
buildsystem/compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2019-12-23T10:35:58Z

Dekans: Change compile script location

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
buildsystem/compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
buildsystem/compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Checklist

2019-07-12T08:48:09Z

Dekans: /* This page is intended to list all VLC Android app features we have to set before every release. */

== VLC for Android features checklist ==

==== This page is intended to list all VLC Android app features we have to set before every release. ====

General
* Medialibrary migration from previous version
* Black Theme
* DayNight mode
* General display with system fonts set to large
* Search
* Filtering

Video
* Network playback
* Restore video playback after multitasking
* Second screen mode in video player (HDMI/screencast)
* Chromecast
* Background video playback
* Picture-in-Picture mode (custom one and Android 8+ PiP mode)
* Videos playlist
* Subtitles picker
* Subtitles download
* Audio/Video transition

Audio
* Audio playback
* Remote controls
* Audio playlists

Playlists
* listing
* modifications (including reordering)

Browsing
* Local browsing
* Network browsing
* Network favorites
* Network playback
* Network login

TV
* Medalibrary & files browsing
* Playlists
* Now Playing (card in app + card on Home screen)

Auto
* Browsing
* voice actions

Other
* Equalizer
* Compatibility with Android 4.x
* Playback history
* Open media from 3rd party Apps
* Check settings are functional

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Android]]

Android Checklist

2019-07-10T08:24:53Z

Dekans: Checklist update before 3.2 beta

== VLC for Android features checklist ==

==== This page is intended to list all VLC Android app features we have to set before every release. ====

General
* Black Theme
* DayNight mode
* General display with system fonts set to large
* Search
* Filtering

Video
* Restore video playback after multitasking
* Second screen mode in video player
* Chromecast
* Background video playback
* Picture-in-Picture mode (custom one and Android 8+ PiP mode)
* Videos playlist
* Subtitles picker
* Subtitles download
* Audio/Video transition

Audio
* Audio playback
* Remote controls
* Audio playlists

Playlists
* listing
* modifications (including reordering)

Browsing
* Local browsing
* Network browsing
* Network favorites
* Network playback
* Network login

TV
* Medalibrary & files browsing
* Playlists
* Now Playing (card in app + card on Home screen)

Auto
* Browsing
* voice actions

Other
* Equalizer
* Compatibility with Android 4.x
* Playback history
* Open media from 3rd party Apps
* Check settings are functional

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Android]]

AndroidCompile

2019-03-12T08:53:15Z

Dekans: /* Example on Ubuntu */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2019-02-05T15:07:52Z

Dekans: Undo revision 56573 by DoesItReallyMatter (talk)

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2018-11-12T10:37:29Z

Dekans: /* Android NDK */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r18b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2018-11-12T10:37:16Z

Dekans: /* SDK & Android Studio */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2018-11-12T10:35:57Z

Dekans: /* Example on Ubuntu */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Documentation:Android

2018-04-06T14:25:33Z

Dekans: /* Feature Overview */

<big>------ Work in progress ------</big>

Here is the documentation of the Android port of VLC media player.

== Preliminary Notes ==
VLC for Android is a little different from VLC on desktops. In some ways, you can do more; in other ways, you can do less. VLC for Android only does media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of a phone interface for size reasons. However, all features are also available on tablets with a similar appearance.

 
== Feature Overview ==

{| border="1" cellpadding="2" class="wikitable" style="border: 1px solid dark green; text-align: center; width: 100%; margin: 1em auto 1em auto"
! scope="col" width="150px" | Feature
! scope="col" width="100px" | Version 1.0
! scope="col" width="100px" | Version 1.6
! scope="col" width="100px" | Version 2.0
! scope="col" width="100px" | Version 2.5
! scope="col" width="100px" | Version 3.0
! scope="col" width="100px" | Version 3.1
|-
| Opening Network Streams || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| UPnP discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Plex server discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Password-protected Plex shares || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Downloads from UPnP multimedia servers || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| FTP discovery, streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Store FTP server bookmarks || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles Font Customization || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Closed Caption playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Teletext subtitles playback || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Multi-track audio handling || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Filtering incl. Screen Brightness || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Video Cropping and Aspect Ratio variation || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Deinterlacing || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback Speed control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio/Subtitles delay control || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Repeated playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Gestures based playback control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback of Audio-only media (mp3, m4a, flac, …) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback timer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chapter & title selection || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 10-band equalizer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback UI Lock || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Smart Media Library sorting for audio albums and TV shows || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Media Library Search || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Passcode Lock || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Voice search support || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Voice actions support || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Organize media in folders || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Use folders as playlists || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Loop playlists || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback control through headphones or lock screen || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Mediasession support (Wear, TV, etc…) || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback is paused when headphones are unplugged || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| WiFi upload and HTTP downloads in background || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Support for password protected HTTP streams || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Sharing files with further apps || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Custom vlc:// protocol || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Support for x-callback-url || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}}
|-
| Action mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android TV || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Picture-in-Picture || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| ChromeOS support || {{No}} || {{ARC}} || {{ARC}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android Auto || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}}
|-
| Sorting || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 360° videos || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| DayNight mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chromecast || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Equalizer custom presets || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Audio boost || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Android 2.1 support || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.2 support || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.3 support || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Android 6 (Runtime permissions) || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android 8 support || {{No}} || {{No}} || {{No}} || {{Partial}} || {{Partial}} || {{Yes}}
|}

== Installation ==
There are many ways to install VLC on Android. This may be because you have a non-ARMv7 or x86 processor or do not wish to use the Play Store for whatever reason.

=== From the Play Store (recommended) ===
The normal way, for ARMv7 (and above) and x86 processors only. Don't know your processor? Don't worry, if you can download it, you have a compatible ARMv7 or an x86 processor.

: https://play.google.com/store/apps/details?id=org.videolan.vlc
 

=== From the F-Droid Repository ===
The F-Droid repository (https://f-droid.org) is a completely FOSS (Free and Open Source Software) equivalent to the Google Play Store. The F-Droid Repository and all apps within it are provided completely free of charge and licensed under open source licenses. The F-Droid repository can be downloaded directly from their website. The "Unknown Sources" setting must be turned on for Android devices (typically located in Settings -> Security) in order to install repositories other than the Google Play Store.
 

=== From VideoLAN ===
If you can't download from the Play Store or just want to install the VLC .apk by yourself, follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our download server, preferably from your device: http://get.videolan.org/vlc-android/{{Android:latest version}}/
# Choose your processor architecture (ARMv7 or Intel x86) and grab the .apk file.
# Click on the .apk you just downloaded and install it.

Don't really know your processor architecture? Try both... it's not very clever, but it's harmless.

None of the two work? It is possible that you have an older processor with the ARMv6 architecture. The solution for now is to install a Nightly Build release. See below.

Still doesn't work? Really? Well, then you must have an exotic processor... Contact us, on the [http://forum.videolan.org/viewforum.php?f=35 Android forum] or directly at [mailto:videolan.mobile@gmail.com videolan.mobile@gmail.com].
 

=== Be a Beta tester or try a Beta release ===
You want want to know the future of VLC for Android?
You want to help us and/or test if your issue is already fixed for the next release ?

==== Be a Beta tester ====

Just follow this link [https://play.google.com/apps/testing/org.videolan.vlc Be a Beta tester]

Soon, Beta release will automatically install on our device.

==== Try a Beta release ====
You don't want to be a Beta Tester but just try a Beta ? Follow these steps :

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device, : http://get.videolan.org/testing/android/{{Android:latest beta version}}/
# Choose your processor architecture (ARMv7, ARMv8, x86...) Don't really know your processor architecture? Try both... it's not very clever, but it's harmless
# Download the chosen .apk on your device
# Click on the .apk you just download and install it.

 

=== Install a Nightly Build ===
You fear nothing and want our very last works on VLC ? Or you have an ARMv6 Processor and want VLC? Follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device: http://nightlies.videolan.org/
# Choose your processor architecture (ARMv7, ARMv8, x86...)
# Grab the latest .apk
# Click on the .apk you just download and install it.

You may experience some weird issues but generally, it works fine. If not, please try an older nightly release, and contact us.

 

==Interface==
At first start, VLC scans all your device to find all your media files. This is the main interface after the scan :

{|style="width: 50%;"|
|[[File:Android_Main.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Show Menu
|-
|[[File:caption_2.png|40x40px]] || Video view
|-
|[[File:caption_3.png|40x40px]] || Audio view
|-
|[[File:caption_4.png|40x40px]] || Directory view
|-
|[[File:caption_5.png|40x40px]] || History view
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_6.png|40x40px]] || Video browser view
|-
| [[File:caption_7.png|40x40px]] || Search a specific media
|-
| [[File:caption_8.png|40x40px]] || Open network MRL
|-
| [[File:caption_9.png|40x40px]] || Load last playlist
|-
|style="vertical-align:top;"|[[File:caption_10.png|40x40px]]
| More actions : 
* Sort by name or length 
* Refresh your media library 
* Equalizer 
* Preferences 
* About VLC 
|}
|}

 

==Playing Video==
===Video browser view===
This view displays all your videos present in your device, or in the directories you have specified (see Preferences). To play one, just click on it, like the video [[File:caption_1.png|30x30px]].

Note the difference with the video [[File:caption_2.png|30x30px]] which is a group of videos : VLC automatically groups your videos with the 4 same starting letters.

{|style="width: 50%;"|
|[[File:Android VideoBrowser.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || A Video
|-
|[[File:caption_2.png|40x40px]] || A group of videos.
|}
|}

 

=== Video playback interface ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Interface.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Video title
|-
|[[File:caption_2.png|40x40px]] || Battery and time
|-
|[[File:caption_3.png|40x40px]] || Play / Pause
|-
|[[File:caption_4.png|40x40px]] || Aspect ratio
|-
|[[File:caption_5.png|40x40px]] || Audio tracks
|-
|[[File:caption_6.png|40x40px]] || Subtitles tracks
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_7.png|40x40px]] || Video menu (for DVD iso)
|-
| [[File:caption_8.png|40x40px]] || Lock screen
|-
| [[File:caption_9.png|40x40px]] || Elapsed time
|-
| [[File:caption_10.png|40x40px]] || Seek bar
|-
| [[File:caption_11.png|40x40px]] || Total time / Remaining time
|-
|style="vertical-align:top;"| [[File:caption_12.png|40x40px]] || Advanced Options
* Playback Speed
* Sleep timer
* Jump to specific time
* Add subtitle
|}
|}

Some precisions:
* You can change audio and/or subtitle track if there are any. If not, these icons won't be displayed.
* The Video Menu icon is only displayed for iso video (a DVD iso for example)

 

=== Video playback gesture ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Gesture.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Adjust Brightness
|-
|[[File:caption_2.png|40x40px]] || Adjust Volume
|-
|[[File:caption_3.png|40x40px]] || Quick search
|}
|}

 

== Playing Audio ==
TODO

* You can change the time display to remaining time (e.g. -1:30 for 1:30 minutes remaining) in the audio player by tapping on the current time label in the left.

== Settings ==

== See Also ==

[[AndroidFAQ]] 
[[Android Checklist]] 
[[Android Player Intents]] 
[[Android Report bugs]] 

[[Category:Mobile documentation]]
[[Category:Android]]

Documentation:Android

2018-04-06T14:23:37Z

Dekans: /* Feature Overview */

<big>------ Work in progress ------</big>

Here is the documentation of the Android port of VLC media player.

== Preliminary Notes ==
VLC for Android is a little different from VLC on desktops. In some ways, you can do more; in other ways, you can do less. VLC for Android only does media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of a phone interface for size reasons. However, all features are also available on tablets with a similar appearance.

 
== Feature Overview ==

{| border="1" cellpadding="2" class="wikitable" style="border: 1px solid dark green; text-align: center; width: 100%; margin: 1em auto 1em auto"
! scope="col" width="150px" | Feature
! scope="col" width="100px" | Version 1.0
! scope="col" width="100px" | Version 1.6
! scope="col" width="100px" | Version 2.0
! scope="col" width="100px" | Version 2.5
! scope="col" width="100px" | Version 3.0
! scope="col" width="100px" | Version 3.1
|-
| Opening Network Streams || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| UPnP discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Plex server discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Password-protected Plex shares || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Downloads from UPnP multimedia servers || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| FTP discovery, streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Store FTP server bookmarks || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles Font Customization || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Closed Caption playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Teletext subtitles playback || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Multi-track audio handling || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Filtering incl. Screen Brightness || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Video Cropping and Aspect Ratio variation || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Deinterlacing || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback Speed control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio/Subtitles delay control || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Repeated playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Gestures based playback control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback of Audio-only media (mp3, m4a, flac, …) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback timer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chapter & title selection || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 10-band equalizer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback UI Lock || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Smart Media Library sorting for audio albums and TV shows || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Media Library Search || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Passcode Lock || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Voice search support || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Voice actions support || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Organize media in folders || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Use folders as playlists || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Loop playlists || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback control through headphones or lock screen || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Mediasession support (Wear, TV, etc…) || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback is paused when headphones are unplugged || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| WiFi upload and HTTP downloads in background || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Support for password protected HTTP streams || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Sharing files with further apps || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Custom vlc:// protocol || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Support for x-callback-url || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}}
|-
| Action mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android TV || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Picture-in-Picture || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| ChromeOS support || {{No}} || {{ARC}} || {{ARC}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android Auto || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}}
|-
| Sorting || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 360° videos || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| DayNight mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chromecast || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Equalizer custom presets || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Audio boost || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Android 2.1 support || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.2 support || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.3 support || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Android 6 (Runtime permissions) || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android 8 support || {{No}} || {{No}} || {{No}} || {{Partial}} || {{Partial}} || {{Yes}}
|}

== Installation ==
There are many ways to install VLC on Android. This may be because you have a non-ARMv7 or x86 processor or do not wish to use the Play Store for whatever reason.

=== From the Play Store (recommended) ===
The normal way, for ARMv7 (and above) and x86 processors only. Don't know your processor? Don't worry, if you can download it, you have a compatible ARMv7 or an x86 processor.

: https://play.google.com/store/apps/details?id=org.videolan.vlc
 

=== From the F-Droid Repository ===
The F-Droid repository (https://f-droid.org) is a completely FOSS (Free and Open Source Software) equivalent to the Google Play Store. The F-Droid Repository and all apps within it are provided completely free of charge and licensed under open source licenses. The F-Droid repository can be downloaded directly from their website. The "Unknown Sources" setting must be turned on for Android devices (typically located in Settings -> Security) in order to install repositories other than the Google Play Store.
 

=== From VideoLAN ===
If you can't download from the Play Store or just want to install the VLC .apk by yourself, follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our download server, preferably from your device: http://get.videolan.org/vlc-android/{{Android:latest version}}/
# Choose your processor architecture (ARMv7 or Intel x86) and grab the .apk file.
# Click on the .apk you just downloaded and install it.

Don't really know your processor architecture? Try both... it's not very clever, but it's harmless.

None of the two work? It is possible that you have an older processor with the ARMv6 architecture. The solution for now is to install a Nightly Build release. See below.

Still doesn't work? Really? Well, then you must have an exotic processor... Contact us, on the [http://forum.videolan.org/viewforum.php?f=35 Android forum] or directly at [mailto:videolan.mobile@gmail.com videolan.mobile@gmail.com].
 

=== Be a Beta tester or try a Beta release ===
You want want to know the future of VLC for Android?
You want to help us and/or test if your issue is already fixed for the next release ?

==== Be a Beta tester ====

Just follow this link [https://play.google.com/apps/testing/org.videolan.vlc Be a Beta tester]

Soon, Beta release will automatically install on our device.

==== Try a Beta release ====
You don't want to be a Beta Tester but just try a Beta ? Follow these steps :

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device, : http://get.videolan.org/testing/android/{{Android:latest beta version}}/
# Choose your processor architecture (ARMv7, ARMv8, x86...) Don't really know your processor architecture? Try both... it's not very clever, but it's harmless
# Download the chosen .apk on your device
# Click on the .apk you just download and install it.

 

=== Install a Nightly Build ===
You fear nothing and want our very last works on VLC ? Or you have an ARMv6 Processor and want VLC? Follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device: http://nightlies.videolan.org/
# Choose your processor architecture (ARMv7, ARMv8, x86...)
# Grab the latest .apk
# Click on the .apk you just download and install it.

You may experience some weird issues but generally, it works fine. If not, please try an older nightly release, and contact us.

 

==Interface==
At first start, VLC scans all your device to find all your media files. This is the main interface after the scan :

{|style="width: 50%;"|
|[[File:Android_Main.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Show Menu
|-
|[[File:caption_2.png|40x40px]] || Video view
|-
|[[File:caption_3.png|40x40px]] || Audio view
|-
|[[File:caption_4.png|40x40px]] || Directory view
|-
|[[File:caption_5.png|40x40px]] || History view
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_6.png|40x40px]] || Video browser view
|-
| [[File:caption_7.png|40x40px]] || Search a specific media
|-
| [[File:caption_8.png|40x40px]] || Open network MRL
|-
| [[File:caption_9.png|40x40px]] || Load last playlist
|-
|style="vertical-align:top;"|[[File:caption_10.png|40x40px]]
| More actions : 
* Sort by name or length 
* Refresh your media library 
* Equalizer 
* Preferences 
* About VLC 
|}
|}

 

==Playing Video==
===Video browser view===
This view displays all your videos present in your device, or in the directories you have specified (see Preferences). To play one, just click on it, like the video [[File:caption_1.png|30x30px]].

Note the difference with the video [[File:caption_2.png|30x30px]] which is a group of videos : VLC automatically groups your videos with the 4 same starting letters.

{|style="width: 50%;"|
|[[File:Android VideoBrowser.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || A Video
|-
|[[File:caption_2.png|40x40px]] || A group of videos.
|}
|}

 

=== Video playback interface ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Interface.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Video title
|-
|[[File:caption_2.png|40x40px]] || Battery and time
|-
|[[File:caption_3.png|40x40px]] || Play / Pause
|-
|[[File:caption_4.png|40x40px]] || Aspect ratio
|-
|[[File:caption_5.png|40x40px]] || Audio tracks
|-
|[[File:caption_6.png|40x40px]] || Subtitles tracks
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_7.png|40x40px]] || Video menu (for DVD iso)
|-
| [[File:caption_8.png|40x40px]] || Lock screen
|-
| [[File:caption_9.png|40x40px]] || Elapsed time
|-
| [[File:caption_10.png|40x40px]] || Seek bar
|-
| [[File:caption_11.png|40x40px]] || Total time / Remaining time
|-
|style="vertical-align:top;"| [[File:caption_12.png|40x40px]] || Advanced Options
* Playback Speed
* Sleep timer
* Jump to specific time
* Add subtitle
|}
|}

Some precisions:
* You can change audio and/or subtitle track if there are any. If not, these icons won't be displayed.
* The Video Menu icon is only displayed for iso video (a DVD iso for example)

 

=== Video playback gesture ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Gesture.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Adjust Brightness
|-
|[[File:caption_2.png|40x40px]] || Adjust Volume
|-
|[[File:caption_3.png|40x40px]] || Quick search
|}
|}

 

== Playing Audio ==
TODO

* You can change the time display to remaining time (e.g. -1:30 for 1:30 minutes remaining) in the audio player by tapping on the current time label in the left.

== Settings ==

== See Also ==

[[AndroidFAQ]] 
[[Android Checklist]] 
[[Android Player Intents]] 
[[Android Report bugs]] 

[[Category:Mobile documentation]]
[[Category:Android]]

Documentation:Android

2018-04-06T13:36:28Z

Dekans: /* Feature Overview */

<big>------ Work in progress ------</big>

Here is the documentation of the Android port of VLC media player.

== Preliminary Notes ==
VLC for Android is a little different from VLC on desktops. In some ways, you can do more; in other ways, you can do less. VLC for Android only does media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of a phone interface for size reasons. However, all features are also available on tablets with a similar appearance.

 
== Feature Overview ==

{| border="1" cellpadding="2" class="wikitable" style="border: 1px solid dark green; text-align: center; width: 100%; margin: 1em auto 1em auto"
! scope="col" width="150px" | Feature
! scope="col" width="100px" | Version 1.0
! scope="col" width="100px" | Version 1.6
! scope="col" width="100px" | Version 2.0
! scope="col" width="100px" | Version 2.5
! scope="col" width="100px" | Version 3.0
! scope="col" width="100px" | Version 3.1
|-
| Opening Network Streams || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| UPnP discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Plex server discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Password-protected Plex shares || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Downloads from UPnP multimedia servers || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| FTP discovery, streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Store FTP server bookmarks || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles Font Customization || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Closed Caption playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Teletext subtitles playback || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Multi-track audio handling || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Filtering incl. Screen Brightness || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Cropping and Aspect Ratio variation || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Deinterlacing || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback Speed control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio/Subtitles delay control || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Repeated playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Gestures based playback control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback of Audio-only media (mp3, m4a, flac, …) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback timer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chapter & title selection || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 10-band equalizer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback UI Lock || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Smart Media Library sorting for audio albums and TV shows || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Media Library Search || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Passcode Lock || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Voice search support || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Voice actions support || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Organize media in folders || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Use folders as playlists || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Loop playlists || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback control through headphones or lock screen || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Mediasession support (Wear, TV, etc…) || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback is paused when headphones are unplugged || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| WiFi upload and HTTP downloads in background || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Support for password protected HTTP streams || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Sharing files with further apps || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Custom vlc:// protocol || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Support for x-callback-url || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}}
|-
| Action mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android TV || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Picture-in-Picture || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| ChromeOS support || {{No}} || {{ARC}} || {{ARC}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android Auto || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}}
|-
| Sorting || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 360° videos || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| DayNight mode || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chromecast || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Equalizer custom presets || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Audio boost || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Android 2.1 support || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.2 support || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.3 support || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Android 6 (Runtime permissions) || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android 8 support || {{No}} || {{No}} || {{No}} || {{Partial}} || {{Partial}} || {{Yes}}
|}

== Installation ==
There are many ways to install VLC on Android. This may be because you have a non-ARMv7 or x86 processor or do not wish to use the Play Store for whatever reason.

=== From the Play Store (recommended) ===
The normal way, for ARMv7 (and above) and x86 processors only. Don't know your processor? Don't worry, if you can download it, you have a compatible ARMv7 or an x86 processor.

: https://play.google.com/store/apps/details?id=org.videolan.vlc
 

=== From the F-Droid Repository ===
The F-Droid repository (https://f-droid.org) is a completely FOSS (Free and Open Source Software) equivalent to the Google Play Store. The F-Droid Repository and all apps within it are provided completely free of charge and licensed under open source licenses. The F-Droid repository can be downloaded directly from their website. The "Unknown Sources" setting must be turned on for Android devices (typically located in Settings -> Security) in order to install repositories other than the Google Play Store.
 

=== From VideoLAN ===
If you can't download from the Play Store or just want to install the VLC .apk by yourself, follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our download server, preferably from your device: http://get.videolan.org/vlc-android/{{Android:latest version}}/
# Choose your processor architecture (ARMv7 or Intel x86) and grab the .apk file.
# Click on the .apk you just downloaded and install it.

Don't really know your processor architecture? Try both... it's not very clever, but it's harmless.

None of the two work? It is possible that you have an older processor with the ARMv6 architecture. The solution for now is to install a Nightly Build release. See below.

Still doesn't work? Really? Well, then you must have an exotic processor... Contact us, on the [http://forum.videolan.org/viewforum.php?f=35 Android forum] or directly at [mailto:videolan.mobile@gmail.com videolan.mobile@gmail.com].
 

=== Be a Beta tester or try a Beta release ===
You want want to know the future of VLC for Android?
You want to help us and/or test if your issue is already fixed for the next release ?

==== Be a Beta tester ====

Just follow this link [https://play.google.com/apps/testing/org.videolan.vlc Be a Beta tester]

Soon, Beta release will automatically install on our device.

==== Try a Beta release ====
You don't want to be a Beta Tester but just try a Beta ? Follow these steps :

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device, : http://get.videolan.org/testing/android/{{Android:latest beta version}}/
# Choose your processor architecture (ARMv7, ARMv8, x86...) Don't really know your processor architecture? Try both... it's not very clever, but it's harmless
# Download the chosen .apk on your device
# Click on the .apk you just download and install it.

 

=== Install a Nightly Build ===
You fear nothing and want our very last works on VLC ? Or you have an ARMv6 Processor and want VLC? Follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device: http://nightlies.videolan.org/
# Choose your processor architecture (ARMv7, ARMv8, x86...)
# Grab the latest .apk
# Click on the .apk you just download and install it.

You may experience some weird issues but generally, it works fine. If not, please try an older nightly release, and contact us.

 

==Interface==
At first start, VLC scans all your device to find all your media files. This is the main interface after the scan :

{|style="width: 50%;"|
|[[File:Android_Main.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Show Menu
|-
|[[File:caption_2.png|40x40px]] || Video view
|-
|[[File:caption_3.png|40x40px]] || Audio view
|-
|[[File:caption_4.png|40x40px]] || Directory view
|-
|[[File:caption_5.png|40x40px]] || History view
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_6.png|40x40px]] || Video browser view
|-
| [[File:caption_7.png|40x40px]] || Search a specific media
|-
| [[File:caption_8.png|40x40px]] || Open network MRL
|-
| [[File:caption_9.png|40x40px]] || Load last playlist
|-
|style="vertical-align:top;"|[[File:caption_10.png|40x40px]]
| More actions : 
* Sort by name or length 
* Refresh your media library 
* Equalizer 
* Preferences 
* About VLC 
|}
|}

 

==Playing Video==
===Video browser view===
This view displays all your videos present in your device, or in the directories you have specified (see Preferences). To play one, just click on it, like the video [[File:caption_1.png|30x30px]].

Note the difference with the video [[File:caption_2.png|30x30px]] which is a group of videos : VLC automatically groups your videos with the 4 same starting letters.

{|style="width: 50%;"|
|[[File:Android VideoBrowser.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || A Video
|-
|[[File:caption_2.png|40x40px]] || A group of videos.
|}
|}

 

=== Video playback interface ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Interface.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Video title
|-
|[[File:caption_2.png|40x40px]] || Battery and time
|-
|[[File:caption_3.png|40x40px]] || Play / Pause
|-
|[[File:caption_4.png|40x40px]] || Aspect ratio
|-
|[[File:caption_5.png|40x40px]] || Audio tracks
|-
|[[File:caption_6.png|40x40px]] || Subtitles tracks
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_7.png|40x40px]] || Video menu (for DVD iso)
|-
| [[File:caption_8.png|40x40px]] || Lock screen
|-
| [[File:caption_9.png|40x40px]] || Elapsed time
|-
| [[File:caption_10.png|40x40px]] || Seek bar
|-
| [[File:caption_11.png|40x40px]] || Total time / Remaining time
|-
|style="vertical-align:top;"| [[File:caption_12.png|40x40px]] || Advanced Options
* Playback Speed
* Sleep timer
* Jump to specific time
* Add subtitle
|}
|}

Some precisions:
* You can change audio and/or subtitle track if there are any. If not, these icons won't be displayed.
* The Video Menu icon is only displayed for iso video (a DVD iso for example)

 

=== Video playback gesture ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Gesture.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Adjust Brightness
|-
|[[File:caption_2.png|40x40px]] || Adjust Volume
|-
|[[File:caption_3.png|40x40px]] || Quick search
|}
|}

 

== Playing Audio ==
TODO

* You can change the time display to remaining time (e.g. -1:30 for 1:30 minutes remaining) in the audio player by tapping on the current time label in the left.

== Settings ==

== See Also ==

[[AndroidFAQ]] 
[[Android Checklist]] 
[[Android Player Intents]] 
[[Android Report bugs]] 

[[Category:Mobile documentation]]
[[Category:Android]]

Documentation:Android

2018-04-06T13:31:30Z

Dekans: /* Preliminary Notes */

<big>------ Work in progress ------</big>

Here is the documentation of the Android port of VLC media player.

== Preliminary Notes ==
VLC for Android is a little different from VLC on desktops. In some ways, you can do more; in other ways, you can do less. VLC for Android only does media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of a phone interface for size reasons. However, all features are also available on tablets with a similar appearance.

 
== Feature Overview ==

{| border="1" cellpadding="2" class="wikitable" style="border: 1px solid dark green; text-align: center; width: 100%; margin: 1em auto 1em auto"
! scope="col" width="150px" | Feature
! scope="col" width="100px" | Version 1.0
! scope="col" width="100px" | Version 1.6
! scope="col" width="100px" | Version 2.0
! scope="col" width="100px" | Version 2.5
! scope="col" width="100px" | Version 3.0
! scope="col" width="100px" | Version 3.1
|-
| Opening Network Streams || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| UPnP discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Plex server discovery and streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Password-protected Plex shares || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Downloads from UPnP multimedia servers || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| FTP discovery, streaming || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Store FTP server bookmarks || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback via Connector Cables || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Subtitles Font Customization || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Closed Caption playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Teletext subtitles playback || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Multi-track audio handling || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Filtering incl. Screen Brightness || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Cropping and Aspect Ratio variation || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Deinterlacing || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback Speed control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio/Subtitles delay control || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Repeated playback || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Gestures based playback control || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback of Audio-only media (mp3, m4a, flac, …) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Audio Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Video Playback in Background || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback timer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chapter & title selection || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| 10-band equalizer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback UI Lock || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Smart Media Library sorting for audio albums and TV shows || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Media Library Search || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Passcode Lock || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Voice search support || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Voice actions support || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Organize media in folders || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Use folders as playlists || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Loop playlists || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback control through headphones or lock screen || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Mediasession support (Wear, TV, etc…) || {{No}} || {{No}} || {{Partial}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Playback is paused when headphones are unplugged || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| WiFi upload and HTTP downloads in background || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Support for password protected HTTP streams || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Sharing files with further apps || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Custom vlc:// protocol || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Support for x-callback-url || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}}
|-
| Android TV || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Picture-in-Picture || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| ChromeOS support || {{No}} || {{ARC}} || {{ARC}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android Auto || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}}
|-
| 360° videos || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Chromecast || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Android 2.1 support || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.2 support || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}}
|-
| Android 2.3 support || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Android 6 (Runtime permissions) || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Android 8 support || {{No}} || {{No}} || {{No}} || {{Partial}} || {{Partial}} || {{Yes}}
|}

== Installation ==
There are many ways to install VLC on Android. This may be because you have a non-ARMv7 or x86 processor or do not wish to use the Play Store for whatever reason.

=== From the Play Store (recommended) ===
The normal way, for ARMv7 (and above) and x86 processors only. Don't know your processor? Don't worry, if you can download it, you have a compatible ARMv7 or an x86 processor.

: https://play.google.com/store/apps/details?id=org.videolan.vlc
 

=== From the F-Droid Repository ===
The F-Droid repository (https://f-droid.org) is a completely FOSS (Free and Open Source Software) equivalent to the Google Play Store. The F-Droid Repository and all apps within it are provided completely free of charge and licensed under open source licenses. The F-Droid repository can be downloaded directly from their website. The "Unknown Sources" setting must be turned on for Android devices (typically located in Settings -> Security) in order to install repositories other than the Google Play Store.
 

=== From VideoLAN ===
If you can't download from the Play Store or just want to install the VLC .apk by yourself, follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our download server, preferably from your device: http://get.videolan.org/vlc-android/{{Android:latest version}}/
# Choose your processor architecture (ARMv7 or Intel x86) and grab the .apk file.
# Click on the .apk you just downloaded and install it.

Don't really know your processor architecture? Try both... it's not very clever, but it's harmless.

None of the two work? It is possible that you have an older processor with the ARMv6 architecture. The solution for now is to install a Nightly Build release. See below.

Still doesn't work? Really? Well, then you must have an exotic processor... Contact us, on the [http://forum.videolan.org/viewforum.php?f=35 Android forum] or directly at [mailto:videolan.mobile@gmail.com videolan.mobile@gmail.com].
 

=== Be a Beta tester or try a Beta release ===
You want want to know the future of VLC for Android?
You want to help us and/or test if your issue is already fixed for the next release ?

==== Be a Beta tester ====

Just follow this link [https://play.google.com/apps/testing/org.videolan.vlc Be a Beta tester]

Soon, Beta release will automatically install on our device.

==== Try a Beta release ====
You don't want to be a Beta Tester but just try a Beta ? Follow these steps :

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device, : http://get.videolan.org/testing/android/{{Android:latest beta version}}/
# Choose your processor architecture (ARMv7, ARMv8, x86...) Don't really know your processor architecture? Try both... it's not very clever, but it's harmless
# Download the chosen .apk on your device
# Click on the .apk you just download and install it.

 

=== Install a Nightly Build ===
You fear nothing and want our very last works on VLC ? Or you have an ARMv6 Processor and want VLC? Follow these steps:

# Go to Android Settings → Security → Device Administration → Enable 'Unknown Sources'
# Go to our server, preferably from your device: http://nightlies.videolan.org/
# Choose your processor architecture (ARMv7, ARMv8, x86...)
# Grab the latest .apk
# Click on the .apk you just download and install it.

You may experience some weird issues but generally, it works fine. If not, please try an older nightly release, and contact us.

 

==Interface==
At first start, VLC scans all your device to find all your media files. This is the main interface after the scan :

{|style="width: 50%;"|
|[[File:Android_Main.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Show Menu
|-
|[[File:caption_2.png|40x40px]] || Video view
|-
|[[File:caption_3.png|40x40px]] || Audio view
|-
|[[File:caption_4.png|40x40px]] || Directory view
|-
|[[File:caption_5.png|40x40px]] || History view
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_6.png|40x40px]] || Video browser view
|-
| [[File:caption_7.png|40x40px]] || Search a specific media
|-
| [[File:caption_8.png|40x40px]] || Open network MRL
|-
| [[File:caption_9.png|40x40px]] || Load last playlist
|-
|style="vertical-align:top;"|[[File:caption_10.png|40x40px]]
| More actions : 
* Sort by name or length 
* Refresh your media library 
* Equalizer 
* Preferences 
* About VLC 
|}
|}

 

==Playing Video==
===Video browser view===
This view displays all your videos present in your device, or in the directories you have specified (see Preferences). To play one, just click on it, like the video [[File:caption_1.png|30x30px]].

Note the difference with the video [[File:caption_2.png|30x30px]] which is a group of videos : VLC automatically groups your videos with the 4 same starting letters.

{|style="width: 50%;"|
|[[File:Android VideoBrowser.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || A Video
|-
|[[File:caption_2.png|40x40px]] || A group of videos.
|}
|}

 

=== Video playback interface ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Interface.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Video title
|-
|[[File:caption_2.png|40x40px]] || Battery and time
|-
|[[File:caption_3.png|40x40px]] || Play / Pause
|-
|[[File:caption_4.png|40x40px]] || Aspect ratio
|-
|[[File:caption_5.png|40x40px]] || Audio tracks
|-
|[[File:caption_6.png|40x40px]] || Subtitles tracks
|}
|style="vertical-align:top;width: 25%;"|
{|
| [[File:caption_7.png|40x40px]] || Video menu (for DVD iso)
|-
| [[File:caption_8.png|40x40px]] || Lock screen
|-
| [[File:caption_9.png|40x40px]] || Elapsed time
|-
| [[File:caption_10.png|40x40px]] || Seek bar
|-
| [[File:caption_11.png|40x40px]] || Total time / Remaining time
|-
|style="vertical-align:top;"| [[File:caption_12.png|40x40px]] || Advanced Options
* Playback Speed
* Sleep timer
* Jump to specific time
* Add subtitle
|}
|}

Some precisions:
* You can change audio and/or subtitle track if there are any. If not, these icons won't be displayed.
* The Video Menu icon is only displayed for iso video (a DVD iso for example)

 

=== Video playback gesture ===

{|style="width: 50%;"|
|[[File:Android_VideoPlayer_Gesture.jpg|550x550px]]
|style="vertical-align:top;width: 25%;"|
{|
|[[File:caption_1.png|40x40px]] || Adjust Brightness
|-
|[[File:caption_2.png|40x40px]] || Adjust Volume
|-
|[[File:caption_3.png|40x40px]] || Quick search
|}
|}

 

== Playing Audio ==
TODO

* You can change the time display to remaining time (e.g. -1:30 for 1:30 minutes remaining) in the audio player by tapping on the current time label in the left.

== Settings ==

== See Also ==

[[AndroidFAQ]] 
[[Android Checklist]] 
[[Android Player Intents]] 
[[Android Report bugs]] 

[[Category:Mobile documentation]]
[[Category:Android]]

Template:ARC

2018-04-06T13:31:17Z

Dekans: Created page with "style="background: #ffbbbb" | ARC"

style="background: #ffbbbb" | ARC

AndroidCompile

2018-03-01T12:40:15Z

Dekans: /* Building */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Build LibVLC ====

To build LibVLC, simply pass the -l option:
sh compile.sh -l -a <ABI> -r

.aar archive will be located in libvlc/build/outputs/aar/

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2018-02-16T17:07:04Z

Dekans: /* Compile */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2018-01-23T10:38:59Z

Dekans: /* Example on Ubuntu */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-07-31T11:48:54Z

Dekans: /* Setup Gradle build system */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-07-31T11:47:15Z

Dekans: /* Compile */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and '''unsigned''') package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-07-03T13:33:28Z

Dekans: /* Android NDK */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK/IDE page].
# Android Studio is recommended, but not mandatory!
# Download the command-line tools

mkdir android-sdk
cd android-sdk; unzip tools_r25.2.3-linux.zip
./tools/bin/sdkmanager --update

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [https://developer.android.com/ndk/downloads/index.html Android NDK page] and download the '''NDK r14b''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-02-08T10:44:56Z

Dekans: /* Requirements */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

Precise lists of tools dependencies is listed [https://git.videolan.org/?p=vlc.git;a=blob;f=extras/tools/bootstrap;h=e60e5ebf93e69e7bb731e80d0fbc6ebd1226dfdb;hb=HEAD#l73 here].

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-02-01T16:49:44Z

Dekans: /* Gradle tweaks */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project.
Or directly in your ~/.gradle/gradle.properties
org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-02-01T16:47:15Z

Dekans: Add some gradle tweaks

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

==== Gradle tweaks ====

org.gradle.parallel=true
org.gradle.configureondemand=true
# If you have a BUNCH of RAM available
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx2048M

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-01-09T14:05:51Z

Dekans: /* Android NDK */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Just run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you are able to build from Android Studio with '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2016-09-30T16:14:34Z

Dekans: Note for Ubuntu 15.04 is outdated

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r12''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Just run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you are able to build from Android Studio with '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Player Intents

2016-06-29T10:24:41Z

Dekans: Add position description

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "position" || int/long || Set position to start playback, in milliseconds
|-
| "extra_duration" || long || Media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndTypeAndNormalize(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("position", 90000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

==Extras==
{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "extra_position" || long || Last position in media when player exited
|-
| "extra_duration" || long || Total duration of the media

|}

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Player Intents

2016-06-29T10:23:46Z

Dekans: add 'position' intent

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "extra_duration" || long || Media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndTypeAndNormalize(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("position", 90000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

==Extras==
{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "extra_position" || long || Last position in media when player exited
|-
| "extra_duration" || long || Total duration of the media

|}

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Checklist

2016-04-01T16:42:48Z

Dekans: /* This page is intended to list all VLC Android app features we have to set before every release. */

== VLC for Android features checklist ==

==== This page is intended to list all VLC Android app features we have to set before every release. ====

General
* Black Theme
* General display with system fonts set to large
* Search

Video
* Second screen mode in video player
* Background video playback
* Restore video playback after pressing HOME
* Video playlist
* Subtitles picker
* video popup
* Audio/Video transition

Audio
* Audio playback
* Remote controls
* Audio playlists

Browsing
* Local browsing
* Network browsing
* Network favorites
* Network playback
* Network login

Other
* Compatibility with Android 2.x
* Playback history
* Open media from 3rd party Apps

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Android]]

Android Checklist

2016-04-01T16:41:33Z

Dekans: First commit

== VLC for Android features checklist ==

==== This page is intended to list all VLC Android app features we have to set before every release. ====

General
* Black Theme
* General display with system fonts set to large
* Search

Video
* Second screen mode in video player
* Background video playback
* Restore video playback after pressing HOME
* Video playlist
* Subtitles picker
* video popup
* Audio/Video transition

Audio
* Audio playback
* Remote controls
* Audio playlists

Browsing
* Local browsing
* Network browsing
* Network favorites
* Network playback
* Network login

Other
* Playback history
* Open media from 3rd party Apps

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Android]]

Android Player Intents

2016-03-24T09:32:59Z

Dekans:

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "extra_duration" || long || Media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

==Extras==
{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "extra_position" || long || Last position in media when player exited
|-
| "extra_duration" || long || Total duration of the media

|}

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Player Intents

2016-03-24T09:30:06Z

Dekans: /* Extras (optional) */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "extra_duration" || long || Media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

==Extras==
{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "extra_position" || long || Last position in media when player exited
|-
| "extra_duration" || long || Total duration of the media

|}

Android Player Intents

2016-03-24T09:29:50Z

Dekans:

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "extra_duration" || long || media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

==Extras==
{| class="wikitable"
|-
! Value !! Type !! Description
|-
| "extra_position" || long || Last position in media when player exited
|-
| "extra_duration" || long || Total duration of the media

|}

Android Player Intents

2016-03-24T09:26:43Z

Dekans: /* Extras (optional) */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==

{| class="wikitable"
|-
! value !! type !! Description
|-
| "subtitles_location" || String || Path of a subtitles file
|-
| "title" || String || Title you want to display
|-
| "from_start" || boolean || Force playback from the beginning
|-
| "extra_duration" || long || media duration
|}

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Player Intents

2016-03-24T09:22:15Z

Dekans: /* Sample code */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)
* "title": title you want to display (type String)
* "from_start": Force playback from the beginning (type boolean)
* "extra_duration": media duration (type long)

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Player Intents

2016-03-24T09:21:58Z

Dekans: /* Extras (optional) */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)
* "title": title you want to display (type String)
* "from_start": Force playback from the beginning (type boolean)
* "extra_duration": media duration (type long)

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("opened_position", 270000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Player Intents

2016-03-11T18:29:43Z

Dekans: /* Extras (optional) */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)
* "title": title you want to display (type String)
* "from_start": Force playback from the beginning (type boolean)
* "opened_position": position in the media, in ms (type long)
* "extra_duration": media duration (type long)

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("opened_position", 270000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Player Intents

2016-03-11T18:28:04Z

Dekans: /* Extras */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)
* "title": title you want to display (type String)

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("opened_position", 270000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Player Intents

2016-03-11T18:27:44Z

Dekans: /* Sample code */

=Open a media with VLC Player=
To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== data ==
The media Uri

== type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)
* "title": title you want to display (type String)

== Sample code ==
For a simple media playback:
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("title", "Kung Fury");
vlcIntent.putExtra("from_start", false);
vlcIntent.putExtra("opened_position", 270000l);
vlcIntent.putExtra("subtitles_location", "/sdcard/Movies/Fifty-Fifty.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

If you specifically want start VideoPlayerActivity, you can set
vlcIntent.setComponent(new ComponentName("org.videolan.vlc", "org.videolan.vlc.gui.video.VideoPlayerActivity"));

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

==Extras==
* "extra_position": position in the media, in ms (type long)
* "extra_duration": media duration (type long)

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].

Android Report bugs

2016-01-27T11:11:37Z

Dekans: /* What you have to do */

[[File:VLC Android Crash.png|thumb|right|VLC for Android has crashed]]

{{howto|report Android bugs}}

=Are you sure it's a ''true'' bug?=
Well, you know the old adage: ''"Have you tried turning it off and on again?"''

Don't be mistaken - we believe you but sometimes, it is truly not our fault... So before becoming grumpy, try these steps:
* Restart your Android device, then relaunch VLC.
* Still getting the bug? Try to uninstall and re-install VLC.

The bug is definitely still there? Now you can keep reading this page...

=What you have to do=
If you want to help us solve an issue you experience on VLC for Android, we need to know a few things:
* your exact device name (go to '''Settings > About Phone > Model Number''')
* your Android version (go to '''Settings > About Phone > Android Version''')
* your VLC version (go to '''VLC > Options > About''')
* a log file (see below)
* whether the issue occurs only on one media (video or music) or all of them
* location to a sample, a screenshot, etc...

If you were asked to do this by a developer from [https://forum.videolan.org/ the VideoLAN forum], then please respond with this information in the same thread.

If not, send us this information at '''[mailto:videolan.android@gmail.com videolan.android@gmail.com]'''.

However, if you are competent enough, feel free to create a report on the [https://trac.videolan.org/vlc/ VLC bug tracker]. Please note that any tickets which do not follow the standards for bug reporting ''will be closed'' systematically.

=How to find the log file?=
==If VLC for Android crashes==
Normally, when VLC for Android crashes it will leave behind a '''vlc_logcat_'''''<date and some numbers>'''''.log''' file in your '''SD card's root'''.

You can then retrieve this to your computer using the file transfer mechanism offered by your device (e.g. Mass storage, etc). Or, you can use [http://www.openintents.org/en/filemanager OI File Manager] (open source file browser) to view and manipulate the file (e.g. move it to a folder where it's uploadable to PC).

Then, send us this ''vlc_logcat_<...>.log'' file.

If you do not find any log in the form of ''vlc_logcat_<...>.log'', then you probably have a native crash. See below for details on native crashes.
[[File:VLC_Android_Logcat_File.png|thumb|center|200px|Log files in your SD card's root]]

==Playback issues where VLC does not crash==
If VLC does not crash, you have to manually create a log file.

# Ensure VLC is completely closed by force-stopping it in Android settings.
# Start VLC.
# Go to '''Settings → Developer''' (at the very bottom) '''→ Debug logs''', and tap '''Start logging'''.
# Play the media file in question and/or try to reproduce the issue.
# Once you are done playing the file, go back to the '''Debug logs''' screen. You can find the log in this screen. To retrieve it, copy it to the Android clipboard and paste it on a mail for example.
# Or dump this log by pressing '''Dump Logcat Log''' and send the generated file by mail.
# You can also paste it on any [http://pastebin.com/ pastebin] site or however you wish and send us the link.
# Press '''Stop logging''' to end the debugging session and return to normal usage.

And that's it.

==User interface issues==
Go to '''Preferences''' → '''Advanced debugging''' → '''dump logcat''' and upload the provided file.

==Advanced users or developers==
However, in some cases (such as on certain Huawei phones who use a non-standard implementation of Logcat) you will need access to a computer and enable adb debugging. To do this, first ADB debugging must be enabled - '''Settings → Developer options → USB debugging''', or on older phones, '''Settings → Applications → Development → USB debugging'''. In both cases, ensure that the option is checked.

An easier approach might be to install [https://github.com/jackpal/Android-Terminal-Emulator/wiki Terminal (a.k.a. Term.apk)] if you haven't already. Open Terminal and clear the logcat buffer with <code>logcat -c</code>. Then, re-open VLC and try to make it crash. Once it crashes, then re-open Terminal and type in letter-for-letter, case sensitive: <code>cd /sdcard && logcat -d > log.txt</code> into the terminal, and hit Enter. Pull the file "log.txt" under the SD card to your PC and pastebin.

The normal developers' approach is to [http://developer.android.com/sdk/installing/index.html install the Android SDK] and run <code>adb logcat -d > log.txt</code>, then pastebin the log.txt.

==Native crashes (advanced stuff)==
Sometimes, you might asked by one of the developers for a '''backtrace''', or '''native trace'''. If so, then please see [[AndroidCompile#Native debugging]].

[[Category:Android]]

Android Report bugs

2016-01-27T11:11:12Z

Dekans: email address update

[[File:VLC Android Crash.png|thumb|right|VLC for Android has crashed]]

{{howto|report Android bugs}}

=Are you sure it's a ''true'' bug?=
Well, you know the old adage: ''"Have you tried turning it off and on again?"''

Don't be mistaken - we believe you but sometimes, it is truly not our fault... So before becoming grumpy, try these steps:
* Restart your Android device, then relaunch VLC.
* Still getting the bug? Try to uninstall and re-install VLC.

The bug is definitely still there? Now you can keep reading this page...

=What you have to do=
If you want to help us solve an issue you experience on VLC for Android, we need to know a few things:
* your exact device name (go to '''Settings > About Phone > Model Number''')
* your Android version (go to '''Settings > About Phone > Android Version''')
* your VLC version (go to '''VLC > Options > About''')
* a log file (see below)
* whether the issue occurs only on one media (video or music) or all of them
* location to a sample, a screenshot, etc...

If you were asked to do this by a developer from [https://forum.videolan.org/ the VideoLAN forum], then please respond with this information in the same thread.

If not, send us this information at '''[mailto:videolan.android@gmail.com videolan.mobile@gmail.com]'''.

However, if you are competent enough, feel free to create a report on the [https://trac.videolan.org/vlc/ VLC bug tracker]. Please note that any tickets which do not follow the standards for bug reporting ''will be closed'' systematically.

=How to find the log file?=
==If VLC for Android crashes==
Normally, when VLC for Android crashes it will leave behind a '''vlc_logcat_'''''<date and some numbers>'''''.log''' file in your '''SD card's root'''.

You can then retrieve this to your computer using the file transfer mechanism offered by your device (e.g. Mass storage, etc). Or, you can use [http://www.openintents.org/en/filemanager OI File Manager] (open source file browser) to view and manipulate the file (e.g. move it to a folder where it's uploadable to PC).

Then, send us this ''vlc_logcat_<...>.log'' file.

If you do not find any log in the form of ''vlc_logcat_<...>.log'', then you probably have a native crash. See below for details on native crashes.
[[File:VLC_Android_Logcat_File.png|thumb|center|200px|Log files in your SD card's root]]

==Playback issues where VLC does not crash==
If VLC does not crash, you have to manually create a log file.

# Ensure VLC is completely closed by force-stopping it in Android settings.
# Start VLC.
# Go to '''Settings → Developer''' (at the very bottom) '''→ Debug logs''', and tap '''Start logging'''.
# Play the media file in question and/or try to reproduce the issue.
# Once you are done playing the file, go back to the '''Debug logs''' screen. You can find the log in this screen. To retrieve it, copy it to the Android clipboard and paste it on a mail for example.
# Or dump this log by pressing '''Dump Logcat Log''' and send the generated file by mail.
# You can also paste it on any [http://pastebin.com/ pastebin] site or however you wish and send us the link.
# Press '''Stop logging''' to end the debugging session and return to normal usage.

And that's it.

==User interface issues==
Go to '''Preferences''' → '''Advanced debugging''' → '''dump logcat''' and upload the provided file.

==Advanced users or developers==
However, in some cases (such as on certain Huawei phones who use a non-standard implementation of Logcat) you will need access to a computer and enable adb debugging. To do this, first ADB debugging must be enabled - '''Settings → Developer options → USB debugging''', or on older phones, '''Settings → Applications → Development → USB debugging'''. In both cases, ensure that the option is checked.

An easier approach might be to install [https://github.com/jackpal/Android-Terminal-Emulator/wiki Terminal (a.k.a. Term.apk)] if you haven't already. Open Terminal and clear the logcat buffer with <code>logcat -c</code>. Then, re-open VLC and try to make it crash. Once it crashes, then re-open Terminal and type in letter-for-letter, case sensitive: <code>cd /sdcard && logcat -d > log.txt</code> into the terminal, and hit Enter. Pull the file "log.txt" under the SD card to your PC and pastebin.

The normal developers' approach is to [http://developer.android.com/sdk/installing/index.html install the Android SDK] and run <code>adb logcat -d > log.txt</code>, then pastebin the log.txt.

==Native crashes (advanced stuff)==
Sometimes, you might asked by one of the developers for a '''backtrace''', or '''native trace'''. If so, then please see [[AndroidCompile#Native debugging]].

[[Category:Android]]

AndroidCompile

2015-12-23T14:53:06Z

Dekans: /* Example on Ubuntu */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

Note : VLC requires gettext version 0.19.3, but Ubuntu version '''15.04 (Vivid Vervet)''' provides version 0.19.2

To build VLC with this release, either build your own gettext from sources, or
edit vlc/contrib/contrib-tizen-arm-linux-gnueabi/libgpg-error/configure.ac, line 158 and change version 0.19.3 to version 0.19.2

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r10e''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Just run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you are able to build from Android Studio with '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2015-12-07T12:48:18Z

Dekans: Update git repo url

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

Note : VLC requires gettext version 0.19.3, but Ubuntu version '''15.10 (Wily Werewolf)''' provides version 0.19.2

To build VLC with this release, either build your own gettext from sources, or
edit vlc/contrib/contrib-tizen-arm-linux-gnueabi/libgpg-error/configure.ac, line 158 and change version 0.19.3 to version 0.19.2

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r10e''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Just run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you are able to build from Android Studio with '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2015-09-11T11:38:35Z

Dekans: /* Example on Ubuntu */

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

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

Note : VLC requires gettext version 0.19.3, but Ubuntu version '''15.10 (Wily Werewolf)''' provides version 0.19.2

To build VLC with this release, either build your own gettext from sources, or
edit vlc/contrib/contrib-tizen-arm-linux-gnueabi/libgpg-error/configure.ac, line 158 and change version 0.19.3 to version 0.19.2

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

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 the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r10e''' for Linux.
# Decompress it to install

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

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

In your ''android'' source folder, run:

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

==== Setup Gradle build system ====

Just run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you are able to build from Android Studio with '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

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

'''Note:''' At this point, you will get an release APK in the same folder.

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

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

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

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

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

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Android Player Intents

2015-06-17T12:23:44Z

Dekans: Add subs extra

=Open a media with VLC Player=

To play a media with VLC player, use an intent with the following settings

== action ==
Intent.ACTION_VIEW ("android.intent.action.VIEW")

== Package name ==
"org.videolan.vlc"

== Data ==
The media Uri

== Type ==
one of:

* video/*
* audio/*
* */rmvb
* */avi
* */mkv
* application/3gpp*
* application/mp4
* application/mpeg*
* application/ogg
* application/sdp
* application/vnd.3gp*
* application/vnd.apple.mpegurl
* application/vnd.dvd*
* application/vnd.dolby*
* application/vnd.rn-realmedia*
* application/x-iso9660-image
* application/x-extension-mp4
* application/x-flac
* application/x-matroska
* application/x-mpegURL
* application/x-ogg
* application/x-quicktimeplayer
* application/x-shockwave-flash
* application/xspf+xml
* misc/ultravox

== Extras (optional) ==
* "position": position in the media, in ms (type long)
* "subtitles_location": path of a subtitles file (type String)

== Sample code ==
int vlcRequestCode = 42;
Uri uri = Uri.parse("file:///storage/emulated/0/Movies/KUNG FURY Official Movie.mp4");
Intent vlcIntent = new Intent(Intent.ACTION_VIEW);
vlcIntent.setPackage("org.videolan.vlc");
vlcIntent.setDataAndType(uri, "video/*");
vlcIntent.putExtra("position", 1354000l);
vlcIntent.putExtra("subtitles_location", "/storage/emulated/0/Movies/subs.srt");
startActivityForResult(vlcIntent, vlcRequestCode);

=Get result code from VLC=
Since version 1.4.1, Android VLC application returns an intent when closing.

Here is the description of this intent:

==Intent action==
"org.videolan.vlc.player.result"

==Result code==
{| class="wikitable"
|-
! Result !! Value (int) !! Description
|-
| RESULT_OK || -1 || Video finished or user ended playback
|-
| RESULT_CANCELED || 0 || No compatible cpu, incorrect VLC abi variant installed
|-
| RESULT_CONNECTION_FAILED || 2 || Connection failed to audio service
|-
| RESULT_PLAYBACK_ERROR || 3 || VLC is not able to play this file, it could be incorrect path/uri, not supported codec or broken file
|-
| RESULT_HARDWARE_ACCELERATION_ERROR || 4 || Error with hardware acceleration, user refused to switch to software decoding
|-
| RESULT_VIDEO_TRACK_LOST || 5 || VLC continues playback, but for audio track only. (Audio file detected or user chose to)
|}

==Data==
Media Uri

==Extras==

* "extra_position": position in the media, in ms (type long)
* "extra_duration": media duration (type long)

You can check the source [http://git.videolan.org/?p=vlc-ports/android.git;a=blob;f=vlc-android/src/org/videolan/vlc/gui/video/VideoPlayerActivity.java;hb=HEAD here].