h1. Android

{{>toc}}

Android is awesome, and so is OpenCV, so wouldn't it be awesomer if they could work together? Well they can, and its now officially supported in OpenCV! See the [[Android Release Notes]].

h2. How to start

Developers have [[AndroidWays|2 basic ways]] to develop applications with the OpenCV4Android:
# We recommend to download the "prebuilt OpenCV package":http://sourceforge.net/projects/opencvlibrary/files/opencv-android and follow the instructions from our tutorial: "Using Android binary package with Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html *(start from here)*. This package contains Eclipse library project and [[AndroidSamples|samples]]. Package also includes prebuilt apk-files, which you can run on your device immediately. They are placed at @OpenCV-2.4.0/bin@ folder inside the binary package.
# You can build OpenCV from sources and have the full control over the library. See the [[Trunk OpenCV for Android|OpenCV trunk for Android]] page for instructions. Please note, that this is not recommended way and think [[AndroidWays|twice]] before you checkout the OpenCV sources.

h2. Getting help

h3. User Communities

* Android-OpenCV group: https://groups.google.com/group/android-opencv (for Android-specific questions)
* General OpenCV group: http://tech.groups.yahoo.com/group/OpenCV (for general OpenCV questions and discussions)

h3. OpenCV4Android documentation

* Javadoc html-files are included into the binary package.
* Tutorials and samples:
** "Using Android binary package with Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html
** "Using C++ OpenCV code with Android binary package":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package_using_with_NDK.html (advanced guide for NDK developers)
** [[AndroidSamples|Android Samples]]

* [[AndroidBestPractices|Android Best Practices]]
* [[Trunk OpenCV for Android|OpenCV Trunk]] - These are the bleeding edge trunk instructions

h3. OpenCV documentation

Pay special attention to the tutorials! http://docs.opencv.org/doc/tutorials/tutorials.html

* Latest (updated daily): http://docs.opencv.org/trunk
* 2.4.0: http://docs.opencv.org
* C++ cheatsheet: source:trunk/opencv/doc/opencv_cheatsheet.pdf

h2. Providing feedback

You know, we love [[How_to_contribute|contributions]]! And please check the open "Android issues":http://code.opencv.org/projects/opencv/issues?query_id=4 on the bug tracker.

* Issue tracker: http://code.opencv.org (you're already here). If you submit a ticket, please provide the correct "Category" name - @android@). If you could not identify the cause of the error, please provide the following information in your ticket:
** Version number of Android platform (all 3 components of the version - for example: 2.2.1);
** Exact CPU model of your device ("@adb shell cat /proc/cpuinfo@" command);
** Output of "@adb logcat@" command;
** Name of a sample if the problem is reproducible for any of the samples included into the binary package.

* Contacts
** Android-OpenCV group: https://groups.google.com/group/android-opencv
** Email: [email protected] *(please use the Anroid-OpenCV group first of all, we do not provide private consultancy)*
** Twitter: http://twitter.com/OpenCV4Android http://twitter.com/AndroidOpenCV

h2. Deprecated pages

* "OpenCV 2.2 for Android":http://opencv.willowgarage.com/wiki/Android2.2 - These are the instructions if you are building against the 2.2 release of OpenCV.
* "OpenCV 2.3.0 for Android":http://opencv.willowgarage.com/wiki/Android2.3.0 - These are the instructions if you are building against the 2.3.0 release of OpenCV.
* "Build Android NDK application with prebuilt OpenCV 2.3.0 alpha":http://opencv.willowgarage.com/wiki/AndroidPrebuiltOpenCV230
* "Prebuilt OpenCV 2.3.1 Package instruction on old wiki":http://opencv.willowgarage.com/wiki/AndroidPrebuiltOpenCV231

* "How to build Android NDK application with prebuilt OpenCV":http://opencv.willowgarage.com/wiki/OpenCVAndroidBinariesBuild
* "AndroidExperimental":http://opencv.willowgarage.com/wiki/AndroidExperimental - This is temporary page describing how to build OpenCV with a stanalone toolchain