CMake 示例

1.需求

[1].使用第三方动/静太库

[2].本身代码部分编译为动/静态库

[3]多项目管理

原文转自:http://blog.****.net/shuyong1999/article/details/7108563

2.构建一个单独的项目

[1]目的:这个项目将生成可执行文件,动态和静态库。

先在workspace(or anywhere you like)下建立项目的目录(文件)结构:

workspace

|—— HelloWorld

|—— CMakeLists.txt

|—— include     Hello.h

|—— src             Hello.cpp, test.cpp, CMakeLists.txt

|—— build          (CMake外部构建时的使用的目录, 可任意指定)

[2]HelloWorld根目录下的CMakeLists.txt

# 声明CMake的最低要求版本
cmake_minimum_required(VERSION 2.8)
# 定义项目(工程)名称,
# 同时定义了以下默认变量:
# PROJECT_SOURCE_DIR 或 HELLO_SOURCE_DIR, 代指CMake开始构建的根目录(通常是项目根目录)
# PROJECT_BINARY_DIR 或 HELLO_BINARY_DIR, 代指CMake的编译目录(即执行cmake命令的目录)
PROJECT(HELLO)
# 添加参与编译的子目录
ADD_SUBDIRECTORY(src)

[3]Hello.h

#ifndef HELLO_H
#define HELLO_H
class Hello
{
public:
Hello(){}
void sayHello();
};
#endif
  • #ifndef HELLO_H #define HELLO_H class public void #endif

    [4]Hello.cpp

    #include <iostream>
    #include "Hello.h"
    void Hello::sayHello()
    {
    std::cout << "Hello CMake!" << std::endl;
    }

    [5]test.cpp

    #include "Hello.h"
    int main(int arg, char** argv)
    {
    Hello h;
    h.sayHello();
    }

    [6]src 下的CMakeLists.txt

    # 添加头文件的查找目录
    INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)
    ## 生成各种目标(target)文件: 可执行文件、动态库、静态库
    # 指定可执行文件的输出目录,输出到bin下面
    SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
    # 指定可执行文件名(hello)和相关源文件
    ADD_EXECUTABLE(hello test.cpp Hello.cpp)
    # 指定库文件输出路径
    SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
    # 生成动态库
    # 注意,前面已经使用target文件名hello,这里不能再用。
    ADD_LIBRARY(hello_so SHARED Hello.cpp)
    # 设置库输出名为 hello => libhello.so
    SET_TARGET_PROPERTIES(hello_so PROPERTIES OUTPUT_NAME "hello")
    # 生成静态库
    # 注意,前面已经使用target文件名hello,这里不能再用。
    ADD_LIBRARY(hello_a STATIC Hello.cpp)
    # 设置输库出名为 hello => libhello.a
    SET_TARGET_PROPERTIES(hello_a PROPERTIES OUTPUT_NAME "hello")

    最后,进入build目录执行命令: cmake <项目根目录>

    如果执行cmake命令的目录与项目根目录相同,称为内部编译,这时CMake生成的中间文件会与项目代码混合,不推荐。

    否则,称为外部编译,所有中间文件会生成在执行cmake命令的目录下。

    cmake执行完后,会生成Makefile, 直接make, 会在项目下生成bin和lib目录及目标文件。

    1. cmake ..
    2. make

    通常我们不需要生成所有类型的目标文件,构建时根据需要选择。

    3. 构建多个项目,使用外部项目提供的库文件。

    在前面的HelloWorld项目中,生成了lib文件,就可以通过头文件和lib文件发布给其他项目了。

    我们创建一个Test项目来使用HelloWorld的生成的库,如下:

    workspace

    |—— HelloWorld

    |—— Test

    |—— CMakeLists.txt

    |—— src        main.cpp CMakeLists.txt

    |—— build

    (1)Test目录下的CMakeLists.txt

    1. cmake_minimum_required(VERSION 2.8)
    2. ADD_SUBDIRECTORY(src)

    2) main.cpp

    1. #include "Hello.h"
      intintchar

      }

    (3) src下的CMakeLists.txt

    1. # 显示系统的HOME环境变量的值

      # 指定头文件查找目录
      # 注意,这里指定绝对路径。

      # 指定库文件查找目录(不能只指定头文件,也需要连接到库文件)
      # 注意,这里指定绝对路径, 也可通过设置系统环境变量LD_LIBRARY_PATH来指定。

      # 生成可执行文件到项目的bin目录

      # 制定链接的外部Lib
      TARGET_LINK_LIBRARIES(main libhello.a)

    最后,进入build目录执行:

    1. cmake ..
    2. make

    到bin目录下测试可执行文件:

    1. $ ./main
    2. $ Hello CMake!
上一篇:SectionIndexer中的getSectionForPosition()与getPositionForSection()


下一篇:linux笔记:shell编程-文本处理命令