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項目的構建和運行都是至關重要的。