CMake

#单行注释
#[[
多行注释多行注释
]]

#声明变量
set(name 123)
#引用变量 message是打印命令
message("name = ${name}")

set(if_tap OFF)
set(elseif_tap ON)
if(${if_tap})
    message("if")
elseif(${elseif_tap})
    message

set(a "")
while(NOT a STREQUAL "XXX")
    set(a "${a}x")
    message("a = ${a}")
endwhile()

foreach(item 1 2 3)
    message("item = ${item}")
endforeach(item)

foreach(item RANGE 3)
    message("item = ${item}")
endforeach(item)

foreach(item RANGE 0 7 3)
    message("item = ${item}")
endforeach(item)
--------
打印为0 3 6

set(list_var 1 2 3)
foreach(item IN LISTS list_var)
    message("item = ${item}")
endforeach(item)

function(func x y z)
    message("call function func")
    message("x = ${x}")
    message("y = ${y}")
    message("z = ${z}")
    message("ARGC = ${ARGC}")
    message("agr1 = ${ARGV0} arg2 = ${ARGV1} arg3 = ${ARGV2}")
endfunction(func)

func(1 2 3)

macro(ma x y z)
    message("call macro ma")
    message("x = ${x}")
    message("y = ${y}")
    message("z = ${z}")
endmacro

ma(1 2 3)

#指定cmake最低支持的版本
cmake_minimum_required(VERSION 3.4.1)
#
add_library(
        native-lib

        SHARED

        native-lib.cpp)
find_library( 
        log-lib

        log)
target_link_libraries( 
        native-lib

        ${log-lib})

#设置可执行文件的输出路径(EXCUTABLE_OUTPUT_PATH是全局变量)
set(EXECUTABLE_OUT_PATH [out_path])

#设置库文件的输出路径(LIBRARY_OUT_PATH是全局变量)
set(LIBRARY_OUT_PATH [output_path])

#设置C++编译参数(CMAKE_CXX_FLAGS是全局变量)
set(CMAKE_CXX_FLAGS "-Wall std=c++ll")

#设置源文件集合(SOURCE_FILES是本地变量即自定义变量)
set(SOURCE_FILES main.cpp test.cpp...)

#可以用相对路径或者绝对路径，也可以使用自定义的变量值
include_directories(./include ${MY_INCLUDE})

#第一个参数文件名 第二个路径
add_executable(<name> #{SRC_LIST})

target_link_libraries(<name> lib1 lib2 lib3)

#如果出现互相依赖的静态库，CMake会允许依赖图中包含循环依赖比如：
add_library(A STATIC a.c)
add_library(B STATIC b.c)
target_link_libraries(A B)
target_link_libraries(B A)
add_executable(main main.c)
target_link_libraries(main A)

add_definitions(-DFOO -DDEBUG ...)

#dub_dir:指定包含CMakeLists.txt和源码文件的子目录的位置
#binary_dir:是输出路径，一般可以不指定
add_definitions(sub_dir [binary_dir])

#将message写入filename文件中，会覆盖文件原有内容
file(WRITE filename "message")
#将message写入filename文件中，会追加在文件末尾
file(APPEND filename "message")
#从filename文件中读取内容并存储到var变量中，如果指定了numBytes和offset
#则从offset处开始最多度numBytes个字节
#另外如果指定了HEX参数，则内容会以十六进制形式存储在var变量中
file(READ filename var [LIMIT numBytes] [OFFSET offset] [HEX])
#重命名文件
file(RENME <oldname> <newname>)
#删除文件 等于rm命令
file(REMOVE [file1...])
#根据指定url下载文件
#timeout超市事件；下载状态会保存到status中；
#下载日志会被保存到log;
#sum指定多下载文件预期的MD5值
#如果指定hi自定进行比对，
#如果不一致则返回一个错误：SHOW_PROGRESS
#进度信息会以状态信息的形式被打印出来
file(DOWNLOAD url file [TIMEOUT timeout] [STATUS status] [LOG log] [EXPECTED_MD5 sum]
[SHOW_PROGRESS])
#创建目录
FILE(MAKE_DIRECTORY [dir1 dir2 ...])
#会把path转换为以unix的/开头的cmake风格路径保存在result总
file(TO_CMAKE_PATH pathresult)
#会把cmake风格的路径转换为本地路径风格window下用“\” unix下用“/”
file(TO_NATIVE_PATH path result)
#将会为所有匹配查询表达式的文件生成一个文件list
#并将该list存储进变量variable里面
#如果一个表达式指定了RELATIVE,返回的结果
#将会是相对于给定路径的相对路径
#查询表达式例子：*.cxx,*.vt?
#NOTE:按照官方文档说法，不建议使用file的GLOB指令来收集工程的源文件。
file(GLOB variable [RELATIVE path] [globbing expressions])

set_directory_properties(PROPERITIES prop1 value1 prop2 value2)

set_property(<GLOBAL | DIRECTORY [dir] |
TARGET [target...] |
SOURCE [src1...] |
TEST [test1...] |
CACHE [entry1 ...]>
[APPENT]
PROPERTY <name> [value...])

#查找当前目录多有源文件 并将名称到存到DIR_SRCS
#中，不能查找子目录
aux_source_directory(. DIR_SRCS)

#也可以使用
#file(GLOB DIR_SRCS *.c  *.cpp)

add_library(native-lib
        SHARED
        ${DIR_SRCS})

cmake_minimum_required(VERSION 3.4.1)
aux_source_directory(. DIR_SRCS)
#添加child子目录下的CMakeLists.txt
add_subdirectory(child)

add_library(
    native_lib
    SHARED
    ${DIR_SRCS}
)
target_link_libraries(native-lib child)

cmake_minimum_required(VERSION 3.4.1)
aux_source_directory(. DIR_LIB_SRCS)
add_library(
    child
    SHARED
    ${DIR_SRCS}
)

cmake_minimum_required(VERSION 3.4.1)
#使用IMPORTED标志告诉CMake 只希望将库导入到项目中
#如果静态库则将shared改为static
add_library( imported-lib
    SHARED
    IMPORTED)
#参数分别为库、属性、导入地址、库所在地址
set_target_properties(
    imported-lib
    PROPERTIES
    IMPORTED_LOCATION
    <路径>/libimported-lib.so
    )
aux_source_directory(. DIR_SRCS)
add_library(
    native-lib
    SHARED
    ${dir_SECS}
)
target_link_lbraries(native-lib imported)

#set命令定义一个变量
#CMAK_C_FLAGS:c的参数会传递给编译器
#付过是c++文件，需要用CMAKE_CXX_FLAGS
#-L:库的查找路径
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -L[SO所在目录]")

cmake_minimum_required(VERSION 3.4.1)
#设置头文件目录
include_directiories(<文件目录>)
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -L[SO所在目录]")
aux_source_directory(. DIR_SRCS)
add_library(
    native-lib
    SHARED
    ${dir_SECS}
)
target_link_lbraries(native-lib imported)

android {
     defaultConfig {
           externalNativeBuild {
            cmake {
                //使用编译器clang/gcc
                //cmake默认就是gnustl_static
                arguments "-DANDROID_TOOLCHAIN=clang","-DANDROID_STL=gnustl_static"
                //指定cflags和cppflags，效果和cmakelist使用一样
                cppFlags ""
                cppFlags ""
                //指定需要编译的cpu架构
                abiFilters "armeabi-v7a"
            }
        }
     }
      externalNativeBuild {
        cmake {
            path "src/main/cpp/CMakeLists.txt"
            version "3.10.2"
        }
    }
}

#指定cmake最小支持版本
cmake_minimum_required(VERSION 3.4.1)
#添加一个库，根据native-lib.cpp文件编译一个native-lib动态库
add_library( 
        native-lib
        SHARED
        native-lib.cpp)
#查找系统库，这里查找的是系统日志库
#默认会到 skd的ndk路径下面去找比如：sdk\ndk-bundle\platforms\android-28\arch-arm\usr\lib
find_library(
        log-lib
        log)
#设置依赖的库，第一个参数必须为依赖的模块，顺序不能改
target_link_libraries(
        native-lib
        ${log-lib})

externalNativeBuild {
          cmake {
              abiFilters "x86"
          }
      }

      ndk {
          abiFilters 'x86'
      }

#include <jni.h>
#include <string>
#include <fmod.hpp>
#include <android/log.h>

using namespace FMOD;

extern "C" JNIEXPORT jstring JNICALL
Java_com_chs_cmake_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {

    System *system;
    System_Create(&system);
    unsigned version;
    system->getVersion(&version);
    __android_log_print(ANDROID_LOG_ERROR,"text","FMOD_VERSION:%08x",version);
    return env->NewStringUTF(hello.c_str());
}

2019-05-25 15:37:50.261 29585-29585/com.chs.cmake E/text: FMOD_VERSION:00020001