CMake構建學習筆記13-opencv庫的構建

charlee44發表於2024-09-02
筆記OpenCV

OpenCV（Open Source Computer Vision Library）是一個開源的計算機視覺和機器學習軟體庫，旨在提供一個跨平臺的、易於使用的、快速執行的計算機視覺介面。如果只是簡單的使用，其實不必要像筆者這樣使用原始碼進行構建，直接使用官方提供的二進位制安裝包即可。一般來說，需要從原始碼進行構建的原因有以下幾種：

  1. 由於C/C++構建成果的二進位制相容問題，官方提供的安裝包或者預編譯包比一定能夠適配你的程式設計環境，有的環境也不太可能找到安裝包，比如嵌入式、信創。
  2. 構建的成果不一定是你需要的構建型別，例如構建RelWithDebInfo型別。個人認為傳統的Debug和Release模式似乎不能滿足於目前軟體測試能力退化環境了，反而RelWithDebInfo型別更實用一點。例如OpenCV的Release其實就是RelWithDebInfo，因為它同時生成了符號庫檔案。
  3. 官方提供的安裝包或者預編譯包不一定有符號庫，符號庫對於Debug除錯非常重要，它可以讓我們看到程式碼檔案，讓我們知道出問題的具體地方在哪裡。雖然說依賴庫的bug我們一般改不了，但是可以給我們一點提示讓我們正確地呼叫依賴庫，避免崩潰。

筆者構建的是OpenCV的3.4.16版本，這也是OpenCV3.X的最新版本，關鍵構建指令如下所示：

# 配置階段，指定生成器、平臺和安裝路徑
cmake .. -G "$Generator" -A x64 `
    -DCMAKE_BUILD_TYPE=Release `
    -DCMAKE_PREFIX_PATH="$env:GISBasic" `
    -DCMAKE_INSTALL_PREFIX="$InstallDir" `
    -DBUILD_opencv_world=ON `
    -DWITH_GDAL=OFF `
    -DWITH_FFMPEG=OFF `
    -DWITH_IPP=OFF `
    -DBUILD_TESTS=OFF `
    -DBUILD_PERF_TESTS=OFF `
    -DBUILD_opencv_python_tests=OFF `
    -DBUILD_opencv_python_bindings_generator=OFF `
    -DBUILD_JAVA=OFF `
    -DBUILD_opencv_java=OFF `
    -DBUILD_opencv_java_bindings_generator=OFF `
    #-DBUILD_ZLIB=OFF `
    #-DBUILD_JPEG=OFF `
    #-DBUILD_PNG=OFF `
    #-DBUILD_TIFF=OFF `
    #-DWITH_PROTOBUF=ON `
    #-DBUILD_PROTOBUF=ON `
    #-DPROTOBUF_UPDATE_FILES=OFF `

# 構建階段，指定構建型別
cmake --build . --config Release

# 安裝階段，指定構建型別和安裝目標
cmake --build . --config Release --target install

OpenCV具有大量的構建選項，讀者可以按需進行構建：

  1. -DBUILD_opencv_world=ON表示將OpenCV的所有模組合併成一個名為opencv_world3416的庫。
  2. -DWITH_GDAL=OFF、-DWITH_FFMPEG=OFF、-DWITH_IPP=OFF像GDAL、FFMPEG這樣的都是非常大型的庫，如果暫時用不到功能的話就先不用參與構建了。
  3. 其他以“BUILD”開頭的選項都是測試、案例、或者其他語言的繫結什麼的，如果不需要也不要進行構建了。
  4. OpenCV其實也用到了像zlib、libpng、libjpeg、libtiff等等前面已經構建好的庫，如果像BUILD_ZLIB=OFF這樣設定，構建OpenCV的時候就會使用已經構建好的庫，而不是從OpenCV內部提供的程式碼重新構建。不過問題在於OpenCV還依賴於protobuf，谷歌的庫是另外一套風格，構建出來問題多多，讀者就不用嘗試了，還是都從OpenCV內部提供的程式碼重新構建的好。

相關文章