本文操作按照《c&c++开源库编译指南》中内容规范编写,编译环境配置、工具下载、目录规划,及更多其他开源库编译方法请参考该文章。
c&c++开源库编译指南:https://blog.csdn.net/binary0006/article/details/144086155
本文章中的源代码已提交到gitee仓库,地址:https://gitee.com/binary0010/depends/tree/master/c/tiff-4.0.10
1.libtiff编译
1.1.源代码下载
源代码下载地址:http://download.osgeo.org/libtiff/,比较新的版本不支持vs2008编译,这里选择一个比较早的版本4.0.10,点击下图所示链接直接下载即可。
也可以自己复制这个地址下载:http://download.osgeo.org/libtiff/tiff-4.0.10.tar.gz
1.2.libtiff库的CMake结构
先解压源代码到指定目录,libtiff已经提供了CMakeList.txt脚本,按照之前文章中编译规范操作之前,我们先分析一下libtiff的CMake脚本结构。
观察源代码根目录下的CMakeList.txt脚本,可以看出libtiff有很多可选的依赖库(在前面的文章中,已经编译过zlib和tiff,有需要编译的同学可以去我的主页查找)。另外libtiff的工程由多个子目录构成,实际上就是vs中一个解决方案有多个子项目(下面截图中,注释掉了实际开发中不需要的工程)。
1.3.windwos编译
1.3.1.增加查找zlib和tiff脚本
zlib和tiff的在之前的文章中已经编译了,还没有编译的同学可以去看看之前的编译文章,CMake本身自带了zlib和tiff的查找脚本,由于我们的编译脚本按照我们自己个规范来处理的,所以查找zlib和tiff的脚本也需要按照我们的规范来编写。
相关的公共脚本已提交到:https://gitee.com/binary0010/depends/tree/master/cmake
1.3.2.修改CMakeList脚本
libtiff按照我们设计的编译规范需要修改两个CMakeList.txt脚本文件,路径分别是c/tiff-4.0.10/CMakeLists.txt和c/tiff-4.0.10/libtiff/CMakeLists.txt。
脚本涉及的内容主要是使用自定义的FindZLIB.cmake和FindJPEG.cmake脚本来查找依赖库,以及mt工程的链接库设置。由于脚本内容太多,这里就不粘贴全部代码,仅截图展示修改部分的内容,完整的编译脚本,可以直接从文章开头的gitee仓库获取。
c/tiff-4.0.10/CMakeLists.txt修改内容:
c/tiff-4.0.10/libtiff/CMakeLists.txt修改内容(该文件主要是注释了自带的工程配置,按照我们设计的规范来配置工程,修改代码如下,详细文件内容可以从文件开头的gitee仓库获取):
# 动态库工程
add_library(tiffdll SHARED ${tiff_SOURCES} ${tiff_HEADERS} ${nodist_tiff_HEADERS} ${tiff_port_SOURCES} libtiff.def)
target_include_directories(tiffdll
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}>
${TIFF_INCLUDES}
)
target_link_libraries(tiffdll ${TIFF_LIBRARY_DEPS})
set_target_properties(tiffdll PROPERTIES SOVERSION ${SO_COMPATVERSION})
# 静态库工程
add_library(tifflib STATIC ${tiff_SOURCES} ${tiff_HEADERS} ${nodist_tiff_HEADERS} ${tiff_port_SOURCES})
target_include_directories(tifflib
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}>
${TIFF_INCLUDES})
target_link_libraries(tiffdll ${TIFF_LIBRARY_DEPS})
# vs编译器特化设置
if(MSVC)
# mt动态库工程
add_library(tiffdllmt SHARED ${tiff_SOURCES} ${tiff_HEADERS} ${nodist_tiff_HEADERS} ${tiff_port_SOURCES} libtiff.def)
target_include_directories(tiffdllmt PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}>
${TIFF_INCLUDES})
target_link_libraries(tiffdllmt ${TIFF_LIBRARY_DEPS_MT})
set_target_properties(tiffdllmt PROPERTIES SOVERSION ${SO_COMPATVERSION})
set_property(TARGET tiffdllmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
# mt静态库工程
add_library(tifflibmt STATIC ${tiff_SOURCES} ${tiff_HEADERS} ${nodist_tiff_HEADERS} ${tiff_port_SOURCES})
target_include_directories(tifflibmt
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}>
${TIFF_INCLUDES})
target_link_libraries(tifflibmt ${TIFF_LIBRARY_DEPS_MT})
set_property(TARGET tifflibmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
endif()
if(NOT CYGWIN)
# This property causes shared libraries on Linux to have the full version
# encoded into their final filename. We disable this on Cygwin because
# it causes cygz-${TIFF_FULL_VERSION}.dll to be created when cygz.dll
# seems to be the default.
set_target_properties(tiffdll PROPERTIES VERSION ${SO_VERSION})
endif()
if(HAVE_LD_VERSION_SCRIPT)
set_target_properties(tiffdll PROPERTIES LINK_FLAGS
"-Wl,--version-script=${CMAKE_CURRENT_SOURCE_DIR}/libtiff.map")
endif()
#安装sdk相关文件
#安装库文件
install(TARGETS tiffdll tifflib tiffdllmt tifflibmt
RUNTIME DESTINATION "${INSTALL_BIN_DIR}"
ARCHIVE DESTINATION "${INSTALL_LIB_DIR}"
LIBRARY DESTINATION "${INSTALL_LIB_DIR}")
#安装头文件
install(FILES ${tiff_HEADERS} ${nodist_tiff_HEADERS} DESTINATION "${INSTALL_INC_DIR}")
#c++的项目
if(CXX_SUPPORT)
#动态库
add_library(tiffxxdll SHARED ${tiffxx_SOURCES} ${tiffxx_HEADERS})
target_link_libraries(tiffxxdll tiffdll)
set_target_properties(tiffxxdll PROPERTIES SOVERSION ${SO_COMPATVERSION})
#静态库
add_library(tiffxxlib STATIC ${tiffxx_SOURCES} ${tiffxx_HEADERS})
target_link_libraries(tiffxxlib tiffdll)
# vs编译器特化设置
if(MSVC)
# mt动态库工程
add_library(tiffxxdllmt SHARED ${tiffxx_SOURCES} ${tiffxx_HEADERS})
target_link_libraries(tiffxxdllmt tiffdllmt)
set_target_properties(tiffxxdllmt PROPERTIES SOVERSION ${SO_COMPATVERSION})
set_property(TARGET tiffxxdllmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
# mt静态库工程
add_library(tiffxxlibmt STATIC ${tiffxx_SOURCES} ${tiffxx_HEADERS})
target_link_libraries(tiffxxlibmt tiffdllmt ${TIFF_LIBRARY_DEPS_MT})
set_property(TARGET tiffxxlibmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
# 查找pdb文件
file(GLOB_RECURSE TIFF_DEBUG_SYMBOLS "${PROJECT_BINARY_DIR}/output/"
FILES_MATCHING PATTERN "*.pdb")
endif()
if(NOT CYGWIN)
# This property causes shared libraries on Linux to have the full version
# encoded into their final filename. We disable this on Cygwin because
# it causes cygz-${TIFF_FULL_VERSION}.dll to be created when cygz.dll
# seems to be the default.
set_target_properties(tiffxxdll PROPERTIES VERSION ${SO_VERSION})
endif()
if(HAVE_LD_VERSION_SCRIPT)
set_target_properties(tiffxxdll PROPERTIES LINK_FLAGS
"-Wl,--version-script=${CMAKE_CURRENT_SOURCE_DIR}/libtiffxx.map")
endif()
install(TARGETS tiffxxdll tiffxxlib tiffxxdllmt tiffxxlibmt
RUNTIME DESTINATION "${INSTALL_BIN_DIR}"
ARCHIVE DESTINATION "${INSTALL_LIB_DIR}"
LIBRARY DESTINATION "${INSTALL_LIB_DIR}")
install(FILES ${tiffxx_HEADERS}
DESTINATION "${INSTALL_INC_DIR}")
endif()
#安装pdb文件
if(NOT SKIP_INSTALL_PDB AND NOT SKIP_INSTALL_ALL)
# 查找pdb文件
file(GLOB_RECURSE TIFF_DEBUG_SYMBOLS "${PROJECT_BINARY_DIR}/output/tiff*.pdb")
message(STATUS "TIFF_DEBUG_SYMBOLS:${TIFF_DEBUG_SYMBOLS}")
install(FILES ${TIFF_DEBUG_SYMBOLS} DESTINATION "${INSTALL_BIN_DIR}")
endif()
1.3.3.vs2008编译
CMakeLists.txt文件调整好之后,只需要使用CMake工具生成vs2008的工程即可,操作步骤按下面描述操作即可。
1.3.3.1.cmake构建目录设置
选择源代码根目录(CMakeLists.txt文件在这个目录),设置build目录为源代码根目录下的cmake-vs2008绝对路径为D:/x-app/depends/c/tiff-4.0.10/cmake-vs2008,保证源代码目录干净,会生成工程和临时文件,同时也方便后续有其他的构建工具扩展管理。
1.3.3.2.应用CMake配置
点击“Configure”会弹出编译器选择对话框,这里选择“Visual Studio 9 2008”点击“Finish”按钮等待配置参数完成。
1.3.3.3.生成vs解决方案
下面的红色警告忽略不用管,意思是未来的cmake版本不再支持生成vs2008的解决方案。
1.3.3.4.编译工程
使用vs2008打开“tiff.sln”解决方案文件,分别编译Debug和RelWithDebInfo配置。
1.3.3.5.安装库文件、头文件
编译Install工程的Debug和RelWithDebInfo配置,.h文件和编译生成.dll、.lib、pdb文件会拷贝CMakeList.txt中设置的路径下。
至此通过一个CMakeLists配置文件将windows下vs2008常用编译类型的库全部编译出来了,最终库的对应关系如下。
库类型 | 运行库类型 | 库文件 |
动态库 | mdd | tiffdlld.dll、tiffdlld.lib |
md | tiffdll.dll、tiffdll.lib | |
mtd | tiffdllmtd.dll、tiffdllmtd.lib | |
mt | tiffdllmt.dll、tiffdllmt.lib | |
静态库 | mdd | tifflibd.lib |
md | tifflib.lib | |
mtd | tifflibmtd.lib | |
mt | tifflibmt.lib | |
表格中未列出tiffxx相关库文件,该库文件是c++导出方式的库文件 |
1.3.4.vs2015编译
vs2015编译与vs2008相同的,只需要在CMake生成工程时选择vs2015即可,其他版本的vs也是一样的,选择需要使用的vs版本即可,此处只演示一下vs2015的编译。
因为前面生成过vs2008的工程,需要将build目录设置成cmake-vs2015,再“Configure”选择vs2015即可,其他操作就是一样的了。