OpenCV On Android最佳环境配置指南
环境
电脑：Windows10 Java：jdk-14.0.2_windows-x64_bin Android Studio：Version 3.5.2 SDK：Android Studio 3.5.2自带的最新SDK(请不要与Eclipse同用一SDK，以免出错)。 NDK：21.3.6528147
Cmake:3.10.2.4988404
OpenCV：OpenCV - Browse Files at SourceForge.net 这里选择4.5.0
注：以上配置向上兼容，读者可使用更新的版本，但低版本可能出现错误 (更新时间:2021-7-6)
一、安装必要组件
1、打开Android Studio。如果是欢迎界面，选择Configure->SDK Manager。如果是项目界面，选择Tools->Android->SDK Manager。 2、将选项条切换到SDK Tools，勾上左下角的Show Package Details，然后勾选以下2项，然后OK，开始下载。
下载完后，就可以开始创建项目了。
二、创建Android Studio工程
Create New Projec，开始选择模板，这时选择最后一项Native C++，然后进入配置界面。
这一步需要注意两个地方
1、包名：请尽量与我保持一致，否则新手容易出错。 2、最小SDK：OpenCV 4.2.0要求最小SDK必须大于21。
下一步直接Finish，项目创建成功！
三、OpenCV Java库使用指南
3.1、环境配置：
第一步、将OpenCV Java库作为Module导入。具体步骤为：File->New->Import Module，然后将OpenCV-android-sdk\sdk\java目录导入。如下图，然后Next->Finish。
第二步、修改模块名 默认导入的模块名为java，为了方便区分，建议修改成opencv. 或者创建后修改:java模块右键Refactor->Rename->rename module
第二步、将导入的opencv模块从application改成library，步骤如下：
1、将文件预览方式切换至Android。
2、打开opencv的build.gradle文件。
3、将apply plugin: 'com.android.application'修改成apply plugin: 'com.android.library'。
4、删除(或注释)掉defaultConfig内容
5、将Run/Debug Configurations从opencv切换到app
6、点击Sync Now使修改生效。
第三步、给项目添加opencv依赖 菜单File->Project Structure，在SDK location中添加SDK
在Dependencies中选择app，点击+，选择Module dependency，如下图：
勾选上opencv模块，点击OK即可！
3.2、代码编写：
在app/src/main/AndroidManifest.xml文件中添加权限：
....
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature
android:name="android.hardware.camera"
android:required="true" />
<uses-feature
android:name="android.hardware.camera.autofocus"
android:required="false" />
....
将app/src/main/res/layout/activity_main.xml内容修改为以下内容：
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<org.opencv.android.JavaCameraView
android:id="@+id/javaCameraView"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:camera_id="back"
app:show_fps="true" />
</FrameLayout>
将MainActivity.java改为以下内容：
public class MainActivity extends CameraActivity implements CameraBridgeViewBase.CvCameraViewListener2 {
private JavaCameraView javaCameraView;
private BaseLoaderCallback baseLoaderCallback = new BaseLoaderCallback(this) {
@Override
public void onManagerConnected(int status) {
switch (status) {
case LoaderCallbackInterface.SUCCESS: {
javaCameraView.enableView();
}
break;
default:
super.onManagerConnected(status);
break;
}
}
};
@Override
protected List<? extends CameraBridgeViewBase> getCameraViewList() {
List<CameraBridgeViewBase> list = new ArrayList<>();
list.add(javaCameraView);
return list;
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
javaCameraView = findViewById(R.id.javaCameraView);
javaCameraView.setVisibility(SurfaceView.VISIBLE);
javaCameraView.setCvCameraViewListener(this);
}
@Override
public void onPause() {
super.onPause();
if (javaCameraView != null)
javaCameraView.disableView();
}
@Override
public void onResume() {
super.onResume();
if (!OpenCVLoader.initDebug()) {
OpenCVLoader.initAsync(OpenCVLoader.OPENCV_VERSION, this, baseLoaderCallback);
} else {
baseLoaderCallback.onManagerConnected(LoaderCallbackInterface.SUCCESS);
}
}
@Override
public void onCameraViewStarted(int width, int height) {
}
@Override
public void onCameraViewStopped() {
}
@Override
public Mat onCameraFrame(CameraBridgeViewBase.CvCameraViewFrame inputFrame) {
return inputFrame.gray();
}
}
这里注意一下，让我们自己的Activity继承至opencv的CameraActivity，是一个十分不好的做法，请读者务必看懂CameraActivity源码，做到活学活用。
做到这一步，我们已经能够编译出一个app，但是它并不能正常运行，这是因为我们只是将opencv的api模块导入，但具体代码没包含在apk中。 我们现在可通过以下两种方式来解决这个问题：
1、在手机中安装OpenCV Manager.apk 这种方式及其不好，原因有以下几点：
1、用户需要单独安装这个apk，且不同CPU架构的手机，apk也不一样。
2、Android高版本中，即使安装了这个apk，我们的程序也可能不会正常运行。这是因为一些手机厂商，为了防止应用通过相互唤醒来实现应用保活，所以对不同应用进程间调用进行了限制。比如华为手机管家中的启动管理。
3、OpenCV高版本现已不再提供OpenCV Manager.apk
2、将libopencv_java4.so导入到apk中 这种方式的缺点就是：麻烦!!!
如果我们已经确定了目标机型，这种方式无疑是比较好的。通常来说，如果是真机，导入armeabi或armeabi-v7a架构的so文件；如果是虚拟机，则一般选择x86架构的so文件。
方法2实现步骤如下： 1、将OpenCV库中的OpenCV-android-sdk\sdk\native\libs目录下4个子目录，copy到我们项目的libs目录下。 2、修改app/build.gradle文件，添加以下内容：
sourceSets{
main{
jniLibs.srcDirs = ["libs"];
}
}
如图所示：
做完这一步，libopencv_java4.so将被自动打包进apk中，但是依旧不能正常运行，提示缺少c++_shared，这需要我们再次修改build.gradle文件，添加arguments：
android {
//......
defaultConfig {
//......
externalNativeBuild {
cmake {
cppFlags ""
arguments "-DANDROID_STL=c++_shared"
}
}
}
}
做完以上内容，基本上就OK了。
其实这里还有一个坑，由于我们从一开始就创建的是一个Native C++项目，所以通过在build.gradle文件中添加arguments参数，就能将c++_shared.so打包进apk，但是如果创建的是普通项目，此方式将无效，需要手动将c++_shared.so添加到libs对应的目录下
四、OpenCV NDK库使用指南
4.1、环境配置：
Android Studio配置OpenCV环境灰常简单(是的，没错)，只需修改一个文件便能成功配置环境，什么Android.mk啊、Application.mk啊，全部滚蛋。 配置方式：打开app/src/main/cpp/CMakeLists.txt，内容修改如下，(将OpenCV_DIR设置为你的路径，注意分隔符，使用'/'或'\\')：
cmake_minimum_required(VERSION 3.4.1)
# ##################### OpenCV 环境 ############################
#设置OpenCV-android-sdk路径
set( OpenCV_DIR D:\\ppencv\\OpenCV-android-sdk\\sdk\\native\\jni )
find_package(OpenCV REQUIRED )
if(OpenCV_FOUND)
include_directories(${OpenCV_INCLUDE_DIRS})
message(STATUS "OpenCV library status:")
message(STATUS " version: ${OpenCV_VERSION}")
message(STATUS " libraries: ${OpenCV_LIBS}")
message(STATUS " include path: ${OpenCV_INCLUDE_DIRS}")
else(OpenCV_FOUND)
message(FATAL_ERROR "OpenCV library not found")
endif(OpenCV_FOUND)
# ###################### 项目原生模块 ###########################
add_library( native-lib
SHARED
// src/main/cpp/native-lib.cpp)// 博主写的
native-lib.cpp) //我改的,不然一直报错
target_link_libraries( native-lib
${OpenCV_LIBS}
log
jnigraphics)
OK，环境配置好了，嘿嘿嘿，接下来开始代码编写。
4.2、代码编写：
菜单File->New->Activity->Empty Activity，创建一个新的Activity，其命名下如图，并设置为启动页，Finish。
为了分清楚桌面上两个程序入口，请在AndroidManifest.xml文件中给两个Activity指定label，如下图：
下面开始编写布局文件activity_native.xml，内容如下：
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/imageView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:orientation="horizontal">
<Button
android:id="@+id/show"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="show" />
<Button
android:id="@+id/process"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="process" />
</LinearLayout>
</RelativeLayout>
NativeActivity.java内容如下：
public class NativeActivity extends AppCompatActivity implements View.OnClickListener {
private ImageView imageView;
static {//加载so库
System.loadLibrary("native-lib");
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_native);
imageView = findViewById(R.id.imageView);
findViewById(R.id.show).setOnClickListener(this);
findViewById(R.id.process).setOnClickListener(this);
}
@Override
public void onClick(View v) {
if (v.getId() == R.id.show) {
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.test);
imageView.setImageBitmap(bitmap);
} else {
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.test);
getEdge(bitmap);
imageView.setImageBitmap(bitmap);
}
}
//获得Canny边缘
native void getEdge(Object bitmap);
}
将一张名为test.jpg的图片放置在drawable目录下，嘿嘿嘿！
应用层写好了，现在开始原生层操作：
第一步：生成头文件(可以省略)
实现设置环境变量:D:\Android\Android Studio\jre\bin
打开Android Studio下方Terminal栏，输入cd app/src/main/java(所有应用都一样)，回车。然后输入javah -encoding UTF-8 包名.类名(我们这里输入的是javah -encoding UTF-8 com.demo.opencv.NativeActivity，注意，类名后面不要加.java或.class)，回车后，将在app\src\main\java目录下生成一个头文件，
如果提示类文件不存在，则需先build，再执行上述操作。最后将该头文件移动到app\src\main\cpp目录下。
也可以通过添加external tools 来生成
然后再app/src/main/java/com.demo.opencv/NativeActiviy右击external tools->javah
第二步：编写NDK代码 native-lib.cpp内容修改为：
#include "com_demo_opencv_NativeActivity.h"
#include <android/bitmap.h>
#include <opencv2/opencv.hpp>
using namespace cv;
extern "C" JNIEXPORT void
JNICALL Java_com_demo_opencv_NativeActivity_getEdge
(JNIEnv *env, jobject obj, jobject bitmap) {
AndroidBitmapInfo info;
void *pixels;
CV_Assert(AndroidBitmap_getInfo(env, bitmap, &info) >= 0);
CV_Assert(info.format == ANDROID_BITMAP_FORMAT_RGBA_8888 ||
info.format == ANDROID_BITMAP_FORMAT_RGB_565);
CV_Assert(AndroidBitmap_lockPixels(env, bitmap, &pixels) >= 0);
CV_Assert(pixels);
if (info.format == ANDROID_BITMAP_FORMAT_RGBA_8888) {
Mat temp(info.height, info.width, CV_8UC4, pixels);
Mat gray;
cvtColor(temp, gray, COLOR_RGBA2GRAY);
Canny(gray, gray, 45, 75);
cvtColor(gray, temp, COLOR_GRAY2RGBA);
} else {
Mat temp(info.height, info.width, CV_8UC2, pixels);
Mat gray;
cvtColor(temp, gray, COLOR_RGB2GRAY);
Canny(gray, gray, 45, 75);
cvtColor(gray, temp, COLOR_GRAY2RGB);
}
AndroidBitmap_unlockPixels(env, bitmap);
}
注意，naive-lib.cpp中只有一个函数，这个函数名必须与生成的头文件中定义的一致
添加安卓模拟器或者直接插手机(记得启动开发者模式,允许调试)
N
运行程序，点击SHOW按钮，效果如下：
11
点击PROCESS，效果如下：
