本文操作按照《c&c++开源库编译指南》中内容规范编写,编译环境配置、工具下载、目录规划,及更多其他开源库编译方法请参考该文章。
c&c++开源库编译指南:https://blog.youkuaiyun.com/binary0006/article/details/144086155
本文章中的源代码已提交到gitee仓库,地址:https://gitee.com/binary0010/depends/tree/master/c/bzip2-1.0.8
1.bzip2编译
1.1.源代码下载
源代码下载地址:ftp://sourceware.org/pub/bzip2/,直接下载最新版1.0.8版本,点击下图所示链接直接下载即可。
也可以自己复制这个地址下载:ftp://sourceware.org/pub/bzip2/bzip2-1.0.8.tar.gz
1.2.windows编译
先解压源代码到指定目录,查看bzip2代码目录,里面提供了vc5.0的工程(不要问为什么不是vc6.0,打开文件看一下就知道了)。
1.2.1.创建CMake脚本
bizp2源代码中不提供CMakeList.txt脚本编译,这里我们自己创建一个CMakeList.txt脚本文件,编辑脚本内容如下。
make_minimum_required(VERSION 2.4.4...3.15.0)
set(CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS ON)
project(bzip2 C)
set(VERSION "1.0.8")
include(../../cmake/third-common.cmake)
option(BZIP2_BUILD_EXAMPLES "Enable BZIP2 Examples" OFF)
set(INSTALL_BIN_DIR "${third-bin}/${PROJECT_NAME}-${VERSION}" CACHE PATH "Installation directory for executables")
set(INSTALL_LIB_DIR "${third-lib}/${PROJECT_NAME}-${VERSION}" CACHE PATH "Installation directory for libraries")
set(INSTALL_INC_DIR "${third-include}/${PROJECT_NAME}-${VERSION}" CACHE PATH "Installation directory for headers")
set(INSTALL_MAN_DIR "${CMAKE_INSTALL_PREFIX}/share/man" CACHE PATH "Installation directory for manual pages")
set(INSTALL_PKGCONFIG_DIR "${CMAKE_INSTALL_PREFIX}/share/pkgconfig" CACHE PATH "Installation directory for pkgconfig (.pc) files")
include(CheckTypeSize)
include(CheckFunctionExists)
include(CheckIncludeFile)
include(CheckCSourceCompiles)
enable_testing()
check_include_file(sys/types.h HAVE_SYS_TYPES_H)
check_include_file(stdint.h HAVE_STDINT_H)
check_include_file(stddef.h HAVE_STDDEF_H)
#
# Check to see if we have large file support
#
set(CMAKE_REQUIRED_DEFINITIONS -D_LARGEFILE64_SOURCE=1)
# We add these other definitions here because CheckTypeSize.cmake
# in CMake 2.4.x does not automatically do so and we want
# compatibility with CMake 2.4.x.
if(HAVE_SYS_TYPES_H)
list(APPEND CMAKE_REQUIRED_DEFINITIONS -DHAVE_SYS_TYPES_H)
endif()
if(HAVE_STDINT_H)
list(APPEND CMAKE_REQUIRED_DEFINITIONS -DHAVE_STDINT_H)
endif()
if(HAVE_STDDEF_H)
list(APPEND CMAKE_REQUIRED_DEFINITIONS -DHAVE_STDDEF_H)
endif()
check_type_size(off64_t OFF64_T)
if(HAVE_OFF64_T)
add_definitions(-D_LARGEFILE64_SOURCE=1)
endif()
set(CMAKE_REQUIRED_DEFINITIONS) # clear variable
#
# Check for fseeko
#
check_function_exists(fseeko HAVE_FSEEKO)
if(NOT HAVE_FSEEKO)
add_definitions(-DNO_FSEEKO)
endif()
#
# Check for unistd.h
#
check_include_file(unistd.h Z_HAVE_UNISTD_H)
# ============================================================================
# bzip2
# ============================================================================
set(BZIP2_PUBLIC_HDRS
bzlib.h
)
set(BZIP2_PRIVATE_HDRS
bzlib_private.h
)
set(BZIP2_SRCS
blocksort.c
bzlib.c
compress.c
crctable.c
decompress.c
huffman.c
randtable.c
)
#动态库
add_library(bzip2dll SHARED ${BZIP2_PUBLIC_HDRS} ${BZIP2_PRIVATE_HDRS} ${BZIP2_SRCS} libbz2.def)
#静态库
add_library(bzip2lib STATIC ${BZIP2_PUBLIC_HDRS} ${BZIP2_PRIVATE_HDRS} ${BZIP2_SRCS})
# vs编译器特化设置
if(MSVC)
# mt动态库工程
add_library(bzip2dllmt SHARED ${BZIP2_PUBLIC_HDRS} ${BZIP2_PRIVATE_HDRS} ${BZIP2_SRCS} libbz2.def)
set_property(TARGET bzip2dllmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
# mt静态库工程
add_library(bzip2libmt STATIC ${BZIP2_PUBLIC_HDRS} ${BZIP2_PRIVATE_HDRS} ${BZIP2_SRCS})
set_property(TARGET bzip2libmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
endif()
if(NOT SKIP_INSTALL_LIBRARIES AND NOT SKIP_INSTALL_ALL)
install(TARGETS bzip2dll bzip2lib bzip2dllmt bzip2libmt
RUNTIME DESTINATION "${INSTALL_BIN_DIR}"
ARCHIVE DESTINATION "${INSTALL_LIB_DIR}"
LIBRARY DESTINATION "${INSTALL_LIB_DIR}")
endif()
if(NOT SKIP_INSTALL_HEADERS AND NOT SKIP_INSTALL_ALL)
install(FILES ${BZIP2_PUBLIC_HDRS} DESTINATION "${INSTALL_INC_DIR}")
endif()
if(NOT SKIP_INSTALL_FILES AND NOT SKIP_INSTALL_ALL)
install(FILES BZIP2.3 DESTINATION "${INSTALL_MAN_DIR}/man3")
endif()
# 安装pdb文件
if(NOT SKIP_INSTALL_PDB AND NOT SKIP_INSTALL_ALL)
# 查找pdb文件
file(GLOB_RECURSE BZIP2_DEBUG_SYMBOLS ${PROJECT_BINARY_DIR}/output/
FILES_MATCHING PATTERN "bzip2*.pdb")
install(FILES ${BZIP2_DEBUG_SYMBOLS} DESTINATION "${INSTALL_BIN_DIR}")
endif()
1.2.2.修改模块定义文件
修改源代码目录下的libbz2.def文件,删除掉最上面2行,最要目的是解决编译dll时的警告。
1.2.3.cmake构建目录设置
选择源代码根目录(CMakeLists.txt文件在这个目录),设置build目录为源代码根目录下的cmake-vs2008绝对路径为D:/x-app/depends/c/bzip2-1.0.8/cmake-vs2008,保证源代码目录干净,会生成工程和临时文件,同时也方便后续有其他的构建工具扩展管理。
1.2.3.1.应用CMake配置
点击“Configure”会弹出编译器选择对话框,这里选择“Visual Studio 9 2008”点击“Finish”按钮等待配置参数完成。
1.2.3.2.生成vs解决方案
下面的红色警告忽略不用管,意思是未来的cmake版本不再支持生成vs2008的解决方案。
1.2.3.3.编译工程
使用vs2008打开“bzip2.sln”解决方案文件,分别编译Debug和RelWithDebInfo配置。
1.2.3.4.安装库文件、头文件
编译Install工程的Debug和RelWithDebInfo配置,.h文件和编译生成.dll、.lib、pdb文件会拷贝CMakeList.txt中设置的路径下。
至此通过一个CMakeLists配置文件将windows下vs2008常用编译类型的库全部编译出来了,最终库的对应关系如下。
库类型 | 运行库类型 | 库文件 |
动态库 | mdd | bzip2dlld.dll、bzip2dlld.lib |
md | bzip2dll.dll、bzip2dll.lib | |
mtd | bzip2dllmtd.dll、bzip2dllmtd.lib | |
mt | bzip2dllmt.dll、bzip2dllmt.lib | |
静态库 | mdd | bzip2libd.lib |
md | bzip2lib.lib | |
mtd | bzip2libmtd.lib | |
mt | bzip2libmt.lib |
1.2.4.vs2015编译
vs2015编译与vs2008相同的,只需要在CMake生成工程时选择vs2015即可,其他版本的vs也是一样的,选择需要使用的vs版本即可,此处只演示一下vs2015的编译。
因为前面生成过vs2008的工程,需要将build目录设置成cmake-vs2015,再“Configure”选择vs2015即可,其他操作就是一样的了。