OpenCV4Android
Version 1 (Alexander Smorkalov, 2013-03-04 08:30 am)
| 1 | 1 | h1. Android |
|
|---|---|---|---|
| 2 | 1 | ||
| 3 | 1 | {{>toc}} |
|
| 4 | 1 | ||
| 5 | 1 | 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! |
|
| 6 | 1 | ||
| 7 | 1 | Read our [[Android Release Notes]] to see what's new for Android developers in OpenCV. |
|
| 8 | 1 | ||
| 9 | 1 | h2. Resources |
|
| 10 | 1 | ||
| 11 | 1 | * 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!)* |
|
| 12 | 1 | * User Communities: |
|
| 13 | 1 | ** Android-OpenCV group: https://groups.google.com/group/android-opencv (for Android-specific questions) |
|
| 14 | 1 | ** General OpenCV group: http://tech.groups.yahoo.com/group/OpenCV (for general OpenCV questions and discussions) |
|
| 15 | 1 | * Contacts |
|
| 16 | 1 | ** Email: [email protected] *(please use the Anroid-OpenCV group first of all, information should be available to everybody)* |
|
| 17 | 1 | ** Twitter: http://twitter.com/AndroidOpenCV |
|
| 18 | 1 | * OpenCV documentation: |
|
| 19 | 1 | ** Latest (updated daily): http://opencv.itseez.com/trunk |
|
| 20 | 1 | ** 2.4.0: http://opencv.itseez.com |
|
| 21 | 1 | ** C++ cheatsheet: http://code.opencv.org/trac/opencv/browser/trunk/opencv/doc/opencv_cheatsheet.pdf |
|
| 22 | 1 | * Issue tracker: http://code.opencv.org (read-only old Trac https://code.ros.org/trac/opencv/wiki). |
|
| 23 | 1 | 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: |
|
| 24 | 1 | ** Version number of Android platform (all 3 components of the version - for example: 2.2.1); |
|
| 25 | 1 | ** Exact CPU model of your device ("@adb shell cat /proc/cpuinfo@" command); |
|
| 26 | 1 | ** Output of "@adb logcat@" command; |
|
| 27 | 1 | ** Name of a sample if the problem is reproducible for any of the samples included into the binary package. |
|
| 28 | 1 | ||
| 29 | 1 | h2. Download |
|
| 30 | 1 | ||
| 31 | 1 | Developers have [[AndroidWays|2 basic ways]] to develop applications with OpenCV on Android. |
|
| 32 | 1 | # 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. This package contains Eclipse library project and [[AndroidSamples|samples]]. |
|
| 33 | 1 | 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. |
|
| 34 | 1 | # 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. |
|
| 35 | 1 | ||
| 36 | 1 | h2. Known problems |
|
| 37 | 1 | ||
| 38 | 1 | * "Android Issues on the OpenCV bug tracker":http://code.opencv.org/projects/opencv/issues?query_id=4 |
|
| 39 | 1 | ||
| 40 | 1 | h1. Actual instructions |
|
| 41 | 1 | ||
| 42 | 1 | * "Using Android binary package with Eclipse":http://opencv.itseez.com/doc/tutorials/introduction/android_binary_package/android_binary_package.html *(recommended)* |
|
| 43 | 1 | * "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) |
|
| 44 | 1 | * [[Trunk OpenCV for Android|OpenCV Trunk]] - These are the bleeding edge trunk instructions |
|
| 45 | 1 | ||
| 46 | 1 | * [[AndroidSamples|Android Samples]] |
|
| 47 | 1 | * [[AndroidBestPractices|Android Best Practices]] |
|
| 48 | 1 | ||
| 49 | 1 | h1. Deprecated |
|
| 50 | 1 | ||
| 51 | 1 | * "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. |
|
| 52 | 1 | * "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. |
|
| 53 | 1 | * "Build Android NDK application with prebuilt OpenCV 2.3.0 alpha":http://opencv.willowgarage.com/wiki/AndroidPrebuiltOpenCV230 |
|
| 54 | 1 | * "Prebuilt OpenCV 2.3.1 Package instruction on old wiki":http://opencv.willowgarage.com/wiki/AndroidPrebuiltOpenCV231 |
|
| 55 | 1 | ||
| 56 | 1 | * "How to build Android NDK application with prebuilt OpenCV":http://opencv.willowgarage.com/wiki/OpenCVAndroidBinariesBuild |
|
| 57 | 1 | * "AndroidExperimental":http://opencv.willowgarage.com/wiki/AndroidExperimental - This is temporary page describing how to build OpenCV with a stanalone toolchain |