如何在IntelliJ IDEA中将OpenCV 4.5导入Gradle Java 16项目

1.1 项目初始化 #

打开IntelliJ IDEA，选择「New Project」，左侧菜单选择Gradle，右侧JDK版本指定为Java 16，勾选Java语言支持，按提示完成项目创建。

1.2 配置Gradle依赖 #

修改项目根目录下的build.gradle文件，参考如下配置：

plugins {
    id 'java'
}

group 'com.example'
version '1.0'

repositories {
    mavenCentral()
}

dependencies {
    // OpenCV集成依赖，已内置全平台原生库，无需手动配置本地OpenCV环境
    implementation 'org.openpnp:opencv:4.9.0-0'
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
}

test {
    useJUnitPlatform()
}

刷新Gradle依赖等待下载完成即可。

1.3 功能验证 #

编写测试类验证OpenCV是否加载成功：

import org.opencv.core.Core;
import org.opencv.core.Mat;
import org.opencv.imgcodecs.Imgcodecs;

public class OpenCVDemo {
    static {
        // 加载OpenCV原生库
        System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
    }

    public static void main(String[] args) {
        // 替换为本地实际存在的图片路径
        Mat image = Imgcodecs.imread("test.jpg");
        if (image.empty()) {
            System.out.println("图片读取失败");
            return;
        }
        System.out.printf("加载成功，图片尺寸：%d × %d%n", image.width(), image.height());
    }
}

运行main方法，正常输出图片尺寸即为配置成功。

• 架构适配不同：普通桌面版适配x86、x86_64、arm等桌面/服务器架构，原生库后缀对应为.dll（Windows）、.so（Linux）、.dylib（macOS）；Android版仅适配armv7a、armv8a、x86、x86_64四类移动端架构，原生库为对应ABI目录下的.so文件，无法直接在桌面环境运行。
• API裁剪差异：Android版移除了桌面端不常用的模块，包括工业相机驱动支持、服务器端并行计算扩展模块、桌面GUI相关的highgui模块，同时新增了Android平台专属适配接口，支持Bitmap、SurfaceTexture与OpenCV Mat对象直接转换。
• 依赖环境不同：普通版依赖桌面系统标准C/C++运行库、图形驱动组件，支持CUDA、OpenCL全功能通用计算；Android版依赖NDK编译的运行时库，需配合Android SDK基础组件使用，仅支持移动端有限的OpenCL、NNAPI硬件加速能力。
• 集成方式不同：普通版可直接通过Maven/Gradle引入依赖，也可自行编译源码后配置系统环境变量使用；Android版通常以AAR包形式集成，需要在项目中配置ndk abiFilters筛选对应架构的原生库，减小安装包体积。
• 优化方向不同：普通版优先提升大尺寸图像处理、离线计算的性能，多核CPU、GPU并行计算支持更完善；Android版优先优化移动端功耗、内存占用，针对实时摄像流处理场景做了专属优化。

内容的提问来源于stack exchange，提问作者A.Dumas