Cmake 语义学习

1.project函数

project(xrbodyfaceeyesocial)

xrbodyfaceeyesocial 指定了项目的名称。之后在 CMake 文件中使用 ${PROJECT_NAME} 变量时,
会被替换为 xrbodyfaceeyesocial。

2.file函数

file 是 CMake 中的一个命令,用于执行与文件相关的操作,比如查找、创建、删除文件等。

file(GLOB_RECURSE SRC_FILES
    Src/*.c
    Src/*.cpp
)

GLOB_RECURSE: 这是 file 命令的一种模式,表示递归地查找指定目录下的文件。GLOB_RECURSE 会深入子目录查找。
SRC_FILES :是一个变量,用于存储找到的文件列表。

Src/.c
Src/
.cpp
表示搜索的目录文件

3.add_library 函数

add_library(${PROJECT_NAME} MODULE ${SRC_FILES})

add_library:这是 CMake 中用于创建库的命令。它用于定义库的类型和包含的源文件。

${PROJECT_NAME}:这是一个变量,用于表示当前项目的名称。在代码的开头部分已经通过 project(xrbodyfaceeyesocial) 定义了这个名称,因此在这里它会被替换为 xrbodyfaceeyesocial。

MODULE:这是指定库的类型。CMake 支持几种类型的库,包括:

STATIC:静态库
SHARED:共享库
MODULE:模块库(通常用于动态加载的插件)。在这里,MODULE 类型表示这个库不会被链接到其他目标,而是可以在运行时被动态加载。

${SRC_FILES}:这是指定要包含在构建库中的源文件列表。file(GLOB_RECURSE ...) 指令在之前的代码中定义了这个变量,它包含了所有在 Src 目录下的 .c 和 .cpp 文件。

4. target_include_directories 函数

target_include_directories(${PROJECT_NAME} PUBLIC ${ANDROID_NDK}/sources/android/native_app_glue)

target_include_directories: 这是 CMake 的一个命令,用于为指定的目标(此处是 ${PROJECT_NAME})设置包含目录。包含目录是编译时需要查找头文件的路径。

${PROJECT_NAME}: 这个变量是之前在 CMake 文件中定义的项目名称,在此处它被替换为实际的项目名(在上下文中是 xrbodyfaceeyesocial)。这意味着该命令将应用于这个特定的目标。

PUBLIC: 这是一个作用域参数,表示所添加的包含目录对指定目标和链接到该目标的其他目标都是可见的。换句话说,任何依赖于 ${PROJECT_NAME} 的目标也能访问到这个包含目录。

${ANDROID_NDK}: 这是一个 CMake 变量,通常是 Android NDK 的安装目录路径。NDK(Native Development Kit)是 Android 的原生开发工具包,支持 C/C++ 开发。

/sources/android/native_app_glue: 这是相对于 ANDROID_NDK 的路径,指向 Android NDK 中的 native_app_glue 目录。这个目录包含 Android Native Activity 的应用程序粘合层的源代码,用于简化 Android 应用程序的开发。

5. target_link_libraries 函数

target_link_libraries(${PROJECT_NAME} PRIVATE
        android
        EGL
        GLESv3
        log
        ktx
    )

这段代码是 CMake 构建系统中的一部分,用于指定目标文件(target)链接所需的库。我们逐步分解并详细解释每个部分。

target_link_libraries:

这是 CMake 中的一个命令,作用是为指定的目标链接一个或多个库。它可以用来声明目标与外部库之间的依赖关系。
${PROJECT_NAME}:

这是一个变量,代表项目的名称。在之前的 CMake 文件中,这个变量通过 project(xrbodyfaceeyesocial) 被定义。这样,${PROJECT_NAME} 解析为 xrbodyfaceeyesocial。
PRIVATE:

这是一个可见性标志,指定链接的库的可见性。在这里,PRIVATE 表示被链接的库仅在当前目标(即 ${PROJECT_NAME})中可见,而不会传播给依赖于该目标的其他目标。

android, EGL, GLESv3, log, ktx:

这些是链接到项目中的具体库名称:
android: Android 平台的基本库,提供 Android 应用程序所需的功能。
EGL: 一个接口,用于管理 OpenGL 渲染上下文和显示表面,这对图形渲染至关重要。
GLESv3: OpenGL ES 3.0 是专为嵌入式系统(如移动设备)设计的图形 API。
log: 用于在 Android 应用中进行日志记录的库。
ktx: KTX(Khronos Texture)是用于高效纹理压缩和存储的库。

6.set_target_properties 函数

set_target_properties(${PROJECT_NAME} PROPERTIES LINK_FLAGS "-u ANativeActivity_onCreate")

这行代码的作用是为指定的目标(在这里是 ${PROJECT_NAME})设置属性,具体来说,是设置链接时的标志。

分解解释:
set_target_properties:

这是一个 CMake 命令,用于设置某个目标的属性。目标可以是库、可执行文件等。
${PROJECT_NAME}:

这是一个变量,它在项目的开头被定义为 xrbodyfaceeyesocial。在此命令中,使用了这个变量来指定需要设置属性的具体目标。
PROPERTIES:

这是 set_target_properties 命令的一个参数,用于指明后面将要设置的属性类型。
LINK_FLAGS:

这个属性用于指定在链接时应使用的标志或选项。在此处,LINK_FLAGS 的设置影响链接器(linker)的行为。
"-u ANativeActivity_onCreate":

这是一个链接器标志的具体值。-u 是链接器参数的一个选项,意味着“强制引用”。在这里,它表示强制引用 ANativeActivity_onCreate 函数,这个函数是安卓 NDK(Native Development Kit)中的一个入口点。通过强制引用,链接器会确保这个函数被包含在最终的可执行文件中,即使在代码中没有直接使用它。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容