Chiebot-Mirror
/
opencv
mirror of https://github.com/opencv/opencv.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity

Removed outdated build instructions

Browse Source
pull/13383/head
Andrey Kamaev 14 years ago
parent 6aea54e308
commit 039c35e2e7
2 changed files with 1 additions and 233 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 78
      android/README.android.txt
  2. 156
      android/android.wiki

78
android/README.android.txt
Unescape View File

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

156
android/android.wiki
Unescape View File

@ -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.
Write Preview
Loading…
Cancel
Save