Caffe: Could not find PROTOBUF Compiler(Profobuf 3.0 above)

古城微笑少年丶 2022-06-12 04:15 165阅读 0赞

在用cmake生成Caffe工程文件的时候,如果你使用Protobuf 3.0以上的版本，cmake可能会产生如下的报错：

> CMake Error at cmake/ProtoBuf.cmake:18 (message):  
> Could not find PROTOBUF Compiler  
> Call Stack (most recent call first):  
> cmake/Dependencies.cmake:48 (include)  
> CMakeLists.txt:81 (include)

# 解决办法 #

> 通过设置`protobuf_MODULE_COMPATIBLE=on`指定打开Protobuf的兼容模式。  
> 注意区分大小写

设置`protobuf_MODULE_COMPATIBLE=on`也有两种办法:

## 命令行添加 ##

cmake生成Makefile时命令行添加`-Dprotobuf_MODULE_COMPATIBLE=on`，指定打开Protobuf兼容模式，类似下面的命令行：

d:\caffe> cmake -G "Visual Studio 12 2013 Win64"  . -Dprotobuf_MODULE_COMPATIBLE=on

这个办法的好处是不用修改caffe的代码

## 修改CMakeLists.txt ##

也可以在直接修改Caffe根目录下的CMakeLists.txt  
打开CMakeLists.txt,查找是否有类型下面这行代码

caffe_option(protobuf_MODULE_COMPATIBLE "Make the protobuf-config.cmake compatible with the module mode" ON IF MSVC)

如果有，直接把后面的 `IF MSVC`删除，强制将protobuf\_MODULE\_COMPATIBLE 置为ON。

如果没有，就在`# ---[ Options`后面添加一行，下面三种写法任选一行就可以

# 写法1
    caffe_option(protobuf_MODULE_COMPATIBLE "Make the protobuf-config.cmake compatible with the module mode" ON)
    # 写法2
    set (protobuf_MODULE_COMPATIBLE on CACHE BOOL "CMake build-in FindProtobuf.cmake module compatible" )
    # 写法3
    option(protobuf_MODULE_COMPATIBLE "CMake build-in FindProtobuf.cmake module compatible" ON)

> “”包含的字符串只是描述信息,内容是什么不重要

# 问题溯源 #

产生这个问题的根本原因是Protobuf3.0以后的版本的cmake脚本默认不向下兼容。需要设置`protobuf_MODULE_COMPATIBLE=on`开启兼容模式。  
进一步我们分析caffe\_folder/cmake/ProtuBuf.cmake分析，如下代码，就能看到”Could not find PROTOBUF Compiler”这个错误信息的输出位置:

find_package( Protobuf REQUIRED NO_MODULE)
    set(PROTOBUF_INCLUDE_DIR ${PROTOBUF_INCLUDE_DIRS})
    list(APPEND Caffe_INCLUDE_DIRS PUBLIC ${PROTOBUF_INCLUDE_DIR})
    list(APPEND Caffe_LINKER_LIBS PUBLIC ${PROTOBUF_LIBRARIES})
    
    
    # As of Ubuntu 14.04 protoc is no longer a part of libprotobuf-dev package
    # and should be installed separately as in: sudo apt-get install protobuf-compiler
    if(EXISTS ${PROTOBUF_PROTOC_EXECUTABLE})
      message(STATUS "Found PROTOBUF Compiler: ${PROTOBUF_PROTOC_EXECUTABLE}")
    else()
      # 没有找到 protoc(.exe)可执行文件,就报错
      message(FATAL_ERROR "Could not find PROTOBUF Compiler")
    endif()

为什么`PROTOBUF_PROTOC_EXECUTABLE`会没有定义呢？  
进一步我们追踪到protobuf\_installation/cmake/protobuf-config.cmake,就能找到`protobuf_MODULE_COMPATIBLE`这个变量真正起作用的位置(protobuf\_installation是你的ProtuBuf安装的位置):

# User options
    include("${CMAKE_CURRENT_LIST_DIR}/protobuf-options.cmake")
    
    # Depend packages
    
    
    # Imported targets
    include("${CMAKE_CURRENT_LIST_DIR}/protobuf-targets.cmake")
    
    # CMake FindProtobuf module compatible file
    if(protobuf_MODULE_COMPATIBLE)
      # 加载 兼容旧版本的脚本，生成MODULE模式下的变量PROTOBUF_INCLUDE_DIRS PROTOBUF_LIBRARIES...等等
      # 参见 https://cmake.org/cmake/help/v3.8/module/FindProtobuf.html
      # 也就是protobuf-module.cmake 这个脚本才会定义 Protobuf_PROTOC_EXECUTABLE 这个变量
      include("${CMAKE_CURRENT_LIST_DIR}/protobuf-module.cmake")
    endif()

# 延伸阅读 : Imported Target #

那么你也许会问，如果不设置`protobuf_MODULE_COMPATIBLE=on`要如何使用ProtoBuf 3.0的库呢？  
Protobuf 3.0以后的版本采用imported target这种新的形式来为应用软件提供library和include dir.  
以libprotobuf-lite库为例说明，  
打开protobuf\_installation/cmake/protobuf-targets.cmake，你会发现文件中有如下的代码

add_library(protobuf::libprotobuf-lite STATIC IMPORTED)
    set_target_properties(protobuf::libprotobuf-lite PROPERTIES
      # 指定 include 文件夹
      INTERFACE_INCLUDE_DIRECTORIES "${_IMPORT_PREFIX}/include"
    )

打开protobuf\_installation/cmake/protobuf-targets-release.cmake，进一步还能找到如下的代码

# Import target "protobuf::libprotobuf-lite" for configuration "release"
    set_property(TARGET protobuf::libprotobuf-lite APPEND PROPERTY IMPORTED_CONFIGURATIONS RELEASE)
    set_target_properties(protobuf::libprotobuf-lite PROPERTIES
      IMPORTED_LINK_INTERFACE_LANGUAGES_RELEASE "CXX"
      # 指定 library 的位置
      IMPORTED_LOCATION_RELEASE "${_IMPORT_PREFIX}/lib/libprotobuf-lite.lib"
      )

这两段代码定义了一个IMPORTED 类型的target,名字叫 `protobuf::libprotobuf-lite`,target的属性中定义了include文件夹的位置以及库的位置。

那么应用程序要使用libprotobuf-lite库，只需像以前一样调用 target\_link\_libraries将`protobuf::libprotobuf-lite`添加 到依赖库列表中就可以了。

target_link_libraries( your_target,protobuf::libprotobuf-lite)

也许你会问那还需要调用`include_directories`添加protobuf的include\_dir么？  
不需要了，your\_target指定连接一个imported target时，会自动把imported target的`INTERFACE_INCLUDE_DIRECTORIES` 属性指定的include文件夹加到your\_target的include文件夹列表中的。

> 关于imported-target的详细说明，参见 [imported-targets][]

# 参考资料 #

[《Using find\_package(Protobuf) with 3.0.0》][Using find_package_Protobuf_ with 3.0.0]  
[《imported-targets》][imported-targets]

[imported-targets]: https://cmake.org/cmake/help/v3.8/manual/cmake-buildsystem.7.html#imported-targets
[Using find_package_Protobuf_ with 3.0.0]: https://github.com/google/protobuf/issues/1931