始终指定以下版本的最低要求 cmake
cmake_minimum_required(VERSION 3.9)
您应该声明一个项目。cmake
表示这是强制性的,它将定义方便的变量PROJECT_NAME
,PROJECT_VERSION
并且PROJECT_DESCRIPTION
(后一个变量需要cmake 3.9):
project(mylib VERSION 1.0.1 DESCRIPTION "mylib description")
声明一个新的库目标。请避免使用file(GLOB ...)
。此功能不提供对编译过程的熟练掌握。如果您很懒,请复制粘贴输出ls -1 sources/*.cpp
:
add_library(mylib SHARED
sources/animation.cpp
sources/buffers.cpp
[...]
)
设置VERSION
属性(可选,但这是一个好习惯):
set_target_properties(mylib PROPERTIES VERSION ${PROJECT_VERSION})
您还可以设置SOVERSION
的主要数量VERSION
。因此libmylib.so.1
将是的符号链接libmylib.so.1.0.0
。
set_target_properties(mylib PROPERTIES SOVERSION 1)
声明您图书馆的公共API。将为第三方应用程序安装此API。将其隔离在项目树中是一个好习惯(例如将其放置在include/
目录中)。请注意,不应安装专用头,我强烈建议将它们与源文件放置在一起。
set_target_properties(mylib PROPERTIES PUBLIC_HEADER include/mylib.h)
如果您使用子目录,则包括这样的相对路径不是很方便"../include/mylib.h"
。因此,在包含的目录中传递顶级目录:
target_include_directories(mylib PRIVATE .)
要么
target_include_directories(mylib PRIVATE include)
target_include_directories(mylib PRIVATE src)
为您的库创建安装规则。我建议使用CMAKE_INSTALL_*DIR
在中定义的变量GNUInstallDirs
:
include(GNUInstallDirs)
并声明要安装的文件:
install(TARGETS mylib
LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
您也可以导出pkg-config
文件。此文件允许第三方应用程序轻松导入您的库:
创建一个名为的模板文件mylib.pc.in
( 有关更多信息,请参见pc(5)联机帮助页):
prefix=@CMAKE_INSTALL_PREFIX@
exec_prefix=@CMAKE_INSTALL_PREFIX@
libdir=${exec_prefix}/@CMAKE_INSTALL_LIBDIR@
includedir=${prefix}/@CMAKE_INSTALL_INCLUDEDIR@
Name: @PROJECT_NAME@
Description: @PROJECT_DESCRIPTION@
Version: @PROJECT_VERSION@
Requires:
Libs: -L${libdir} -lmylib
Cflags: -I${includedir}
在您的中CMakeLists.txt
,添加一个规则以扩展@
宏(@ONLY
要求cmake不扩展形式的变量${VAR}
):
configure_file(mylib.pc.in mylib.pc @ONLY)
最后,安装生成的文件:
install(FILES ${CMAKE_BINARY_DIR}/mylib.pc DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/pkgconfig)
您也可以使用cmake EXPORT
功能。但是,此功能仅与兼容,cmake
我觉得很难使用。
最后,整个CMakeLists.txt
外观应类似于:
cmake_minimum_required(VERSION 3.9)
project(mylib VERSION 1.0.1 DESCRIPTION "mylib description")
include(GNUInstallDirs)
add_library(mylib SHARED src/mylib.c)
set_target_properties(mylib PROPERTIES
VERSION ${PROJECT_VERSION}
SOVERSION 1
PUBLIC_HEADER api/mylib.h)
configure_file(mylib.pc.in mylib.pc @ONLY)
target_include_directories(mylib PRIVATE .)
install(TARGETS mylib
LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
install(FILES ${CMAKE_BINARY_DIR}/mylib.pc
DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/pkgconfig)