h1. Android

Major OpenCV4Android page {{>toc}}

Android is here: http://opencv.alekcac.webfactional.com/android.html. 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. Submitting a bug

Did 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 do can run on your homework? Let's check it:

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 check note, that this is not recommended way and think [[AndroidWays|twice]] before you use checkout the "latest version":http://opencv.alekcac.webfactional.com/downloads.html of OpenCV4Android. OpenCV sources.

h2. Getting help

h3. User Communities

* Android-OpenCV group: https://groups.google.com/group/android-opencv (for Android-specific questions)
# Please * 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.
# Ask "community":https://groups.google.com/group/android-opencv about your problem.

* Issue tracker: http://code.opencv.org (you're already here). If you submit a ticket, please provide the correct "Category" name - @android@. @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. Developer documentation

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

h2. Deprecated pages

* "OpenCV4Android 2.2":http://opencv.willowgarage.com/wiki/Android2.2 - These are the instructions if you are building against the 2.2 release of OpenCV.
* "OpenCV4Android 2.3.0":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