cmake中PARENT_SCOPE

在CMake中，PARENT_SCOPE是一个用于设置变量作用域的特殊标识符。当在一个函数或者一个if语句块中定义了一个变量，并且希望将其传递到父级作用域时，可以使用PARENT_SCOPE。

具体来说，当在一个函数内部使用set命令定义了一个变量，并且在该函数外部也需要使用这个变量时，可以在set命令中添加PARENT_SCOPE标识符，将变量的作用域提升到父级作用域。

以下是一个示例：

function(example_function)
    set(local_variable "Hello" PARENT_SCOPE)
endfunction()

example_function()

message("Variable value: ${local_variable}")

在上面的示例中，我们在example_function函数内部定义了一个名为local_variable的变量，并使用PARENT_SCOPE将其作用域提升到了父级作用域。因此，在函数外部使用message命令输出local_variable的值时，可以正常访问到该变量。

相关问题

cmake PARENT_SCOPE

在 CMakeLists.txt 文件中，当我们使用 set 命令给一个变量赋值时，该变量默认只在当前作用域内有效，即只在该 set 命令所在的函数或者 if/else/foreach 等语句中有效。如果我们希望这个变量在更高层次的作用域中也能被访问，就需要使用 PARENT_SCOPE 参数。

例如，我们有两个函数分别定义了变量 var1 和 var2，且 var1 被定义在了函数内部，而 var2 被定义在了函数外部：

function(func1)
    set(var1 "hello")
endfunction()

set(var2 "world")

如果我们在 func1 函数中使用 PARENT_SCOPE 参数，则 var1 可以被 func1 的调用者访问到：

function(func1)
    set(var1 "hello" PARENT_SCOPE)
endfunction()

set(var2 "world")
func1()
message("var1: ${var1}")  # 输出 "var1: hello"
message("var2: ${var2}")  # 输出 "var2: world"

需要注意的是，使用 PARENT_SCOPE 参数将变量提升到更高层次的作用域时，需要确保该作用域中没有同名变量，否则会覆盖原有的变量。

cmake_minimum_required(VERSION 3.8.0 FATAL_ERROR) project(mcu_kit VERSION 0.1.0 DESCRIPTION "mcu-kit SDK" LANGUAGES C ) set(PROJECT_BRIEF "vDiscovery") set(CMAKE_C_STANDARD 11) set(CMAKE_C_EXTENSIONS ON) set(CMAKE_C_STANDARD_REQUIRED ON) set(CMAKE_CXX_STANDARD 11) set(CMAKE_POSITION_INDEPENDENT_CODE ON) add_compile_options(-Wall) list(APPEND CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/cmake") include(CMakePrintHelpers) include(ConfigureChecks) if(EXISTS "${PROJECT_SOURCE_DIR}/config.cmake") include(config.cmake) else() message(FATAL_ERROR "Can't find cmake.config file") endif() if(${CMAKE_CROSSCOMPILING}) set(LV_SIMULATOR_ON_PC OFF) else() set(LV_SIMULATOR_ON_PC ON) endif() configure_file( "${PROJECT_SOURCE_DIR}/base/base_sdk_version.h.in" "${PROJECT_SOURCE_DIR}/base/base_sdk_version.h" ) configure_file( "${PROJECT_SOURCE_DIR}/base/base_config.h.in" "${PROJECT_SOURCE_DIR}/base/base_config.h" ) set(CMAKE_INSTALL_BINDIR ${CMAKE_INSTALL_PREFIX}/bin) set(CMAKE_INSTALL_SBINDIR ${CMAKE_INSTALL_PREFIX}/sbin) set(CMAKE_INSTALL_LIBDIR ${CMAKE_INSTALL_PREFIX}/lib) set(CMAKE_INSTALL_INCLUDEDIR ${CMAKE_INSTALL_PREFIX}/include) set(CMAKE_INSTALL_SYSCONFDIR ${CMAKE_INSTALL_PREFIX}/etc) set(CMAKE_INSTALL_SHARESTATEDIR ${CMAKE_INSTALL_PREFIX}/com) set(CMAKE_INSTALL_LOCALSTATEDIR ${CMAKE_INSTALL_PREFIX}/var) set(CMAKE_INSTALL_INFODIR ${CMAKE_INSTALL_PREFIX}/info) set(CMAKE_INSTALL_LOCALEDIR ${CMAKE_INSTALL_PREFIX}/locate) set(CMAKE_INSTALL_MANDIR ${CMAKE_INSTALL_PREFIX}/man) set(CMAKE_INSTALL_DOCDIR ${CMAKE_INSTALL_PREFIX}/doc) set(CMAKE_INSTALL_RESDIR ${CMAKE_INSTALL_PREFIX}) include(PrepareInstall) set(KIT_ROOT_DIR ${CMAKE_SOURCE_DIR}) add_subdirectory("base") # add_subdirectory("third-party") add_subdirectory("lib") add_subdirectory("drivers") add_subdirectory("framework") add_subdirectory("sysapp") add_subdirectory("app") include(GeneratePkgConfig) include(Linux-kitInfo)详细注释一下这段代码

这段代码是一个 CMakeLists.txt 文件，用于构建一个名为 "mcu_kit" 的项目。下面是对每行代码的详细注释：

cmake_minimum_required(VERSION 3.8.0 FATAL_ERROR)

指定最低的 CMake 版本，如果当前版本不符合要求，则提示错误。

project(mcu_kit VERSION 0.1.0 DESCRIPTION "mcu-kit SDK" LANGUAGES C)

定义项目名称、版本、描述和使用的编程语言。

set(PROJECT_BRIEF "vDiscovery")

设置一个变量，用于描述项目简介。

set(CMAKE_C_STANDARD 11)
set(CMAKE_C_EXTENSIONS ON)
set(CMAKE_C_STANDARD_REQUIRED ON)
set(CMAKE_CXX_STANDARD 11)

指定使用的 C 和 C++ 标准版本。

set(CMAKE_POSITION_INDEPENDENT_CODE ON)

启用位置独立代码（PIC）选项。

add_compile_options(-Wall)

添加编译选项，这里添加了 -Wall 选项，表示开启所有警告。

list(APPEND CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/cmake")

将自定义的 CMake 模块路径添加到 CMAKE_MODULE_PATH 变量中。

include(CMakePrintHelpers)
include(ConfigureChecks)

包含两个自定义的 CMake 模块，用于输出调试信息和配置检查。

if(EXISTS "${PROJECT_SOURCE_DIR}/config.cmake")
    include(config.cmake)
else()
    message(FATAL_ERROR "Can't find cmake.config file")
endif()

如果存在 config.cmake 文件，则包含它，否则输出错误信息并停止构建。

if(${CMAKE_CROSSCOMPILING})
    set(LV_SIMULATOR_ON_PC OFF)
else()
    set(LV_SIMULATOR_ON_PC ON)
endif()

根据交叉编译标志设置变量 LV_SIMULATOR_ON_PC。如果正在交叉编译，则设置为 OFF；否则设置为 ON。

configure_file(
    "${PROJECT_SOURCE_DIR}/base/base_sdk_version.h.in"
    "${PROJECT_SOURCE_DIR}/base/base_sdk_version.h"
)
configure_file(
    "${PROJECT_SOURCE_DIR}/base/base_config.h.in"
    "${PROJECT_SOURCE_DIR}/base/base_config.h"
)

配置文件模板，用于生成编译时需要的头文件。

set(CMAKE_INSTALL_BINDIR ${CMAKE_INSTALL_PREFIX}/bin)
set(CMAKE_INSTALL_SBINDIR ${CMAKE_INSTALL_PREFIX}/sbin)
set(CMAKE_INSTALL_LIBDIR ${CMAKE_INSTALL_PREFIX}/lib)
set(CMAKE_INSTALL_INCLUDEDIR ${CMAKE_INSTALL_PREFIX}/include)
set(CMAKE_INSTALL_SYSCONFDIR ${CMAKE_INSTALL_PREFIX}/etc)
set(CMAKE_INSTALL_SHARESTATEDIR ${CMAKE_INSTALL_PREFIX}/com)
set(CMAKE_INSTALL_LOCALSTATEDIR ${CMAKE_INSTALL_PREFIX}/var)
set(CMAKE_INSTALL_INFODIR ${CMAKE_INSTALL_PREFIX}/info)
set(CMAKE_INSTALL_LOCALEDIR ${CMAKE_INSTALL_PREFIX}/locate)
set(CMAKE_INSTALL_MANDIR ${CMAKE_INSTALL_PREFIX}/man)
set(CMAKE_INSTALL_DOCDIR ${CMAKE_INSTALL_PREFIX}/doc)
set(CMAKE_INSTALL_RESDIR ${CMAKE_INSTALL_PREFIX})

设置安装目录的各个子目录。

include(PrepareInstall)

包含一个自定义的 CMake 模块，用于准备安装目录。

set(KIT_ROOT_DIR ${CMAKE_SOURCE_DIR})

设置变量 KIT_ROOT_DIR 的值为源代码目录。

add_subdirectory("base")
add_subdirectory("lib")
add_subdirectory("drivers")
add_subdirectory("framework")
add_subdirectory("sysapp")
add_subdirectory("app")

添加子目录，用于构建项目的各个模块。每个子目录都包含了相应的 CMakeLists.txt 文件。