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