vcpkg构建OpenCV+GStreamer应用时输出目录缺失二进制文件问题

1. 配置vcpkg自动复制所需GStreamer DLL的方法 #

GStreamer插件属于运行时动态加载组件，不属于主程序的直接链接依赖，vcpkg默认的自动DLL复制逻辑无法识别这类间接依赖，才会导致插件DLL缺失，按以下步骤配置即可：

• 第一步：补全vcpkg.json依赖配置，当前配置缺少包含硬解码、部分流解析组件的插件集，修改后的配置参考：

{
  "$schema": "https://raw.githubusercontent.com/microsoft/vcpkg/master/scripts/vcpkg.schema.json",
  "name": "opencvtest",
  "version": "0.0.1",
  "dependencies": [
    {
      "name": "opencv",
      "default-features": true,
      "features": [ "gstreamer" ]
    },
    {
      "name": "gstreamer",
      "default-features": true,
      "features": [ 
        "plugins-base",
        "plugins-good",
        "plugins-bad",
        "plugins-ugly",
        "x264",
        "nvcodec"
      ]
    }
  ]
}

注意：nvcodecfeature对应管道中使用的nvh264decN卡硬解码元素，不需要硬解可以移除。

• 第二步：配置生成后复制规则，按项目类型选择对应配置：
  • Visual Studio原生MSBuild项目（直接打开.sln构建）：右键项目 -> 属性 -> 生成事件 -> 后期生成事件，在命令行加入以下命令：

    :: 复制核心依赖DLL
    xcopy /y /s "$(VcpkgRoot)installed\$(VcpkgTriplet)\bin\*.dll" "$(OutDir)"
    :: 创建GStreamer插件目录并复制所有插件
    if not exist "$(OutDir)\gstreamer-1.0\plugins" mkdir "$(OutDir)\gstreamer-1.0\plugins"
    xcopy /y /s "$(VcpkgRoot)installed\$(VcpkgTriplet)\plugins\gstreamer\*.dll" "$(OutDir)\gstreamer-1.0\plugins\"
    

  • CMake项目：在CMakeLists.txt中添加如下自定义构建命令：

    add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
      COMMAND ${CMAKE_COMMAND} -E copy_directory
        "${VCPKG_INSTALLED_DIR}/${VCPKG_TARGET_TRIPLET}/bin"
        $<TARGET_FILE_DIR:${PROJECT_NAME}>
      COMMAND ${CMAKE_COMMAND} -E make_directory
        "$<TARGET_FILE_DIR:${PROJECT_NAME}>/gstreamer-1.0/plugins"
      COMMAND ${CMAKE_COMMAND} -E copy_directory
        "${VCPKG_INSTALLED_DIR}/${VCPKG_TARGET_TRIPLET}/plugins/gstreamer"
        "$<TARGET_FILE_DIR:${PROJECT_NAME}>/gstreamer-1.0/plugins"
    )
    

• 本地调试临时方案：不想复制文件的话，可以在系统环境变量添加GST_PLUGIN_PATH，值为vcpkg安装目录下对应triplet的plugins/gstreamer路径，运行时GStreamer会自动到该路径加载插件，仅适合本地开发使用。

2. vcpkg环境下OpenCV+GStreamer的正确使用方式 #

• 依赖配置层面：
  • 安装opencv必须开启gstreamerfeature，保证OpenCV编译了GStreamer后端。
  • GStreamer依赖按需开启feature：四个基础插件集plugins-base/plugins-good/plugins-bad/plugins-ugly建议全开，拉RTSP需要的rtspsrc/rtph264depay在plugins-good，h264parse在plugins-bad，硬解码元素按需开启nvcodec（N卡）、vaapi（Linux/Intel）等对应feature。
  • 构建时triplet必须匹配：debug版本程序用x64-windows-debugtriplet依赖，release版本用x64-windows，不要混用debug/release的DLL，否则会出现加载失败。
• 代码编写层面：
  • 程序入口优先初始化GStreamer，在创建VideoCapture之前调用gst_init(nullptr, nullptr);，避免初始化顺序问题导致元素找不到。
  • GStreamer管道字符串最后必须以appsink结尾，OpenCV通过appsink拉取帧数据。
  • VideoCapture对象建议栈上声明，不需要手动new，避免内存泄漏，使用前通过cap.isOpened()判断是否打开成功。
• 部署层面：
  除了常规的OpenCV、C++运行时、GStreamer核心DLL，必须严格按照GStreamer的目录结构存放插件：所有GStreamer插件DLL必须放在程序输出目录下的gstreamer-1.0/plugins路径下，不要直接把插件DLL放在输出目录根路径，否则GStreamer无法扫描识别插件元素。

你遇到的no element "rtspsrc"报错，本质就是GStreamer没有扫描到对应插件DLL，按上述步骤补全依赖、配置复制规则后即可解决。

内容的提问来源于stack exchange，提问作者Kyberias