在 CMake 入门1/5:基于阿里云 ECS搭建体验环境 ,我们搭建了 CMake的运行环境,下面我们以 helloworld 为例,体验 CMake 工作的基本流程。
1 源文件说明
共包含2个文件,一个 c++文件 helloworld.cpp,另一个是CMakeLists.txt。也可到这里下载:
https://github.com/huangjunlei/How2Work/tree/master/DevOps/cmakedemo1.1 helloworld.cpp
helloworld.cpp为你开发的源码文件,自由命名,自由书写内容。
#include<iostream>
int main(int argc, char *argv[]){
std::cout << "Hello World!" << std::endl;
return 0;
}
1.2 CMakeLists.txt
CMakeLists.txt为 cmake 工作的输入文件,命名固定,格式语法固定,以下为示例,实际开发中要根据工程结构来编写。
cmake_minimum_required(VERSION 2.8.9)
project (hello)
add_executable(hello helloworld.cpp)
第1行声明需要的最低 cmake版本
完整语法为
cmake_minimum_required(VERSION major[.minor[.patch[.tweak]]] [FATAL_ERROR])
扩展阅读:
https://cmake.org/cmake/help/v2.8.12/cmake.html#command:cmake_minimum_required第2行声明项目名
完整语法为:
project(<projectname> [languageName1 languageName2 ... ] )
https://cmake.org/cmake/help/v2.8.12/cmake.html#command:project 第3行声明执行体名称及源码列表
完整语法如下:
add_executable(<name> [WIN32] [MACOSX_BUNDLE]
[EXCLUDE_FROM_ALL]
source1 source2 ... sourceN)
https://cmake.org/cmake/help/v2.8.12/cmake.html#command:add_executable 2 编译过程
2.1 生成 Makefile
cmake 的命令形式为:
cmake [options] <path-to-source>
cmake [options] <path-to-existing-build>
https://cmake.org/cmake/help/v2.8.12/cmake.html#section_Usage Demo示例执行过程如下:
[root@myecs]# cmake .
-- The C compiler identification is GNU 4.8.5
-- The CXX compiler identification is GNU 4.8.5
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/cmakedemo/demo1
解释
首先,CMake检测运行环境,如没有 c++编译器会报附件三的错误;检测通过后,CMake 会生成工程所对应的 Makefile。需要强调的是,Makefile允许查看,但不要尝试编辑,而且下次执行时它也会被覆盖。
2.2 查看生成结果
[root@myecs]# ls
CMakeCache.txt CMakeFiles cmake_install.cmake CMakeLists.txt helloworld.cpp Makefile
[root@myecs]# ls -l Makefile
-rw-r--r-- 1 root root 4767 1月 30 20:04 Makefile
[root@myecs]# more Makefile
# CMAKE generated file: DO NOT EDIT!
# Generated by "Unix Makefiles" Generator, CMake Version 2.8
......
# because they might be regenerated.
cmake_check_build_system:
$(CMAKE_COMMAND) -H$(CMAKE_SOURCE_DIR) -B$(CMAKE_BINARY_DIR) --check-build-system CMakeFiles/Makefile.cmake 0
.PHONY : cmake_check_build_system
2.3 编译
在 Makefile 生成后,可以使用make 进行编译工程。
[root@myecs]# make
Scanning dependencies of target hello
[100%] Building CXX object CMakeFiles/hello.dir/helloworld.cpp.o
Linking CXX executable hello
[100%] Built target hello
2.4 查看编译结果
[root@myecs]# ls
CMakeCache.txt CMakeFiles cmake_install.cmake CMakeLists.txt hello helloworld.cpp Makefile
[root@myecs]# ls -l hello
-rwxr-xr-x 1 root root 9176 1月 30 20:13 hello
2.5 执行著名程序 helloworld
[root@myecs]# ./hello
Hello World!
至此 cmake 使用完整流程就结束了。当然对于 helloworld 这个程序,有些杀鸡用牛刀,但利于整体理解 cmake 的应用流程。