cmake使用

tags: 嵌入式
categories: 开发

cmake 总结

交叉编译

• 设置编译器
  CMAKE_FORCE_C_COMPILER($ENV{CROSS}gcc GNU)
• 设置pkg-config执行的位置
  set(PKG_CONFIG_EXECUTABLE $ENV{PKG_CONFIG})
• 设置工程名
  project(suma_middleware)
• 设置工程的相关变量
  set(CMAKE_SYSTEM_NAME Linux)
  set(CMAKE_SYSTEM_PROCESSOR mips)

基本功能

• 使用系统变量
  增加$ENV{xxx},使用系统变量xxx，因为目前使用的交叉编译的方法是使用source xxx.sh文件的方法将相关的变量增加到当前终端的系统变量中。所以需要大量的变量都是这种形式的。
• 设置相关代码子目录
  按照分层的结构，比如在下一层的src中有代码，使用如下的方式增加：
  add_subdirectory(xxx)
  以上方法需要确保xxx目录中有CMakcLists.txt文件。

• 设置头文件查找位置
  cmake文档中使用
  include_directories(xxx)
  目前我的方法是使用:
  set(dir)
  list(APPEND dir ${dir1})
  include_directories(${dir})
  以上的方式来添加编译的选项

• 设置库搜索的位置
  link_directories(xxx)
  查找xxx位置有无制定的库。
  可以按照头文件设置的方法进行管理，这样便于管理

• 设置链接库的名字
  在生成对应的可执行程序（或者库）后面执行
  target_link_libraries(xxx ${libname})
  小坑：注意此处增加libname cmake会自动脑补成lib${libname}.so (或者a)的文件名。

• 使用pkg-config机制查找库

  • 配置package
    find_package(PkgConfig)

  • 定义宏

    macro(detectpkgconfig lib LIBNAME)  
    
    pkg_check_modules(${LIBNAME} REQUIRED ${lib} )  
    message(STATUS 'lib is' ${lib}^^^ "${LIBNAME}_INCLUDE_DIRS is " ${${LIBNAME}_INCLUDE_DIRS})  
    message(STATUS ${lib}^^^ "${LIBNAME}_CFLAGS is " ${${LIBNAME}_CFLAGS})  
    set(${LIBNAME}_INCLUDE_DIRS)  
    
    endmacro(detectpkgconfig)  
    

  • 调用宏
    detectpkgconfig(directfb DIRECTFB)

  • 增加库相关头文件位置
    include_directories(${DIRECTFB_INCLUDE_DIRS})

  • 增加库位置
    link_directories(${DIRECTFB__LIBRARY_DIRS})

• 生成可执行文件
  add_executable(demo main.c)

• 生成库文件
  add_library(xxx ${SRC_LIST}) (有变量可以定义生成的为静态库或者是动态库)

坑

• 链接顺序
  编写makefile的时候就容易踩得坑。现在也需要注意库的依赖顺序和添加顺序有关系。

• 查找特定名称的库
  因为之前项目中历史遗留问题生成的库没有按照标准的libxx.a或者libxx.so写法，需要手动制定特定的位置以及文件名。

  find_library(KERNEL_DRV NAMES xxx.a PATHS ${PROJECT_LIB_PATH})  
  
  在指定的 PROJECT_LIB_PATH路径下寻找xxx.a文件。生成变量保存在KERNEL_DRV_NAMES变量中。
  

• 编译的不同时期执行特定的脚本
  部分项目，因为属于不同项目组，没有统一编译的环境，而且他们也不准备花时间统一，所以用他们的最新的库，需要使用脚本来进行编译... ...
  到此处，我用cmake改写的过程中深深的体会到了，队友的重要性。
  add_custom_command(TARGET demo PRE_BUILD
  COMMAND echo ARGS "##### build xxx start ###### "
  WORKING_DIRECTORY $ENV{xxxxx})
  在WORKING_DIRECTORY 目录xxxxx中执行脚本。对象为demo，也就是说在编译demo之前执行以上脚本。但是cmake的文档中好像提到PRE_BUILD只在特定的编译环境有效果，所以在一般情况下，表示链接阶段。

总结

• cmake 语法的特点，使用大写变量表示变量类型
• prefix机制，不少地方定义一个变量xxx以后.实际是定义了一个${prefix}，会有 cmake中，类似全局变量的${prefix}_xxx存在，可以直接调用。比如前面说的pkg-config

疑问

• 变量的作用域。
• 变量的初始化，在改写工程过程中，初始化已经定义的list，不再有效。（类型设置有问题？？？）
• 函数和marco的区别联系初看文档说是主要变量作用域的区别，暂时没来得及细看，目前使用的是marco

主要参考资料

• http://www.cmake.org/cmake/help/v3.0