Android Studio配置OpenCV的JNI接口
本篇主要記錄AS配置OpenCV的JNI接口實現C++代碼編程,雖然OpenCV提供的Java接口,可以直接在Android Java調用,但是由於速度的原因和追求高性能,因此采用JNI方式調用OpenCV。
1. 准備
-
Android studio 3.6或其他版本
-
Android SDK、Android NDK、CMake、OpenCV-android-sdk
2. 新建工程
(1)新建工程選擇Native C++
,然后選擇下一步Next
(2)選擇C++版本,C++ 11、C++14、C++17按需求選擇一個:
(3)項目自動構建完成后,設置SDK,NDK,JDK,一般情況如果已安裝AS會自動配置好:
(4)創建完的Native C++
自身已經配置好了JNI接口,構建的項目結構如下:
3. 配置OpenCV到項目
(1)依次點擊 File->New->Import Module
導入OpenCV-android-sdk/sdk/java
,Module name
會根據導入的OpenCV版本自動生成,點擊Next
,會出現三個復選框,都選上,點擊Finish
。
(2)依次點擊File->Project Structure
,在左邊的Dependencies
欄下選擇app
,點擊右邊欄的 “+” 號,選擇第三個Module Dependency
,里面有對應的OpenCV的文件,點擊OModuleK。
(3)將app
的build.gradle
和opencv
的build.gradle
文件進行版本號的修改,使得兩個文件中版本號一致(讓后者與前者保持一致的版本),刪除opencv
下AndroidManifest.xml
中的<uses-sdk android:minSdkVersion="8" android:targetSdkVersion="21" />
,同時將opencv
下的build.gradle
中的defaultConfig
部分刪掉,點擊Build-Make project
,等待構建完成。配置這一步的目的不是因為C++代碼需要,而是因為java代碼中需要這些包,網上很多文章都沒有這一步的配置,僅僅只配置jni接口的話,我們在activity中就無法調用opencv的函數。
(4)配置OpenCV的JNI接口,第一步將OpenCV-android-sdk/sdk/native/jni/include
文件夾拷貝到你的項目中src/main/cpp
下面,第二步將OpenCV-android-sdk/sdk/native/libs
文件夾拷貝到你的項目中src/main/
下面。並修改名字為jniLibs
。
(5)既然要通過JNI調用C++,現在對CMakeList.txt文件進行修改,如下代碼:
# 設置include文件夾的地址
include_directories(${CMAKE_SOURCE_DIR}/include)
# 設置opencv的動態庫,注意這里需要把項目路徑填寫進去,盡量注意不要填寫錯誤,
add_library(libopencv_java3 SHARED IMPORTED)
set_target_properties(libopencv_java3 PROPERTIES IMPORTED_LOCATION F:/Work/Android/writeBlog/app/src/main/jniLibs/${ANDROID_ABI}/libopencv_java3.so)
add_library( # Sets the name of the library.
native-lib
# Sets the library as a shared library.
SHARED
# Provides a relative path to your source file(s).
native-lib.cpp)
find_library( # Sets the name of the path variable.
log-lib
# Specifies the name of the NDK library that
# you want CMake to locate.
log)
target_link_libraries( # Specifies the target library.
native-lib
libopencv_java3 #添加libopencv_java3
# Links the target library to the log library
# included in the NDK.
${log-lib})
(6)接下來配置app
中的build.gradle
文件,打開代碼需要添加三段代碼:
- 第一部分代碼:
- 第二部分:
- 第三部分:
到現在為止OpenCV的JNI的接口配置完成了,整個app
的build.gradle
的代碼如下:
apply plugin: 'com.android.application'
android {
compileSdkVersion 30
buildToolsVersion "30.0.1"
defaultConfig {
applicationId "com.example.myapplication"
minSdkVersion 16
targetSdkVersion 30
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
externalNativeBuild {
cmake {
cppFlags "-std=c++11"
}
}
ndk{
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
sourceSets{
main{
jniLibs.srcDirs = ['src/main/jniLibs']
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
externalNativeBuild {
cmake {
path "src/main/cpp/CMakeLists.txt"
version "3.10.2"
}
}
splits {
abi {
enable true
reset()
include 'x86', 'x86_64', 'armeabi-v7a', 'arm64-v8a' //select ABIs to build APKs for
universalApk true //generate an additional APK that contains all the ABIs
}
}
project.ext.versionCodes = ['armeabi': 1, 'armeabi-v7a': 2, 'arm64-v8a': 3, 'mips': 5, 'mips64': 6, 'x86': 8, 'x86_64': 9]
android.applicationVariants.all { variant ->
variant.outputs.each { output ->
output.versionCodeOverride =
project.ext.versionCodes.get(output.getFilter(com.android.build.OutputFile.ABI), 0) * 1000000 + android.defaultConfig.versionCode
}
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.2.0'
implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'androidx.test.ext:junit:1.1.2'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
implementation project(path: ':openCVLibrary349')
}
(7)現在可shi以開始測試JNI調用OpenCV是否正常,在native-lib.cpp
中加入頭文件\#include <opencv2/opencv.hpp>
, 如果變成綠色同時調用OpenCV函數時自動彈出選項,說明已經配置好了,可以開始Android平台下C++開發OpenCV代碼了。