×

Android Studio集成OpenCV

96
menglj
2016.03.10 15:20* 字数 949

本文翻译自OpenCV in Android Studio - stackoverflow[1]的第二个回答,略有删减。
本文档内容在如下环境下测试通过:

  • Android Studio 1.5.1
  • Opencv for Android 3.1.0

详细步骤

注:以“*”开头的步骤为关键步骤

1. 创建新项目

使用向导创建一个新项目(Menu:/File/New Project)。

  • 项目命名为"cvtest1"
  • Form factor:API 19, Android 4.4(KitKat)
  • Blank Activity named MainActivity

2. 编译运行

这时候可以试试运行新建的项目(Menu:/Run/Run 'app')。可以试试修改文件app/res/layout/content_main.xml,修改一下字符串“Hello world!”,然后看看运行效果。

3. 下载OpenCV for Android

从opencv网站下载OpenCV for Android,解压到本地目录,例如/opt/OpenCV-android-sdk
确定sdk/native/libs目录下有arm...,mips...和等开头的子目录,这些是针对不同平台的编译好的库文件。稍后我们需要把libs目录复制到项目中。

4. *在项目中导入OpenCV

把OpenCV导入到项目中(Menu:/File/New/import_Module):

  • Source-directory:{unzip-dir}/adk/java
  • Module name: Android Studio能自动填充这个信息openCVLibrary310,这个我们不用修改,默认就行
  • 点击“next”,接下来有3个复选框,我们需要全部选中,点击“Finish”

接下来,Android Studio开始导入module,完成后,能够看到import-summary.txt,如下图:

同时,你还会看到一个错误信息,说找不到android-14,这是因为我们下载的OpenCV中的build.gradle里配置的是用android API version 14编译,默认情况下,我们的Android SDK里已经不包含android-14这个版本了。后面我们需要解决这个错误。

5. *设置Module依赖

因为我们的app里要使用opencv库里提供的方法,我们需要在app的依赖里增加刚导入进来的opencv module

  • 打开project structure(Menu:/File/Project_Structure)
  • 选择“app”module
  • 切换到Dependenciestab页
  • 点“+”,选择Module,能看到openCVLibrary310,选择之

6. 查看app build.gradle

项目中有很多个build.gradle文件,我们要看app的build.gradle文件,这个文件在目录cvtest1/app下面,在project视图里是这样的build.gradle(Module:app),重点看如下内容:

  • compileSDKVersion (mine says 23)
  • buildToolsVersion (mine says 23.0.2)
  • minSdkVersion (mine says 19)
  • targetSdkVersion (mine says 23)

7. *修改OpenCV build.gradle

我们需要按照上面的内容来修改OpenCV的build.gradle,默认情况下,在project view下看不到新导入的openCVLibrary310,如下图:


这时,我们可以切换左上角的Android视图到Project Files视图,如下图:

上图光标选中的build.gradle文件就是我们要修改的文件。

8. Rebuild Project

rebuild项目(Menu:/Build/Rebuild Project),这时应该没有错误信息了,如下图:


这时在project viewAndroid视图里,可以看到openCVLibrary310这个Module了,如下图:

9. *复制OpenCV Native lib到项目

复制{unzip-dir}/sdk/native/libs到项目cvtest1/openCVLibrary/src/main/目录下,重命名为jniLibs,如图所示:

10. 修改代码,加载OpenCV so

修改文件MainActivity.java,在函数onCreate最后增加如下代码,加载OpenCV动态链接库。

if (!OpenCVLoader.initDebug()) {
    Log.e(this.getClass().getSimpleName(), "  OpenCVLoader.initDebug(), not working.");
} else {
    Log.d(this.getClass().getSimpleName(), "  OpenCVLoader.initDebug(), working.");
}

运行一下,在Android Monitor里能够看到如下log:

11. 调用OpenCV方法

接下来我们就可以调用opencv的方法了。我们打开一个图片,然后使用opencv的canny方法进行边缘检测。
代码如下:

String inputFileName="simm_01";
String inputExtension = "jpg";
String inputDir = getCacheDir().getAbsolutePath();  // use the cache directory for i/o
String outputDir = getCacheDir().getAbsolutePath();
String outputExtension = "png";
String inputFilePath = inputDir + File.separator + inputFileName + "." + inputExtension;


Log.d (this.getClass().getSimpleName(), "loading " + inputFilePath + "...");
Mat image = Imgcodecs.imread(inputFilePath);  
Log.d (this.getClass().getSimpleName(), "width of " + inputFileName + ": " + image.width());
// if width is 0 then it did not read your image.


// for the canny edge detection algorithm, play with these to see different results
int threshold1 = 70;
int threshold2 = 100;

Mat im_canny = new Mat();  // you have to initialize output image before giving it to the Canny method
Imgproc.Canny(image, im_canny, threshold1, threshold2);
String cannyFilename = outputDir + File.separator + inputFileName + "_canny-" + threshold1 + "-" + threshold2 + "." + outputExtension;
Log.d (this.getClass().getSimpleName(), "Writing " + cannyFilename);
Imgcodecs.imwrite(cannyFilename, im_canny);

我们可以把处理过的图片在程序中显示出来[2],打开app/res/layout/content_main.xml,添加一个imageView主画面里(通过鼠标拖拽就能实现),记住新增控件的id,例如imageView`。再增加如下代码:

// convert to bitmap:
Bitmap bm = Bitmap.createBitmap(im_canny.cols(), im_canny.rows(),Bitmap.Config.ARGB_8888);
Utils.matToBitmap(im_canny, bm);

// find the imageview and draw it!
ImageView iv = (ImageView) findViewById(R.id.imageView);
iv.setImageBitmap(bm);

运行一下程序,就能够看到处理后的图片了。

参考文档

  1. OpenCV in Android Studio - stackoverflow
  2. Display image? - opencv.org
随笔
Web note ad 1