9、Cmakelists使用小记

已于 2022-06-02 14:45:01 修改
阅读量1.8k 收藏 2
点赞数
分类专栏： Tools 文章标签： cmakelists ndk
于 2022-06-01 10:11:13 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/roujian0985/article/details/125077138
版权

前言：最近安卓上面集成ffmpeg库，需要使用CMakeLists，之前VSCode中写过，时间有点长，忘记了，现记录下。

一、简介

cmake 是一个跨平台、开源的构建系统。它是一个集软件构建、测试、打包于一身的软件。它使用与平台和编译器独立的配置文件来对软件编译过程进行控制。

二、语法介绍

2.1 基本变量

CMAKE_SOURCE_DIR：CMakeLists.txt所在目录
比如:src/main/cpp/CMakeLists.txt


PROJECT_SOURCE_DIR：工程源文件目录，
比如..app/src/main/cpp


CMAKE_CXX_FLAGS： 用户配置的编译器参数


ANDROID_ABI：对应的ABI架构，
比如arm64-v8a文件夹下该值为arm64-v8a


PROJECT_SOURCE_DIR:工程根目录


CMAKE_CURRENT_SOURCE_DIR：当前处理的CMakeLists.txt文件所在路径

2.2 set 

设置正常变量、缓存变量或环境变量的值

set(arg value)
自定义变量，arg是变量名，value是变量值，
引用变量方式${arg}

2.3 message 

message(STATUS  "打印的数据")
打印信息，存在于build_output.txt日志文件中，
一般测试变量、路径是否正确，类似于Java代码中的print方法

2.4 add_library、set_target_properties

用法1

原型：add_library(< name> [STATIC | SHARED | MODULE]
[EXCLUDE_FROM_ALL]
[source1] [source2 …])
参数：
 name：被构建库目标名称
 [STATIC | SHARED ..：被构建库的类型，STATIC为静态库，生成的库 以libname.a形式存在，SHARED 为动态库，生成的库以libname.so形式存在；
 EXCLUDE_FROM_ALL：对应的一些属性会在目标被创建时被设置；
 [source1] [source2 ...]：指定源文件，多个文件由一个空格隔开；
作用：添加一个库
实例： add_library(LameMp3 SHARED src/main/cpp/LameMp3.c ${SRC_LIST})
用法2

原型：add_library(< name> <SHARED|STATIC|MODULE|OBJECT|UNKNOWN> IMPORTED
[GLOBAL])
参数：
 name：导入已知库的名称；
 SHARED|STATIC|IMPORTED..：通常为SHARED IMPORTED；
作用：导入一个已经存在的库。注：导入库一般配合set_target_properties使用
实例： add_library(libswscale-4 SHARED IMPORTED )
find_library
原型：find_library (<VAR> name1 [path1 path2 …])
参数：
 name1 ：
作用：在path1查找相关库，并将其路径保存到指定变量name中
实例：find_library( log-lib log )

原型：set_target_properties(target1 target2 …
PROPERTIES prop1 value1
prop2 value2 …)
参数：
 target1 target2 ...：目标名称；
 prop1 prop2 ...：代表属性，取值为INCLUDE_DIRECTORIES、IMPORTED_LOCATION、LINK_DIRECTORIES等；
 value1 value2 ...：被设置的属性值；
作用：设置目标属性值
实例：set_target_properties(libavcodec-57 PROPERTIES IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavcodec-57.so")

add_library
1、添加源代码生成.a或.so库（注意此处会生成新的库文件）
add_library(HELLO [STATIC/SHARED] hello.cpp) ，
若 [STATIC/SHARED]不填写，据测试默认为STATIC

2、添加已有的或者第三方提供的.so或.a库（注意此处是已有的库文件）
add_library(faac [STATIC/SHARED] IMPORTED) ，IMPORTED告知CMake：
faac是第三方导入的库，按路径去找，
这个功能会和set_target_properties()一起使用

set_target_properties()
设置目标属性如：
1.指定导入库路径
set_target_properties（
HELLO
PROPERTIES IMPORTED_LOCATION  //CMake中的关键字
import-lib/src/${ANDROID_ABI}/libHELLO.so//指定你要导入库的路径.
）
2.指定生成的库名称为hell0z注意生成的为libhell0z.so
set_target_properties(
HELLO PROPERTIES OUTPUT_NAME "hell0"
)

2.5  include_directories

原型：include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 …])
参数：
 AFTER|BEFORE：指定源文件目录后，通常会被附加到编译的当前目录列表中，但也可以通过AFTER或BEFORE来改变这种行为方式；
 SYSTEM：如果给出SYSTEM选项，编译器将被告知该目录是系统包含目录。
 dir1：源文件目录路径，可多个，用一个空格隔开；
作用：导入给定源文件目录
实例：include_directories(src/main/cpp/lame)

这个命令不建议使用了，但是在我们的项目中顶级目录并没有定义任何 target，因此也没有想到更好的办法。

include_directories(includeDir1 includeDir2...)
指定原生或第三方库的头文件，为了CMake在编译阶段定位我们的头文件

2.6  target_link_libraries

原型：target_link_libraries(< target> … < item>… …)
参数：
 target：目标库
 item：被连接的库
作用：将若干库链接到目标库文件，需要注意的是链接的顺序应该符合gcc链接的顺序规则，即被链接的库放在依赖它的库的后面，比如lib1依赖于lib2，lib2依赖于lib3，那么target_link_libraries(name lib1 lib2 lib3)。
实例：target_link_libraries(LameMp3 ${log-lib} )

如果 target 是一个 library，该命令可以用来指定依赖本仓库的 target 还需要链接另外的仓库，用于解决循环依赖。

target_link_libraries(mylib INTERFACE anotherlib)

如果 target 是可执行文件，则该命令用于指定其需要链接的库。

list(APPEND EXTRA_LIBS gcov mylib)
target_link_libraries(mymain ${EXTRA_LIBS})
target_link_libraries(obj lib1 lib2 lib3...)
将预构建或第三方库 lib1 lib2 lib3链接到obj中，对应预处理-编译=汇编-链接过程中的链接阶段，
那么obj中就可以正常调用库里的函数，obj即可以是可执行文件也可以是库

2.7 target_link_directories

指定链接路径，该命令在3.12以下版本没有，笔者在项目中使用如下命令设置库的路径，其实更好的方法是用find_library.

# bad way
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -L${CMAKE_CURRENT_SOURCE_DIR}/../dependentLibs"
# good way
find_library(mylib ../dependentLibs)

 2.8 file

file的用法很多，这里仅说明如何使用它来查找C文件

file(GLOB_RECURSE SOURCES RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} "*.c")

2.9 add_subdirectory

添加一个子目录到构建，该目录下必须有CMakeLists.txt文件

三、实例

#这个没什么可说的，就是指定cmake构建的最小版本号，
#因为随着版本更新有些语法、命令可能变了，所以这里需要设置下版本
cmake_minimum_required(VERSION 3.4.1)

#设置项目的名称，这个是可选的，
#如果设置了，会自动给你定义两个变量：demo_SOURCE_DIR，demo_BINARY_DIR。其中demo是你设置的#peoject名
#不过不指定的话默认有PROJECT_SOURCE__DIR ，PROJECT_BINARY_DIR，
#分别代表项目的源文件目录，项目编译后生成的二进制目录。
project("demo")

set(CMAKE_VERBOSE_MAKEFILE on)
# 设置so输出路径
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
# 赋值变量libs 
#第一个参数:libs是变量名，第二个是变量值
set(libs "${CMAKE_SOURCE_DIR}/src/main/jniLibs")
# 导入ffmpeg相关头文件
include_directories(${CMAKE_SOURCE_DIR}/src/main/cpp/include)

#-----------------------------导入ffmpeg库--------------------------------------
add_library(libavcodec-57 SHARED IMPORTED )
set_target_properties(libavcodec-57 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavcodec-57.so")

add_library(libavdevice-57 SHARED IMPORTED )
set_target_properties(libavdevice-57 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavdevice-57.so")

add_library(libavfilter-6 SHARED IMPORTED )
set_target_properties(libavfilter-6 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavfilter-6.so")

add_library(libavformat-57 SHARED IMPORTED )
set_target_properties(libavformat-57 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavformat-57.so")

add_library(libavutil-55 SHARED IMPORTED )
set_target_properties(libavutil-55 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libavutil-55.so")

add_library(libpostproc-54 SHARED IMPORTED )
set_target_properties(libpostproc-54 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libpostproc-54.so")

add_library(libswresample-2 SHARED IMPORTED )
set_target_properties(libswresample-2 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libswresample-2.so")

add_library(libswscale-4 SHARED IMPORTED )
set_target_properties(libswscale-4 PROPERTIES
    IMPORTED_LOCATION "${libs}/${ANDROID_ABI}/libswscale-4.so")

#------------------------------配置、链接动态库--------------------------------
#设置变量CMAKE_CXX_FLAGG修改编译选项[只针对c和c++编译器]
#这里使cmkae编译带有c++11特性，其中-std用于指定c/c++标准；
# -fexceptions用于开启编译器异常捕获机制；-frtti用于支持RTTI，配合异常处理
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=gnu++11 -fexceptions -frtti")
#指定自定义构建库信息
add_library( # 库名称
             decstream

             # 库类型为动态库
             SHARED

             # 将被编译的源文件
             src/main/cpp/nativesurface.cpp
             src/main/cpp/vdecode.cpp
             src/main/cpp/util.cpp
             src/main/cpp/openstream.cpp)
#查找NDK中原生库log-lib
find_library( # Sets the name of the path variable.
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log)
#将ffmpeg库、原生库android、log链接到自定义库decstream 
target_link_libraries(decstream android log
    libavcodec-57
    libavdevice-57
    libavfilter-6
    libavformat-57
    libavutil-55
    libpostproc-54
    libswresample-2
    libswscale-4
    ${log-lib}
    )

四、总结

如果在使用时有什么不对的，很大的可能是语法和路径问题，慢慢排查就可以。

五、引用文献

1、CMake 基本用法介绍

2、 CMakeList常用命令 - 简书

3、Android NDK开发之旅(5)：Android Studio中使用CMake进行NDK/JNI开发(高级)_无名之辈FTER的博客-CSDN博客

komla168
关注
专栏目录
Android开发——Cmakelist的使用
qq_25065595的博客
09-17 4816
一、背景：Cmakelist的使用 项目创建好以后我们可以看到和普通Android项目有以下4个不同。 main 下面增加了 cpp 目录，即放置 c/c++ 代码的地方 module-level 的 build.gradle 有修改 增加了 CMakeLists.txt 文件 多了一个 .externalNativeBuild 目录 image.png 二、正文第一章：CMakeLists.txt 文件 讲解 2.1 一个基本的Cmakelist文件 cmake_minimum.
CMakeList使用参考
csdnwxhw的博客
06-22 342
CMakeList 使用参考 文章目录1 set2 message3 option4 configure_file5 include_directories6 add_executable7 target_link_libraries8 `CMAKE_CURRENT_SOURCE_DIR`9 PROJECT_SOURCE_DIR10 INCLUDE_DIRECTORIES11 function12 list 1 set //"set"用来定义变量 tutorial教程 set (Tutorial_VERSI
CMakeLists基础教程手把手教会使用Cmake代码编写
最新发布
weixin_44770969的博客
08-17 897
CMake是一个跨平台的编译(Build)工具,可以用简单的语句来描述所有平台的编译过程。能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。
CMake：set与list的字符串操作（六）
weixin_43808717的博客
05-02 1278
关于上面的命令其实就是将从第二个参数开始往后所有的字符串进行拼接，最后将结果存储到第一个参数中，如果第一个参数中有数据就会对元数据进行覆盖。搜索某个目录就得到该目录下所有的源文件，但是其中有些源文件并不是我们所需要的，比如：制作库需要移除main.cpp文件。命令对这个目录下的源文件进行搜索，最后还需要做一个字符串拼接的操作，关于字符串拼接可以使用。要强大，字符串拼接只是它的其中一个功能，所以需在在它第一个参数的位置指定出外面要做的操作，：新创建的变量，用户存储索引元素的返回结果，也是一个列表。
CMakeList整理大全
weixin_68094467的博客
06-26 1221
这个命令非常灵活，是CMake脚本中用得最频繁的指令之一，因为它可以用来存储各种类型的数据，如字符串、文件路径、列表（即字符串数组）、布尔值等。它确保了 CMake 的特定版本或更高版本的特性能够被利用，并且保证了在旧版本的 CMake 中可能导致未知行为的特性不会被误用。选项用于将变量存储到CMake的缓存中，这对于可配置的选项很有用，因为它们在不同的构建中保持不变，除非被用户或者项目脚本修改。指令的基本语法和使用示例，你可以根据具体的需求设置不同类型的变量，如普通变量、列表变量或者缓存变量。
CMake常用命令（三）set命令
qq_26849933的博客
09-30 2299
变量variable的作用域为调用set命令的函数或者当前目录，如果使用了PARENT_SCOPE选项，意味着该变量的作用域会传递到上一层（也就是上一层目录或者当前函数的调用者，如果是函数则传递到函数的调用者，如果是目录则传递到上一层目录），并且在当前作用域该变量不受带PARENT_SCOPE选项的set命令的影响（如果变量之前没有定义，那么在当前作用域仍然是无定义的；**结论：**选项PARENT_SCOPE定义的变量作用域在上一层函数，当前函数的变量必须使用不带选项PARENT_SCOPE定义。
CMakeLists使用总结介绍.zip
06-15
本篇文章将深入探讨CMakeLists.txt的使用方法，以及它在与Qt Creator和Linux环境结合时的注意事项。 首先，CMakeLists.txt的基本结构包括多个命令，如`cmake_minimum_required`，`project`，`add_executable`和`...
C++版本使用CMakeLists.txt编译（同目录多个源文件）可执行文件
07-12
C++版本使用CMakeLists.txt编译（同目录多个源文件）可执行文件-C++版本使用CMakeLists.txt编译（同目录多个源文件）可执行文件-C++版本使用CMakeLists.txt编译（同目录多个源文件）可执行文件
针对MCU，编写CMakeLists.txt，使用make编译
01-01
为了在Linux环境下对MCU进行程序开发，通常会采用C语言，而CMakeLists.txt文件则是管理项目构建的配置文件，可以与make工具配合使用，实现跨平台的编译流程。本篇将详细介绍如何编写CMakeLists.txt文件，并利用make...
CmakeLists 使用总结
咕快快的博客
07-28 1079
记录一下CMakeLists的使用
CMakeLists
03-17
9. **target_link_libraries**: 将库链接到目标，确保在链接阶段使用正确的库。 10. **install**: 定义安装步骤，告诉CMake在构建完成后如何将生成的文件放置到目标位置。 11. **option**: 创建用户可配置的选项，...
CmkaeList.txt的使用
Helloorld_1的博客
11-17 290
22.这一行指定了你的库需要链接到的其他库。比如OpenCV的库（OpenCV_LIBS），licenseAuth库（LICENSE_LIB），以及其他一些你可能需要的库，如glog、WKTParser、jsoncpp、nvinfer、nvonnxparser等。-L指定了CUDA的库路径，-lcudart指定了链接到CUDA的运行时库。如果这是完整的文件，那么可能是一个错误，因为条件语句没有正确的关闭。25.这行代码将3rd/fonts目录下的所有文件（假设是字体文件）安装到lib目录下。
【C++】Cmake使用教程
齐楚的专栏
02-06 1678
CMake是开源、跨平台的构建工具，可以让我们通过编写简单的配置文件去生成本地的Makefile，这个配置文件是独立于运行平台和编译器的，这样就不用亲自去编写Makefile了，而且配置文件可以直接拿到其它平台上使用，无需修改，非常方便。
CMake学习笔记四-CMake常用命令
weixin_30265171的博客
03-26 188
CMake常用命令 PROJECT PROJECT(projectname [CXX] [C] [Java]) 指定工程名称,并可指定工程支持的语言。支持语言列表可忽略,默认支持所有语言 SET SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]]) 定义变量(可以定义多个VALUE,如SET(SRC_LIST main.c util...
CMakelist语法学习小结
qq_32582681的博客
04-26 558
创建一个简单的cmakelist工程，后面会对详细的用法进行说明 CMAKE_MINIMUM_REQUIRED(VERSION 2.8) #cmake 版本。 PROJECT(server_project) #定义工程名称 MESSAGE(STATUS "Project: SERVER") #打...
CMake 教程
热门推荐
Keivin
07-06 2万+
CMake是一个跨平台的程序构建工具，比如起自己编写Makefile方便很多。 介绍：http://baike.baidu.com/view/1126160.htm 本文件不介绍CMake的基本语法，下面是篇不错的入门教程： http://www.ibm.com/developerworks/cn/linux/l-cn-cmake/   一，首先构建比较简单的工程，来对CMake有个简单
cmkelist-cpp简单写法
weixin_38799245的博客
01-27 517
jj
CMakeList知识点梳理
u013932564的专栏
09-29 1094
CMakeList 用法说明，包括创建子工程文件夹、自动搜索文件夹下的.h或.cpp文件的方法以及第三方库的添加方法
CMKAE总结
月光亲了城
08-21 638
CMKAE总结 cmake:生成一个makefile文件。 make:根据这个makefile文件的内容编译整个工程。 cmake . :在当前目录调用cmake进行分析 mkdir build cd build cmake ..:对上一称文件夹，也就是代码所在的文件夹进行编译.这样cmake产生的中间文件就会在build文件夹中，与源代码分开。 cy.cpp #includ...
CMakeLists 使用pcl
05-14
如果你想在你的 CMake 项目中使用 PCL（Point Cloud Library），你需要在你的 CMakeLists.txt 文件中添加以下内容： ``` cmake_minimum_required(VERSION 2.8 FATAL_ERROR) project(your_project_name) # Find ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值