前言

最近有個項目需要對圖片圖像進行處理，使用到了開源框架OpenCV全稱是Open Source Computer Vision Library，是一個跨平臺的計算機視覺庫；而現(xiàn)在的項目都是基于SpringBoot，需要把OpenCv整合進去，下面把在使用中遇到的問題進行一個匯總整理。

下載安裝

Opencv官網(wǎng)提供了一個多個平臺的版本包括：windows，IOS，Android，地址如下：https://opencv.org/releases/；因為開發(fā)在Windows平臺，發(fā)布在linux平臺，所以我們這里至少需要兩個版本；

windows平臺

直接可以在官網(wǎng)下載opencv-3.4.10-vc14_vc15.exe安裝即可，安裝完會出現(xiàn)opencv文件夾在buildJAVA目錄下有我們需要的opencv-3410.jar，x64/opencv_java3410.dll，x86/opencv_java3410.dll文件；

Linux平臺

Linux平臺需要我們手動編譯，下載opencv-3.4.10.zip，解壓到/user/local目錄下，然后編譯安裝，執(zhí)行如下命令：

cd /usr/local/opencv-3.4.10
mkdir build
cd build
cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -DBUILD_TESTS=OFF ..
make -j8
sudo make install

安裝完之后可以在build/bin目錄下找到opencv-3410.jar，在build/lib目錄下找到libopencv_java3410.so

整合使用

兩個平臺分別安裝完之后，獲取了對應(yīng)的dll和so文件；兩個平臺獲取到的jar都是一樣的，隨便用哪個都可以，下面看看如何使用

外部引用方式

通過把應(yīng)用jar與本地庫文件進行分隔開，然后在項目中進行引用

相對路徑方式

可以通過System.loadLibrary來指定本地庫文件，但是這種方式需要在運行時指定-Djava.library.path，具體可以提供配置類：

@Configuration
public class NativeConfig {
    static {
        System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
    }
}

運行時需要在VM arguments中添加-Djava.library.path=對應(yīng)dll存放的路徑，不然會出現(xiàn)如下錯誤：

Caused by: java.lang.UnsatisfiedLinkError: no opencv_java3410 in java.library.path
    at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1860) ~[na:1.8.0_251]
    at java.lang.Runtime.loadLibrary0(Runtime.java:870) ~[na:1.8.0_251]
    at java.lang.System.loadLibrary(System.java:1122) ~[na:1.8.0_251]
    at com.springboot.opencv.NativeConfig.<clinit>(NativeConfig.java:10) ~[classes/:na]

絕對路徑方式

可以通過System.load來指定本地庫函數(shù)的絕對路徑：

@Configuration
public class NativeConfig {
    static {
        System.load("C:\Users\opencv\build\java\x64\opencv_java3410.dll");
    }
}

踩坑1

在IDE中運行使用Opencv功能的時候，出現(xiàn)如下錯誤：

java.lang.UnsatisfiedLinkError: org.opencv.imgcodecs.Imgcodecs.imread_1(Ljava/lang/String;)J
    at org.opencv.imgcodecs.Imgcodecs.imread_1(Native Method) ~[opencv-3.4.10.jar:unknown]
    at org.opencv.imgcodecs.Imgcodecs.imread(Imgcodecs.java:332) ~[opencv-3.4.10.jar:unknown]
    at com.springboot.opencv.OpenCVController.testOpenCV(OpenCVController.java:13) ~[classes/:na]

很明顯是在使用jar包里面的方法時沒有找到對應(yīng)的本地庫函數(shù)，也就是說loadLibrary沒有成功，但是之前其實在本地Java項目中是有進行測試的，可以通過的，猜測是不是使用了什么工具導(dǎo)致加載失敗，最終鎖定在spring-boot-devtools工具包，提供了動態(tài)加載等功能，直接移除此工具包，或者配置如下開關(guān)：

System.setProperty("spring.devtools.restart.enabled", "false");

內(nèi)部引用方式

為了更加簡單部署，可以把本地庫文件和項目文件打成一個jar包，可以把本地庫文件放在resources目錄下，這樣可以打成一個jar包，現(xiàn)在的主要問題就是如何加載jar包里面的本地庫文件，通過測試發(fā)現(xiàn)可以讀取到resources目錄下的庫文件，但是通過system.load并不能去加載成功，對應(yīng)的是一個類似如下的路徑：

file:/C:/Users/Administrator.SKY-20170404CXG/Desktop/springboot-0.0.1-SNAPSHOT.j
ar!/BOOT-INF/classes!/opencv

最后采用的方式是把讀取的庫文件，存放到系統(tǒng)的一個臨時文件夾下，然后拿到庫文件的絕對路徑，這樣就可以通過system.load直接去加載，具體實現(xiàn)代碼可以參考Github

踩坑2

在執(zhí)行maven編譯打包的時候，發(fā)現(xiàn)本地庫文件(dll或者so文件)體積會變大，猜測maven在編譯的時候?qū)Ρ镜貛煳募策M行了編譯，具體如何禁用指定的文件格式編譯，而只需要拷貝即可：

<plugin>
    <groupId>org.Apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <configuration>
       <encoding>UTF-8</encoding>
       <!-- maven編譯下面擴展類型文件的時候直接復(fù)制原文件，而不會進行二次編碼-->                 
       <nonFilteredFileExtensions>dll,so</nonFilteredFileExtensions>
    </configuration>
</plugin>

第三方Jar包

除了以上兩種需要我們自己去實現(xiàn)加載的方式，其實還可以直接使用第三方提供的jar包OpenPnp，里面包含了OpenCV.jar，對應(yīng)各個平臺的本地庫，以及加載本地庫的封裝類；查看其源碼可以發(fā)現(xiàn)，其實也是通過判斷當(dāng)前系統(tǒng)，然后將對應(yīng)的本地庫文件拷貝到系統(tǒng)的臨時文件夾下，最后通過system.load去加載：

Files.createTempDirectory(`opencv_openpnp`)；

因為此包兼顧了所有平臺，所以整個包有點大，一百多M，如果部署的系統(tǒng)確定，其實可以自己去加載指定庫文件就可以了，然后以相同的方式打成一個公共包供各個系統(tǒng)使用；

總結(jié)

本文雖然介紹的是在項目中使用OpenCV的一些總結(jié)，但其實其他的本地庫也可以使用相同的方式；本文重點記錄一下在使用過程中遇到的那些坑，以及加載庫文件的方式。

代碼地址

https://github.com/ksfzhaohui/blog