Welcome guys! my goal is to make it easy to create an android CV application with OpenCV libraries.
before starting tutorial its better to know the version of tools that i used!
| Tool | Version |
|---|---|
| OpenCV Android SDK | openCV-3.2.0 |
| Android Studio | v2.2.2 |
| Android SDK build-tools | v25 |
| Android SDK platform-tools | v25.0.3 |
| Android Official NDK | android-ndk-r12b |
- OS: Windows 10 💩
First of all you need to download OpenCv Android SDK and Android Official NDK!
- Extract downloaded NDK in a simple direction without space in dir path! like C:\work\android-ndk-r12b
- Extract extract OpenCV SDK beside NDK folder (technically this direction is Not important! 😄)
-
Right click on This PC and go to Properties find Advanced dystem Settings on right side and open it!
-
In new Window go to Advanced tab and click on Environment Variables.
-
Find PATH variable for current user and click on Edit
-
Click New button in opened window and paste the direction of your java bin folder! like : *C:\Program Files\Java\jdk1.8.0_40\bin*
-
Add the path of NDK like step 4!for NDK you need to add root direction! like : C:\work\android-ndk-r12b
-
Done!
- Open Android Studio and go to Settings
- Go to Appearance & Behavior and click on System settings on opened sublist,and find Android SDK!
- Click on SDK Tools tab and make sure that CMake is install. if not!check it for install!
- Open Android Studio and clcik on New Projcet (its all over and done! 😄)
- Its clear that you need to fill Application Name and Company Domain but most Important Job here is to check Include C++ Support
- Continue like all other default android project and in the last step before click on Finish you need to set your C++ Standard! i use Toolchain Default!
-
if you got an exceptin with this message :
Error:NDK not configured. Download it with SDK manager.)you should follow this steps:- open Project Structure under File tab.
- set you NDK direction in Android NDK location and Done!
- On File menu click on New and click on Import Module!
- Go to
{YOUR_OPENCV_SDK_DIR}\sdk\and select java folder!click on OK! - Click on next then finish.
- Open app level gradle and add this line under dependencies scope:
compile project(':openCVLibrary320')
openCVLibrary320is the name of added module from OpenCV and it may have different name for you!
- Right click on app folder (or its better to say app module) of your project!
- Click on New an go to Folder submenu, select JNI Folder.
- Check Change Folder Location
- Change
src/main/jni/tosrc/main/jniLibs/and click on Finish
You need to add native libraries for different type of proccessors!fortunetly OpenCV provides all of them for you and you can find them under OpenCV SDK directory \sdk\native\libs!
In order to add a specific proccessor's library you just need to copy that folder and paste it under jniLibs folder!
- you can add them all but its better to add what you need specificly!
- Create new File under jniLibs dir and name it
Android.mk! - Copy this lines and paste there:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
OPENCV_LIB_TYPE:=SHARED
OPENCV_CAMERA_MODULES:=on
OPENCV_INSTALL_MODULES:=on
include {OpenCV.mk_DIR}
LOCAL_SRC_FILES := native-lib.cpp
LOCAL_C_INCLUDES += {INCLUDE_DIR}
LOCAL_LDLIBS += -llog -ldl
LOCAL_CFLAGS += -DOPENCV_OLDER_VISION
LOCAL_CPP_FEATURES += exceptions (Recommended)
LOCAL_CPPFLAGS += -fexceptions
LOCAL_MODULE := native-lib
include $(BUILD_SHARED_LIBRARY){OpenCV.mk_DIR}: directory ofOpenCV.mkfile under under OpenCV SDK directory\sdk\native\jni\OpenCV.mk{INCLUDE_DIR}: directory of OpenCV include folder under OpenCV SDK directory\sdk\native\jni\includeLOCAL_MODULE: name of native cpp file that you need for writing native cpp code! skip for now.
Optional config:
OPENCV_CAMERA_MODULESandOPENCV_INSTALL_MODULES: if you turn this option off your application need external OpenCV Package Manager installed on user device to work!