【配置教程】新版OpenCV+Android Studio环境配置（4.11测试通过）

在 Android Studio 中连接新版 OpenCV（4.11）

很多教程都无法正常在新版工作，因此这里我更新一下教程。后面会再写一个如何加入cpp的教程。

---

一、准备工作

1. 下载 OpenCV Android SDK

   • 访问：https://opencv.org/releases/
   • 下载如 OpenCV-4.x.x-android-sdk.zip
   • 解压至任意目录，例如：~/Android/OpenCV-android-sdk

2. 安装 Android Studio

   • https://developer.android.com/studio

---

二、新建 Android 项目

1. 打开 Android Studio，选择 New Project
2. 使用 Empty Activity
3. 输入项目名，例如 OpenCVTest
4. 设置语言为 Java 或 Kotlin（建议使用 Java）
5. 选择合适的最小 API Level（建议 API 21 或更高）

---

三、集成 OpenCV 库

方式一：使用 OpenCV SDK 模块（推荐）

1. 导入 OpenCV SDK 模块

   • 在 Android Studio 中右键项目根目录 > New > Import Module
   • 路径选择：/sdk/java
   • Module name 保持默认：:openCVLibrary4

2. 将 OpenCV 模块添加到你的 app 中

   编辑 settings.gradle：

   include ':app', ':openCVLibrary4'
   

   编辑 app/build.gradle：

   dependencies {
       implementation project(':openCVLibrary4')
   }
   

---

四、配置 Native 支持（可选）

如果你需要使用 OpenCV 的 C++ 接口（如通过 JNI），可添加 NDK 支持。

1. 启用 C++ 支持

   • 在新建项目时勾选“Include C++ Support”，或
   • 手动添加 CMakeLists.txt 与 JNI 源码

2. 编辑 CMakeLists.txt

   cmake_minimum_required(VERSION 3.4.1)
   
   set(OpenCV_DIR /sdk/native/jni)
   find_package(OpenCV REQUIRED)
   
   add_library(native-lib SHARED native-lib.cpp)
   
   target_link_libraries(native-lib ${OpenCV_LIBS} log)
   

3. 配置 build.gradle

   externalNativeBuild {
       cmake {
           path "src/main/cpp/CMakeLists.txt"
       }
   }
   
   sourceSets {
       main {
           jniLibs.srcDirs = ['/sdk/native/libs']
       }
   }
   

---

五、加载 OpenCV 库

在 MainActivity.java 中添加如下代码：

import org.opencv.android.OpenCVLoader;
import android.util.Log;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "OpenCV";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        if (!OpenCVLoader.initDebug()) {
            Log.e(TAG, "OpenCV initialization failed!");
            Toast.makeText(this, "OpenCV initialization failed!", Toast.LENGTH_LONG).show();
        } else {
            Log.i(TAG, "OpenCV loaded successfully");
        }
    }
}

---

六、验证配置

1. 运行 app，查看 Logcat 是否输出：

   OpenCV loaded successfully
   

2. 若提示失败，确认：

   • jniLibs 是否包含了合适架构的 .so 文件
   • OpenCVLoader.initDebug() 被正确调用

---

七、调试和注意事项

• initDebug() 仅适用于调试模式。发布版本请使用 OpenCV Manager 或静态初始化。

• 可用命令确认 .so 文件架构是否匹配：

  file libopencv_java4.so
  

• 若使用 Kotlin，语法略有差异，注意 API 兼容性。

---

八、附录

JNI 示例：

#include 
#include 
#include 

extern "C" JNIEXPORT jstring JNICALL
Java_com_example_opencvtest_MainActivity_stringFromJNI(
    JNIEnv* env,
    jobject /* this */) {
    cv::Mat mat = cv::Mat::eye(3, 3, CV_8UC1);
    std::string msg = "OpenCV Mat:\n" + std::to_string(mat.rows) + "x" + std::to_string(mat.cols);
    return env->NewStringUTF(msg.c_str());
}

---

九、参考链接

• OpenCV for Android 官方文档
• OpenCV GitHub
• NDK 配置文档