# TODO 1: State that anybody linking to MathFunctions needs to include the
#
# 这句代码的意思是将 `MathFunctions` 目标的当前源目录（`${CMAKE_CURRENT_SOURCE_DIR}`）添加到 #`MathFunctions` 目标的包含目录中，并且这个包含目录是以 `INTERFACE` 的形式添加的。
#
#`INTERFACE` 的意思是这个包含目录信息将会传播给所有链接到 `MathFunctions` 的目标。
# 也就是说，任何链接到 #`MathFunctions` 的目标（例如 `Tutorial`）都会自动包含 `MathFunctions` 的当前源目录作为它们的包含目录。

target_include_directories(MathFunctions INTERFACE ${CMAKE_CURRENT_SOURCE_DIR})

# TODO 2: Remove EXTRA_INCLUDES list

# add the MathFunctions library
add_subdirectory(MathFunctions)

# 这里注释掉了，不用包含了，因为链接的时候库会自己处理包含目录了
# list(APPEND EXTRA_INCLUDES "${PROJECT_SOURCE_DIR}/MathFunctions")

# TODO 3: Remove use of EXTRA_INCLUDES

# add the binary tree to the search path for include files
# so that we will find TutorialConfig.h
#
# target_include_directories(Tutorial PUBLIC
#                            "${PROJECT_BINARY_DIR}"
#                            ${EXTRA_INCLUDES}
#                            )
# 这里删除了 ${EXTRA_INCLUDES} 变量，因为list追加的已经没了，库也自包含了只需要链接就可以了。
target_include_directories(Tutorial PUBLIC
                           "${PROJECT_BINARY_DIR}"
                           )

# TODO 4: Replace the following code by:
# * Creating an interface library called tutorial_compiler_flags
#   Hint: use add_library() with the INTERFACE signature
# * Add compiler feature cxx_std_11 to tutorial_compiler_flags
#   Hint: Use target_compile_features()

# specify the C++ standard
# 注释掉之前用set设置的环境变量的约束
# set(CMAKE_CXX_STANDARD 11)
# set(CMAKE_CXX_STANDARD_REQUIRED True)

# 创建一个新的 Lib 名为`tutorial_compiler_flags`亦或是其他
add_library(tutorial_compiler_flags INTERFACE)

# `target_compile_features` 是 CMake 中用于指定目标所需的编译特性的命
# 令。它允许你为目标设置特定的编译器特性，例如 C++ 标准版本。

# 这行代码的意思是为 `tutorial_compiler_flags` 接口库添加 `cxx_std_11` 
# 编译特性，这意味着任何链接到 `tutorial_compiler_flags` 的目标都需要支
# 持 C++11 标准。

# `target_compile_features` 的常见用法包括：
# * `PRIVATE`：仅当前目标需要这些编译特性。
# * `PUBLIC`：当前目标和所有链接到它的目标都需要这些编译特性。
# * `INTERFACE`：仅链接到当前目标的目标需要这些编译特性。
target_compile_features(tutorial_compiler_flags INTERFACE cxx_std_11)

# TODO 5: Link Tutorial to tutorial_compiler_flags
# 
# 这行代码的意思是将 `MathFunctions` 和 `tutorial_compiler_flags` 库链
# 接到 `Tutorial` 可执行文件，并且这些链接是以 `PUBLIC` 的形式添加的。
#
# `PUBLIC` 的意思是：
# * 任何链接到 `Tutorial` 的目标也会继承这些链接库。

target_link_libraries(Tutorial PUBLIC MathFunctions tutorial_compiler_flags)

# 从这里开的if然后省略了写内容
if (USE_MYMATH)...

# TODO 6: Link SqrtLibrary to tutorial_compiler_flags

# 链接`tutorial_compiler_flags`到`SqrtLibrary`
# `target_link_libraries` 命令用于指定目标需要链接的库。
# 这里使用 `PUBLIC` 关键字的原因是为了确保依赖关系能够传播到任何链接到 `SqrtLibrary` 的目标。
# * `PRIVATE`：依赖关系仅用于目标本身。
# * `INTERFACE`：依赖关系仅用于链接到该目标的其他目标。
# * `PUBLIC`：依赖关系既用于目标本身，也用于链接到该目标的其他目标。
  target_link_libraries(SqrtLibrary PUBLIC tutorial_compiler_flags)

# 链接`SqrtLibrary`到`MathFunctions`并且被`tutorial_compiler_flags`传播了
  target_link_libraries(MathFunctions PRIVATE SqrtLibrary)
endif()

# TODO 7: Link MathFunctions to tutorial_compiler_flags
# 这一行的作用是将 `tutorial_compiler_flags` 的设置传播到任何链接到 `MathFunctions` 的目标。
# 这是因为 `PUBLIC` 关键字会将依赖关系传播到所有依赖 `MathFunctions` 的目标。
target_link_libraries(MathFunctions PUBLIC tutorial_compiler_flags)