CMake构建学习笔记23-SQLite库的构建

1. 构建思路

在前文中构建了大量的库包程序（参看CMake构建学习笔记-目录）之后，可以总结一下在Windows下使用脚本构建程序的办法：

• 使用CMake构建。这是目前最通用最流行的构建方式，大部分C/C++程序都在逐渐向这个方向转。
  
• 使用namke构建。在CMake流行之前，有的程序会提供MSVC项目文件，这种情况下可以使用namke来进行构建。
  
• 使用MSYS2/MinGW构建。适用于只提供了Linux环境构建方式的程序，不过可能会有二进制兼容问题，一般不推荐。
  
• 使用第三方的项目构建。比如自己组织CMake项目，或者使用vcpkg这样的库包管理工具直接安装。
  

2. 构建SQLite

SQLite是一个轻量级的、无需独立服务器进程的嵌入式关系型数据库。它将整个数据库（包括表、索引和数据）存储在一个单一的磁盘文件中，支持标准的SQL语法，广泛用于嵌入式设备、移动应用和小型Web项目。SQLite是一个老牌的C库，不提供CMake的构建方式，而且它还是个可执行程序而不仅仅是库，这给程序的集成带来一定的麻烦。
那么如何在Windows下将SQLite构建成库文件呢？这里选择第4种方案，根据源代码文件生成CMake项目。SQLite提供了一个很不错的特性，就是支持将所有的实现代码组合成一个sqlite.c文件，因此自己组织CMake项目就比较简单，组织结构如下：
project-root/
├── include/
│   ├── sqlite3.h
│   └── sqlite3ext.h
├── src/
│   └── sqlite3.c
├── CMakeLists.txt
├── CMakePresets.json
└── sqlite3.def
源代码sqlite.c、sqlite3.h、sqlite3ext.h是SQLite的源代码文件，不用进行修改。需要注意的是SQLite提供两种源代码文件，一种是分散组织的，一种是组合成单文件的，一定要选择后者才能看到sqlite.c文件（比如sqlite-amalgamation-3460000.zip）。
另外，sqlite3.def是模块定义文件，为Windows的DLL模块定义各种属性和导出符号。如果是像笔者一样需要构建成动态库，那么这个文件一定要有。这个文件可以在SQLite提供预编译包种找到（比如sqlite-dll-win-x64-3460000）。
最后，CMakeLists.txt中的内容如下：

1. # 输出cmake版本提示
2. message(STATUS "The CMAKE_VERSION is ${CMAKE_VERSION}.")
4. # cmake的最低版本要求
5. cmake_minimum_required (VERSION 3.10)
7. # 工程名称、版本、语言
8. project(sqlite3 VERSION 3.4.6)
10. # 支持当前目录
11. set(CMAKE_INCLUDE_CURRENT_DIR ON)
13. # 判断编译器类型
14. message("CMAKE_CXX_COMPILER_ID: ${CMAKE_CXX_COMPILER_ID}")
16. # 判断编译器类型
17. if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Clang")
18.     message(">> using Clang")
19. elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU")
20.     message(">> using GCC")
21. elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Intel")
22.     message(">> using Intel C++")
23. elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC")
24.     message(">> using Visual Studio C++")          
25.     add_compile_options(/utf-8)
26. else()
27.     message(">> unknow compiler.")
28. endif()
30. # 设置编译定义
31. set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} \
32. -DSQLITE_THREADSAFE=1 \
33. -DSQLITE_ENABLE_COLUMN_METADATA \
34. -DSQLITE_ENABLE_PREUPDATE_HOOK \
35. -DSQLITE_ENABLE_RTREE \
36. -DSQLITE_ENABLE_GEOPOLY \
37. -DSQLITE_ENABLE_SESSION \
38. -DSQLITE_ENABLE_RBU")
40. # 源代码文件
41. set(INCLUDE_FILES
42.     ./include/sqlite3.h
43.     ./include/sqlite3ext.h
44. )
45. set(SOURCE_FILES
46.     ./src/sqlite3.c
47.     ${INCLUDE_FILES}
48. )
50. # 动态库前缀与后缀
51. IF(CMAKE_SYSTEM_NAME MATCHES "Linux")
52.         set(LibraryPrefix lib)
53.     set(LibraryPostfix so)
54. ELSEIF(CMAKE_SYSTEM_NAME MATCHES "Windows")
55.         set(LibraryPrefix )
56.     set(LibraryPostfix lib)
57. ENDIF()
60. # 将源代码添加到此项目的可执行文件。
61. add_library(${PROJECT_NAME} SHARED ${SOURCE_FILES})
63. if(CMAKE_SYSTEM_NAME MATCHES "Windows")   
64.     # 指定.def文件
65.     set_target_properties(${PROJECT_NAME} PROPERTIES
66.     OUTPUT_NAME ${PROJECT_NAME}
67.     LINK_FLAGS "/DEF:${CMAKE_CURRENT_SOURCE_DIR}/sqlite3.def")
68. endif()
70. # TODO: 如有需要，请添加测试
72. # 安装头文件到 include 目录
73. install(DIRECTORY include/ DESTINATION include)
75. # 安装库文件到 lib 目录
76. install(TARGETS ${PROJECT_NAME}
77.         LIBRARY DESTINATION lib  # 对于共享库
78.         ARCHIVE DESTINATION lib  # 对于静态库
79.         RUNTIME DESTINATION bin  # 对于可执行文件
80. )

复制代码

然后执行如下脚本指令：

1. cmake $SourceLocalPath `
2.     -B "$BuildDir" `
3.     -G "$Generator" `
4.     -A x64 `
5.     -DCMAKE_CONFIGURATION_TYPES=RelWithDebInfo `
6.     -DCMAKE_INSTALL_PREFIX="$InstallDir"
8. # 构建阶段，指定构建类型
9. cmake --build $BuildDir --config RelWithDebInfo
11. # 安装阶段，指定构建类型和安装目标
12. cmake --build $BuildDir --config RelWithDebInfo --target install

复制代码

即可完成编译、链接到安装的完整构建过程。$SourceLocalPath是源代码目录，也就是前面的CMake项目文件夹；$BuildDir是构建目录文件夹；"$Generator"是生成器，比如Visual Studio 16 2019。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！