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

Read our [[Android Release Notes]]. Notes]] to see what's new for Android developers in OpenCV.

h2. How Resources

* Quick Start Tutorial: "Using Android binary package with Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html *(start from here!)*
* 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)
* Contacts
** Email: [email protected] *(please use the Anroid-OpenCV group first of all, information should be available to start

everybody)*
** Twitter: http://twitter.com/AndroidOpenCV
* OpenCV documentation:
** Latest (updated daily): http://opencv.itseez.com/trunk
** 2.4.0: http://opencv.itseez.com
** C++ cheatsheet: http://code.opencv.org/trac/opencv/browser/trunk/opencv/doc/opencv_cheatsheet.pdf
* Issue tracker: http://code.opencv.org (read-only old Trac https://code.ros.org/trac/opencv/wiki).
If you submit a ticket, please provide the correct "component" 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.

h2. Download

Developers have [[AndroidWays|2 basic ways]] to develop applications with the OpenCV4Android: OpenCV on Android.
# 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)*. Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html. 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

Known problems

* Android-OpenCV group: https://groups.google.com/group/android-opencv (for Android-specific questions)
* General "Android Issues on the OpenCV group: http://tech.groups.yahoo.com/group/OpenCV (for general OpenCV questions and discussions) bug tracker":http://code.opencv.org/projects/opencv/issues?query_id=4

h3. OpenCV documentation h1. Actual instructions

* Latest (updated daily): http://opencv.itseez.com/trunk
* 2.4.0: http://opencv.itseez.com
* C++ cheatsheet: http://code.opencv.org/trac/opencv/browser/trunk/opencv/doc/opencv_cheatsheet.pdf

h3. OpenCV4Android documentation

* "Using Android binary package with Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html
*(recommended)*
* "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)
* [[Trunk OpenCV for Android|OpenCV Trunk]] - These are the bleeding edge trunk instructions


* [[AndroidSamples|Android Samples]]
* [[AndroidBestPractices|Android Best Practices]]

h2. Providing feedback

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

* 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
** Email: [email protected] *(please use the Anroid-OpenCV group first of all, information should be available to everybody)*
** Twitter: http://twitter.com/AndroidOpenCV

h2. h1. 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