# 5.1 使用平臺無關的文件操作 **NOTE**:*此示例代碼可以在 https://github.com/dev-cafe/cmake-cookbook/tree/v1.0/chapter-5/recipe-01 中找到，其中包含一個C++例子。該示例在CMake 3.5版(或更高版本)中是有效的，并且已經在GNU/Linux、macOS和Windows上進行過測試。* 有些項目構建時，可能需要與平臺的文件系統進行交互。也就是檢查文件是否存在、創建新文件來存儲臨時信息、創建或提取打包文件等等。使用CMake不僅能夠在不同的平臺上生成構建系統，還能夠在不復雜的邏輯情況下，進行文件操作，從而獨立于操作系統。本示例將展示，如何以可移植的方式下載庫文件。 ## 準備工作 我們將展示如何提取Eigen庫文件，并使用提取的源文件編譯我們的項目。這個示例中，將重用第3章第7節的線性代數例子` linear-algebra.cpp `，用來檢測外部庫和程序、檢測特征庫。這里，假設已經包含Eigen庫文件，已在項目構建前下載。 ## 具體實施 項目需要解壓縮Eigen打包文件，并相應地為目標設置包含目錄: 1. 首先，使能C++11項目: ```cmake cmake_minimum_required(VERSION 3.5 FATAL_ERROR) project(recipe-01 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_EXTENSIONS OFF) set(CMAKE_CXX_STANDARD_REQUIRED ON) ``` 2. 我們將自定義目標添加到構建系統中，自定義目標將提取構建目錄中的庫文件: ```cmake add_custom_target(unpack-eigen ALL COMMAND ${CMAKE_COMMAND} -E tar xzf ${CMAKE_CURRENT_SOURCE_DIR}/eigen-eigen-5a0156e40feb.tar.gz COMMAND ${CMAKE_COMMAND} -E rename eigen-eigen-5a0156e40feb eigen-3.3.4 WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Unpacking Eigen3 in ${CMAKE_CURRENT_BINARY_DIR}/eigen-3.3.4" ) ``` 3. 為源文件添加了一個可執行目標: ```cmake add_executable(linear-algebra linear-algebra.cpp) ``` 4. 由于源文件的編譯依賴于Eigen頭文件，需要顯式地指定可執行目標對自定義目標的依賴關系: ```cmake add_dependencies(linear-algebra unpack-eigen) ``` 5. 最后，指定包含哪些目錄: ```cmake target_include_directories(linear-algebra PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/eigen-3.3.4 ) ``` ## 工作原理 細看` add_custom_target `這個命令： ```cmake add_custom_target(unpack-eigen ALL COMMAND ${CMAKE_COMMAND} -E tar xzf ${CMAKE_CURRENT_SOURCE_DIR}/eigen-eigen-5a0156e40feb.tar.gz COMMAND ${CMAKE_COMMAND} -E rename eigen-eigen-5a0156e40feb eigen-3.3.4 WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Unpacking Eigen3 in ${CMAKE_CURRENT_BINARY_DIR}/eigen-3.3.4" ) ``` 構建系統中引入了一個名為`unpack-eigen`的目標。因為我們傳遞了`ALL`參數，目標將始終被執行。`COMMAND`參數指定要執行哪些命令。本例中，我們希望提取存檔并將提取的目錄重命名為`egan -3.3.4`，通過以下兩個命令實現: ```shell ${CMAKE_COMMAND} -E tar xzf ${CMAKE_CURRENT_SOURCE_DIR}/eigen-eigen- 5a0156e40feb.tar.gz ${CMAKE_COMMAND} -E rename eigen-eigen-5a0156e40feb eigen-3.3.4 ``` 注意，使用`-E`標志調用CMake命令本身來執行實際的工作。對于許多常見操作，CMake實現了一個對所有操作系統都通用的接口，這使得構建系統獨立于特定的平臺。`add_custom_target`命令中的下一個參數是工作目錄。我們的示例中，它對應于構建目錄：`CMAKE_CURRENT_BINARY_DIR`。最后一個參數`COMMENT`，用于指定CMake在執行自定義目標時輸出什么樣的消息。 ## 更多信息 構建過程中必須執行一系列沒有輸出的命令時，可以使用`add_custom_target`命令。正如我們在本示例中所示，可以將自定義目標指定為項目中其他目標的依賴項。此外，自定義目標還可以依賴于其他目標。 使用`-E`標志可以以與操作系統無關的方式，運行許多公共操作。運行`cmake -E`或`cmake -E help`可以獲得特定操作系統的完整列表。例如，這是Linux系統上命令的摘要: ```shell Usage: cmake -E <command> [arguments...] Available commands: capabilities - Report capabilities built into cmake in JSON format chdir dir cmd [args...] - run command in a given directory compare_files file1 file2 - check if file1 is same as file2 copy <file>... destination - copy files to destination (either file or directory) copy_directory <dir>... destination - copy content of <dir>... directories to 'destination' directory copy_if_different <file>... destination - copy files if it has changed echo [<string>...] - displays arguments as text echo_append [<string>...] - displays arguments as text but no new line env [--unset=NAME]... [NAME=VALUE]... COMMAND [ARG]... - run command in a modified environment environment - display the current environment make_directory <dir>... - create parent and <dir> directories md5sum <file>... - create MD5 checksum of files sha1sum <file>... - create SHA1 checksum of files sha224sum <file>... - create SHA224 checksum of files sha256sum <file>... - create SHA256 checksum of files sha384sum <file>... - create SHA384 checksum of files sha512sum <file>... - create SHA512 checksum of files remove [-f] <file>... - remove the file(s), use -f to force it remove_directory dir - remove a directory and its contents rename oldname newname - rename a file or directory (on one volume) server - start cmake in server mode sleep <number>... - sleep for given number of seconds tar [cxt][vf][zjJ] file.tar [file/dir1 file/dir2 ...] - create or extract a tar or zip archive time command [args...] - run command and display elapsed time touch file - touch a file. touch_nocreate file - touch a file but do not create it. Available on UNIX only: create_symlink old new - create a symbolic link new -> old ```