cmake:install制作简单的安装脚本

本文介绍使用CMake的install命令来制作用于二次开发的SDK安装脚本,该脚本能自动分类并安装目标文件至指定目录,包括动态库、可执行文件及头文件等,简化了用户配置流程。

当我们制作用于二次开发的SDK的时候,用cmake的install命令制作一个安装脚本提供简单的SDK安装功能,在make结束后自动把文件分类放在不同的目录下,提供给用户,比只是把.h,.lib,.dll文件一股脑的复制给用户,让用户自己去配置要好得多。 
下面的cmake脚本片段,展示了用cmake install命令实现的简单安装功能:

########安装脚本##########
# 将生成的target安装到指定目录下,这里 detect_cl,img_tool是动态库,test_detect是可执行程序,
# cmake会自动根据target的类型将可执行程序(如.exe)和动态库(如.dll)作为RUNTIME类型复制到bin下,
# 将动态库的导入库(.lib .a)作为ARCHIVE类型复制lib/static目录下

install(TARGETS detect_cl img_tool test_detect 
        RUNTIME DESTINATION bin
        LIBRARY DESTINATION lib
        ARCHIVE DESTINATION lib/static)
# 复制源码中的指定的头文件到 include下
install(FILES ${PROJECT_SOURCE_DIR}/facedetect/detect_cl_types.h DESTINATION include)
install(FILES ${PROJECT_SOURCE_DIR}/facedetect/detect_cl.h DESTINATION include)
install(FILES ${PROJECT_SOURCE_DIR}/facedetect/img_tool.h DESTINATION include)
# 复制sample代码到 sample下
install(FILES ${PROJECT_SOURCE_DIR}/facedetect/test_detect.cpp DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/../codemgr/cmimpl/utility.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/../codemgr/cmimpl/raii.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/include/assert_macros.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/include/cmdline.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/include/dirent.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/include/file_utilits.h DESTINATION sample)
install(FILES ${PROJECT_SOURCE_DIR}/include/time_utilits.h DESTINATION sample)



然后执行 make install (gcc编译),在完成所有代码编译后,就自动把你指定的的文件复制到安装目录下。 


如果你要指定不同的安装目录,在生成 Makefile的时候通过定义CMAKE_INSTALL_PREFIX变量来实现,如下:

cmake -G “Eclipse CDT4 - MinGW Makefiles” -DCMAKE_INSTALL_PREFIX=d:/detect_cl

cmake install命令还有更多复杂的应用方式,参见 https://cmake.org/cmake/help/v3.1/command/install.html
 

在使用 CMake 进行项目安装时,若出现 `file INSTALL cannot find specified file but file exists` 的错误,通常表明 CMake 的 `file(INSTALL ...)` 命令在执行过程中无法找到目标文件,尽管该文件在系统中实际存在。以下是可能的原因及对应的解决方法。 ### 3.1 文件路径拼接问题 CMake 的 `file(INSTALL ...)` 命令对路径拼接较为敏感。如果路径中使用了相对路径或未正确拼接,可能导致 CMake 无法定位到实际存在的文件。 **解决方法:** 使用 `CMAKE_CURRENT_SOURCE_DIR` 或 `CMAKE_CURRENT_BINARY_DIR` 明确指定文件路径,确保路径拼接正确。 ```cmake install(FILES "${CMAKE_CURRENT_SOURCE_DIR}/example.txt" DESTINATION "share/myproject") ``` ### 3.2 文件未在构建阶段生成 某些文件可能是在构建过程中动态生成的(如通过 `add_custom_command` 生成的文件),如果在构建完成前执行安装命令,这些文件尚未存在,导致安装失败。 **解决方法:** 确保安装命令在构建完成后执行,或者使用 `add_dependencies` 明确指定依赖关系。 ```cmake add_custom_command(OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/generated.txt" COMMAND generate_script DEPENDS source_file) add_custom_target(generate_file ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/generated.txt") install(FILES "${CMAKE_CURRENT_BINARY_DIR}/generated.txt" DESTINATION "bin") add_dependencies(install generate_file) ``` ### 3.3 安装路径不存在或不可写 如果安装路径(由 `CMAKE_INSTALL_PREFIX` 指定)不存在或当前用户无写入权限,`file(INSTALL ...)` 命令将无法创建目标文件,从而报错。 **解决方法:** 确保目标路径存在,并具有写入权限。可以参考以下代码设置默认安装路径为构建目录下的子目录: ```cmake if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) set(CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE STRING "Default install path" FORCE) endif() ``` 该方法可避免因权限问题导致安装失败 [^1]。 ### 3.4 缓存路径未更新 CMake 缓存中可能保留了旧的路径信息,导致 `file(INSTALL ...)` 使用了错误的路径。 **解决方法:** 清理 CMake 缓存并重新配置项目。 ```shell rm -rf build/ mkdir build && cd build cmake .. ``` ### 3.5 文件名大小写或路径大小写不一致 在某些系统(如 Linux)上,文件系统是大小写敏感的。如果 `file(INSTALL ...)` 中指定的路径大小写与实际路径不一致,可能导致找不到文件。 **解决方法:** 确保路径文件名的大小写与实际文件系统一致。 ### 3.6 使用 `install(FILES ...)` 时未处理通配符 如果使用了通配符(如 `*.dll`)进行批量安装,而通配符未匹配到任何文件,也会报错。 **解决方法:** 确保通配符匹配的文件存在,或使用 `GLOB` 显式获取文件列表。 ```cmake file(GLOB DLLS "${CMAKE_CURRENT_BINARY_DIR}/*.dll") install(FILES ${DLLS} DESTINATION "bin") ``` ### 3.7 使用 `install(SCRIPT ...)` 或 `CODE ...` 时未处理异常 有时在安装过程中调用自定义脚本或代码,若未正确处理异常或路径问题,也可能导致文件找不到。 **解决方法:** 在调用脚本时确保路径正确,并使用 `message(FATAL_ERROR ...)` 明确处理错误。 ```cmake install(CODE "execute_process(COMMAND ${CMAKE_COMMAND} -E copy \"source_file\" \"dest_file\")") ``` ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值