Removed outdated build instructions
This commit is contained in:
Andrey Kamaev
parent
6aea54e308
commit
039c35e2e7
@ -1,77 +1 @@
|
||||
Author: Ethan Rublee
|
||||
email: ethan.rublee@gmail.com
|
||||
########################################################
|
||||
Prerequisites:
|
||||
########################################################
|
||||
android-ndk-r5b http://developer.android.com/sdk/ndk/index.html
|
||||
the official ndk with standalone toolchain
|
||||
android-cmake http://code.google.com/p/android-cmake/
|
||||
this is for the cmake toolchain for android
|
||||
mercurial
|
||||
sudo apt-get install mercurial
|
||||
cmake
|
||||
opencv (you should have this if you're reading this file :)
|
||||
|
||||
########################################################
|
||||
Quick NDK Setup(ubuntu and bash):
|
||||
########################################################
|
||||
create some working directory:
|
||||
WORK=$HOME/android_dev
|
||||
cd $WORK
|
||||
|
||||
now get the android-cmake project with mercurial
|
||||
hg clone https://android-cmake.googlecode.com/hg/ android-cmake
|
||||
|
||||
there is a convenience script in there for pulling down and setting up the
|
||||
android ndk as a standalone toolchain
|
||||
cd android-cmake/scripts
|
||||
./get_ndk_toolchain_linux.sh $WORK
|
||||
|
||||
add the cmake toolchain location to your bashrc or otherwise export it to your env
|
||||
echo export ANDTOOLCHAIN=$WORK/android-cmake/toolchain/android.toolchain.cmake >> $HOME/.bashrc
|
||||
|
||||
########################################################
|
||||
Quick opencv build(ubuntu and bash):
|
||||
########################################################
|
||||
Make sure you either source your bashrc or otherwise export the ANDTOOLCHAIN variable.
|
||||
|
||||
There is a script in the android folder for running cmake with the proper cache
|
||||
variables set. It is recommended that you use this to setup a smake build directory.
|
||||
cd opencv/android
|
||||
sh ./cmake_android.sh
|
||||
|
||||
You should now see a build directory, that is ready to be made.
|
||||
cd build
|
||||
make -j8
|
||||
|
||||
That will build most of the opencv modules, except for those that don't make sense
|
||||
on android - gpu, etc..
|
||||
|
||||
To install to the toolchain:
|
||||
make install
|
||||
########################################################
|
||||
Using opencv in you're cmake own projects.
|
||||
########################################################
|
||||
Use the cmake find script for opencv:
|
||||
find_package(OpenCV REQUIRED)
|
||||
|
||||
Then when you run cmake, use:
|
||||
cmake -DCMAKE_TOOLCHAIN_FILE=$ANDTOOLCHAIN ..
|
||||
|
||||
And direct your cmake cache for OpenCV_Dir to the path that you build opencv for android.
|
||||
something like : opencv/android/build
|
||||
|
||||
To avoid setting the cmake cache for OpenCV_Dir, you can just "install" opencv to your
|
||||
android toolchain. Run the following from the opencv/android/build path:
|
||||
make install
|
||||
|
||||
########################################################
|
||||
android targets
|
||||
########################################################
|
||||
You may wish to build android for multiple hardware targets.
|
||||
|
||||
Just change the cmake cache ARM_TARGETS to either:
|
||||
"armeabi" "armeab-v7a" "armeab-v7a with NEON"
|
||||
|
||||
You may install each of these to the toolchain, and they should be linked against
|
||||
properly via way of the android-cmake toolchain.
|
||||
See http://opencv.willowgarage.com/wiki/AndroidTrunk
|
||||
@ -1,156 +0,0 @@
|
||||
= Android =
|
||||
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 trunk.
|
||||
= quick ubuntu opencv static libs build =
|
||||
* install swig {{{sudo apt-get install swig}}}
|
||||
* unzip the crystax ndk r4 to your home directory http://www.crystax.net/android/ndk-r4.php
|
||||
* svn up your opencv - from https://code.ros.org/svn/opencv/trunk/opencv
|
||||
{{{
|
||||
cd opencv/android
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ..
|
||||
make
|
||||
}}}
|
||||
= Prerequisites =
|
||||
* swig 1.3 - stable version in your package manager or from cygwin or from http://swig.org/
|
||||
* crystax ndk r4 - http://www.crystax.net/android/ndk-r4.php - unzip/untar to your home directory for easy cmake locating
|
||||
* android sdk latest - http://developer.android.com/sdk/index.html
|
||||
* ant build system - for compiling android apps on command line
|
||||
* (optional) eclipse android sdk adt plugin and eclipse cdt http://developer.android.com/sdk/eclipse-adt.html
|
||||
* latest code from opencv svn trunk - from https://code.ros.org/svn/opencv/trunk/opencv
|
||||
= android ndk =
|
||||
This will not work with the official release of the android ndk.
|
||||
The official android ndk does not support c++ concepts fully like RTTI, exceptions, and most of the stl.
|
||||
Make sure you use the modified android ndk from crystax available at http://www.crystax.net/android/ndk-r4.php
|
||||
|
||||
The android ndk, now referred to as the ndk, is the gcc toolchain for android, and is what creates the shared
|
||||
libraries for android that are loadable by android apps through a the Java Native Interface(JNI)
|
||||
|
||||
Recommended install of the ndk is to unzip it to your home directory
|
||||
|
||||
For example this is what mine looks like:
|
||||
{{{
|
||||
erublee@bde:~/android-ndk-r4-crystax$ ls
|
||||
build docs GNUmakefile ndk-build ndk-gdb README.TXT samples sources
|
||||
}}}
|
||||
|
||||
= Android SDK =
|
||||
Please read the very well documented android sdk getting started instructions - http://developer.android.com/sdk/index.html and at least build and install a hello world app on your Android phone.
|
||||
|
||||
== Android SDK tips ==
|
||||
I always add the android sdk tools directory to my path so i can run the adb from any where.
|
||||
|
||||
On ubuntu, add the following to your {{{~/.bashrc}}}
|
||||
{{{
|
||||
export PATH=~/android-sdk-linux_x86/tools:$PATH
|
||||
}}}
|
||||
|
||||
Install ant so that you can build from command line.
|
||||
|
||||
Make sure your udev permissions are set for usb debug and that the phone itself is set to allow debugging
|
||||
http://developer.android.com/guide/developing/device.html#setting-up
|
||||
|
||||
Nexus one users on ubuntu lucid should have the following udev file:
|
||||
|
||||
{{{
|
||||
/etc/udev/rules.d/51-android.rules
|
||||
SUBSYSTEM=="usb", SYSFS{idVendor}=="18d1", MODE="0666"
|
||||
}}}
|
||||
|
||||
see the following blog post on why http://alan.lamielle.net/2010/01/22/nexus-one-usb-in-ubuntu-9-10
|
||||
|
||||
= How and What =
|
||||
The android port involves high jacking the existing cmake build files and replacing the define_opencv_module with android specific build commands.
|
||||
|
||||
In particular the cmake based build creates android ndk build files and calls the android ndk to build opencv.
|
||||
|
||||
== OpenCV static libs ==
|
||||
The main cmake build of opencv generates a static lib for each module and some of the 3rdparty libraries. These can then be linked against in your own android projects.
|
||||
|
||||
the cmake build will also generate an android-opencv.mk file in the build folder. Include this file in your Android.mk files to link against the static libs.
|
||||
|
||||
this would go in your Android.mk file. See the docs in the ndk for an explanation of LOCAL_LDLIBS and LOCAL_C_INCLUDES.
|
||||
{{{
|
||||
#define OPENCV_INCLUDES and OPENCV_LIBS
|
||||
include $(PATH_TO_OPENCV_ANDROID_BUILD)/android-opencv.mk
|
||||
|
||||
LOCAL_LDLIBS += $(OPENCV_LIBS)
|
||||
|
||||
LOCAL_C_INCLUDES += $(OPENCV_INCLUDES)
|
||||
}}}
|
||||
== OpenCV shared library ==
|
||||
There is an attempt at a library that is more generally useful for android that could also be linked against in your on projects. This project is under
|
||||
opencv/android/android-jni
|
||||
|
||||
This uses swig to expose some functions to java. Also it implements a live camera preview interface, so that you can have access to the Android camera for live vision apps.
|
||||
|
||||
== Apps ==
|
||||
A few sample apps that use the library are under opencv/android/apps
|
||||
* CVCamera is a complete example that uses the opencv static libs and the android-jni project
|
||||
* Calibration is a stand alone camera calibration app for your Android that is pure java and links against the android-jni project - use this app to make a camera.yml calibration file in your sdcard's home directory
|
||||
* more to come ...
|
||||
= steps =
|
||||
=== Static libs ===
|
||||
{{{
|
||||
cd opencv/android
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ..
|
||||
make
|
||||
}}}
|
||||
this may take a while
|
||||
=== android-jni ===
|
||||
After the static libs are built, run make in the android-jni folder
|
||||
{{{
|
||||
cd opencv/android/android-jni
|
||||
make
|
||||
}}}
|
||||
That creates the swig wrappers and compiles the shared library.
|
||||
|
||||
now run the ant based java build
|
||||
{{{
|
||||
sh ./project_create.sh
|
||||
ant debug
|
||||
}}}
|
||||
|
||||
Now you're ready to use it in a sample
|
||||
=== CVCamera ===
|
||||
{{{
|
||||
cd opencv/android/apps/CVCamera
|
||||
sh build.sh
|
||||
}}}
|
||||
That builds the swig wrappers and shared library.
|
||||
|
||||
Build the android apk ( the thing that gets installed on the phone )
|
||||
{{{
|
||||
sh project_create.sh
|
||||
ant debug
|
||||
}}}
|
||||
|
||||
Now if everything worked, try to install it. Connect your device and run the following
|
||||
{{{
|
||||
ant install
|
||||
}}}
|
||||
|
||||
Run it, press menu to see options - right now it can draw fast, star, and surf feature points on the live preview image.
|
||||
=== Calibration ===
|
||||
{{{
|
||||
sh project_create.sh
|
||||
ant debug
|
||||
ant install
|
||||
}}}
|
||||
|
||||
To run the app, make sure that the sdcard is not mounted on your computer and point the phone at a calibration pattern and snap away. When you have taken enough chessboards to satisfy yourself
|
||||
press the save button to have the camera calibarted. The calibration will be saved to /sdcard/opencv/calibration.yml
|
||||
|
||||
Also see this app for how to make a slightly nicer camera ui than CVCamera.
|
||||
=== Troubles ===
|
||||
try to edit the local.env.mk file's that get created in CVCamera and android-jni to reflect your system.
|
||||
|
||||
Also using cmake-gui or ccmake are good options to set up where your ndk directory are.
|
||||
|
||||
Send questions/comments to Ethan Rublee ethan.rublee@gmail.com
|
||||
|
||||
= Programming your own apps =
|
||||
Try to look at the samples - like CVCamera, for how to do this. A tutorial may be forth coming.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user