菜鸟笔记
提升您的技术认知

cmake install的使用-ag真人游戏

这里主要介绍使用cmake进行install方面的操作:

通过cmake可以 安装的内容可以包括目标二进制、动态库、静态库以及文件、目录、脚本等,下面分别进行简述一下:

细节可以参考ag真人试玩娱乐官网,这里简单描述一下

install(targets targets... [export ]
        [runtime_dependencies args...|runtime_dependency_set ]
        [[archive|library|runtime|objects|framework|bundle|
          private_header|public_header|resource]
         [destination ]
         [permissions permissions...]
         [configurations [debug|release|...]]
         [component ]
         [namelink_component ]
         [optional] [exclude_from_all]
         [namelink_only|namelink_skip]
        ] [...]
        [includes destination [ ...]]
        )

下表显示了目标类型及其关联变量和内置默认值,这些默认值适用于未指定目标的情况:

目标类型

gnuinstalldirs 变量

内置默认值

runtime

${cmake_install_bindir}

bin

library

${cmake_install_libdir}

lib

archive

${cmake_install_libdir}

lib

private_header

${cmake_install_includedir}

include

public_header

${cmake_install_includedir}

include

参数中的targets后面跟的就是我们通过add_executable 或者add_library 定义的目标文件,可能是可执行二进制、动态库、静态库。
目标类型也就相对应的有三种,archive特指静态库,library特指动态库,runtime特指可执行目标二进制。
destination定义了安装的路径,如果路径以/开头,那么指的是绝对路径,这时候cmake_install_prefix其实就无效了.
如果你希望使用cmake_install_prefix来定义安装路径,就要写成相对路径,即不要以/开头,那么安装后的路径就是${cmake_install_prefix}/
举个简单的例子:

install(targets myrun mylib mystaticlib
runtime destination bin
library destination lib
archive destination libstatic
)

上面的例子会将:
可执行二进制myrun 安装到${cmake_install_prefix}/bin 目录
动态库libmylib安装到${cmake_install_prefix}/lib目录
静态库libmystaticlib 安装到${cmake_install_prefix}/libstatic目录
特别注意的是你不需要关心targets具体生成的路径,只需要写上targets名称就可以
了。

install( files...
        type  | destination 
        [permissions permissions...]
        [configurations [debug|release|...]]
        [component ]
        [rename ] [optional] [exclude_from_all])

type argument

gnuinstalldirs variable

built-in default

bin

${cmake_install_bindir}

bin

sbin

${cmake_install_sbindir}

sbin

lib

${cmake_install_libdir}

lib

include

${cmake_install_includedir}

include

sysconf

${cmake_install_sysconfdir}

etc

sharedstate

${cmake_install_sharestatedir}

com

localstate

${cmake_install_localstatedir}

var

runstate

${cmake_install_runstatedir}

/run

data

${cmake_install_datadir}

info

${cmake_install_infodir}

/info

locale

${cmake_install_localedir}

/locale

man

${cmake_install_mandir}

/man

doc

${cmake_install_docdir}

/doc

可用于安装一般文件,并可以指定访问权限,文件名是此指令所在路径下的相对路径。如果默认不定义权限permissions,安装后的权限为:
owner_write, owner_read, group_read,和world_read,即 644权限。 

install(directory dirs...
        type  | destination 
        [file_permissions permissions...]
        [directory_permissions permissions...]
        [use_source_permissions] [optional] [message_never]
        [configurations [debug|release|...]]
        [component ] [exclude_from_all]
        [files_matching]
        [[pattern  | regex ]
         [exclude] [permissions permissions...]] [...])

这里主要介绍其中的directory、pattern 以及 permissions 参数。
directory 后面连接的是所在source目录的相对路径,但务必注意:abc和 abc/有很大的区别。
如果目录名不以/结尾,那么这个目录将被安装为目标路径下的abc,如果目录名以/结尾,
代表将这个目录中的内容安装到目标路径,但不包括这个目录本身。
pattern用于使用正则表达式进行过滤,permissions用于指定pattern过滤后的文件权限。
我们来看一个例子:

install(directory icons scripts/ destination share/myproj
pattern "cvs" exclude
pattern "scripts/*"
permissions owner_execute owner_write owner_read
group_execute group_read)

这条指令的执行结果是:
将icons 目录安装到 /share/myproj,将 scripts/中的内容安装到
/share/myproj
不包含目录名为cvs的目录,对于scripts/* 文件指定权限为 owner_execute
owner_write owner_read group_execute group_read.

这里测试一下:根据上一篇的文章进行安装测试:

修改根目录下的cmakelists.txt文件如下,其实就增加了install,这里你需要先创建几个文件,才能尝试安装:

# 多个目录多个源文件
cmake_minimum_required(version 2.8)
project(test1)
# 遍历当前目录的所有文件并使用dir_srcs保存,也可以通过set(src_list main.c)进行指定
aux_source_directory(. dir_srcs)
# 添加生成可执行文件的保存目录,不会保存中间产物,如果不指定该目录则和中间产物保存在一起
set(executable_output_path ${project_binary_dir}/bin )
# 添加头文件
include_directories(${project_source_dir}/include)
# 这里将子目录条件到工程,并指定编译的输出产物,默认输出产物保存到build/src文件夹下,
# 如果不指定库目录保存路径同样也会保存到该路径下
add_subdirectory(src)
# 上面定义了将src子目录加入工程,并指定编译输出(包含编译中间结果)路径为
# bin目录。如果不进行 bin目录的指定,那么编译结果(包括中间结果)都将存放在
# build/src 目录(这个目录跟原有的src目录对应),指定 bin 目录后,相当于在编译时
# 将src重命名为bin,所有的中间结果和目标二进制都将存放在bin目录。
# 指定生成目标
add_executable(test1 main.cpp)
# 添加链接库
# 把子目录集src的编译成的库文件链接到这里
target_link_libraries(test1 add)
message(status  ${project_source_dir} "------完成编译和链接生成可执行文件-----")
# 添加安装信息如ag真人试玩娱乐 copyright readme
install(files ag真人试玩娱乐 copyright readme.md destination share/doc/cmake/test)
# 安装runtest.sh
install(programs runtest.sh destination bin)
# 这里按照doc目录下的文件
install(directory doc/ destination share/doc/cmake/test)

进入build,执行如下命令:

cmake -dcmake_install_prefix=/home/ubuntu/work/usr ..
make
make install 

这是只是测试使用,因此安装在home/ubuntu/work/usr下,也可以默认安装,默认安装的路径为:

如果我没有定义cmake_install_prefix会安装到什么地方?
你可以尝试以下,cmake ..;make;make install,你会发现
cmake_install_prefix的默认定义是/usr/local

网站地图