cmakeinstallprefix详解

一、cmake与cmakeinstallprefix

在进行C/C++项目开发的过程中，cmake作为一种跨平台的构建工具极受欢迎。其最大的优点在于将不同平台下的build system进行了抽象封装，开发者只需要用一套统一的语言来描述其代码的构建和安装过程，就可以实现跨平台完美的构建支持。而cmakeinstallprefix，则是其中重要的一个变量，它代表着安装目录的路径。

通常来说，一个CMake项目的构建和安装分为以下几步：

cmake .
make
make install

其中的cmake .对应的是代码的配置过程，这个命令会生成一个Makefile，然后通过make命令来编译源代码生成可执行文件。而make install则会将可执行文件、库文件和头文件等安装到configure时指定的路径下。

这个路径就是cmakeinstallprefix的值。对于一些默认安装路径，如/usr/local，可以通过以下命令查看其值：

cmake -LAH | grep INSTALL_PREFIX

而对于自定义安装路径，则需要在执行cmake命令时指定路径，如：

cmake -DCMAKE_INSTALL_PREFIX=/usr/local/mypath .

这样编译安装后，安装路径就会变成/usr/local/mypath。

二、使用cmakeinstallprefix的意义

使用cmakeinstallprefix可以让开发者将代码编译成一个可执行文件，而这个可执行文件甚至可以在不同的机器上进行安装和使用。这就大大方便了开发者进行代码的部署和分享。

此外，cmakeinstallprefix还可以用来设置安装路径的默认位置。一些常用的默认安装路径如下：

/usr/local
/usr
/opt
/Library/Frameworks

其中，/usr/local是最常被使用的，默认的安装位置为/usr/local，如果要安装到别的位置需要手动指定。而/opt一般被用来安装那些不包含在distro中，而是单独下载的软件包。

三、cmakeinstallprefix的使用方法

下面是使用cmakeinstallprefix的一个完整案例，其将源代码编译并安装到指定路径/usr/local/myApp中：

cmake_minimum_required(VERSION 2.8.7)
 
project(myApp)
 
set(CMAKE_INSTALL_PREFIX /usr/local/myApp)
 
add_executable(myApp main.cpp)
 
install(TARGETS myApp DESTINATION bin)

这里，set命令用于设置CMAKE_INSTALL_PREFIX的值，即将源代码安装到/usr/local/myApp中。add_executable用于源代码编译，install用于安装bin下的可执行文件myApp到指定目录。

值得注意的是，在Unix系统中，/usr通常存放系统文件，而/usr/local则用于存放用户自己安装的应用程序文件。而在Windows系统中，cmakeinstallprefix的默认安装位置是C:\Program Files\。

四、cmakeinstallprefix的陷阱

在使用cmakeinstallprefix的过程中，可能会碰到一些坑，以下是一些常见的陷阱：

1. CMAKE_INSTALL_PREFIX在CMakeCache.txt中留存的值：

CMakeCache.txt是一个用于存储cmake变量值的文件。在使用cmake命令时，cmake会尝试在当前路径下查找CMakeCache.txt，如果它存在，那么CMAKE_INSTALL_PREFIX的值就会被替换成CMakeCache.txt中的值。

2. CMAKE_INSTALL_PREFIX错误的设置：

如果将CMAKE_INSTALL_PREFIX设置为一个与Unix系统相关的路径，则在Windows系统下进行安装时，可能会发生一些奇怪的问题。同样，如果将CMAKE_INSTALL_PREFIX设置为C:\Program Files等Windows系统中用于存放用户数据的目录，可能会因权限问题导致安装失败。

3. CMAKE_INSTALL_PREFIX意外的修改：

当执行安装命令make install时，很有可能在安装过程中修改了CMAKE_INSTALL_PREFIX的值，这时可能会导致安装目录错误。解决这个问题的方法是在执行安装命令时指定路径，如：

make install DESTDIR=/usr/local/myApp

这样安装后，可执行文件就会被放置到/usr/local/myApp/bin目录下。

五、总结

综上所述，cmakeinstallprefix是一个非常重要的CMake变量，它代表着编译后可执行文件的安装位置。使用cmakeinstallprefix可以让开发者将代码编译成一个可执行文件，而这个可执行文件甚至可以在不同的机器上进行安装和使用。此外，它还可以用来设置安装路径的默认位置。

在使用cmakeinstallprefix时，需要注意一些常见的陷阱，如CMakeCache.txt中的值、错误的设置以及安装过程中的值意外修改等问题。

因此，灵活的使用cmakeinstallprefix对于CMake项目的构建和运行都是至关重要的。

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/154950.html