CMake解决CubeMX生成同名STM32库冲突的方案咨询

我刚接触CMake，可能缺乏关键概念。我使用CubeMX为多块开发板生成硬件专属代码，每块板的自动生成文件中都包含定义了名为stm32cubemx库的CMakeLists.txt。我需要在同一项目中引入两块板（如BoardA和BoardB）的库，并为每块板生成一个可执行文件，但由于两个库同名，CMake会报冲突。

BoardA/cmake/CMakeLists.txt中的内容如下：

project(stm32cubemx)
add_library(stm32cubemx INTERFACE)  <-- 手动修改此处可解决问题

# Enable CMake support for ASM and C languages
enable_language(C ASM)

target_compile_definitions(stm32cubemx INTERFACE 
    USE_HAL_DRIVER 
    STM32F401xE
    $<$<CONFIG:Debug>:DEBUG>
)

target_include_directories(stm32cubemx INTERFACE
    ../../Core/Inc
    ...
)
...

文件结构如下：

project :
 |-CMakelists.txt
 |-main.cpp
 |-Hardwares :
 |--|BoardA : <-- 自动生成的文件夹 
 |--|--|CMakelists.txt   <-- 可修改但无重要内容
 |--|--|Src & Inc folders
 |--|--|cmake : CMakeLists.txt <-- 不可修改，定义库"stm32cubemx"及板级配置
 |--|BoardB : <-- 与BoardA结构相同
 |--|--|CMakelists.txt
 |--|--|Src & Inc folders
 |--|--|cmake : CMakeLists.txt

手动修改生成的CMakeLists中的库名可解决问题，但硬件代码重新生成后会被覆盖。我无法复制自动生成CMakeLists中的配置，因为它会随硬件配置变化，还会给其他开发者造成困惑。我尝试过用ALIAS添加库，但调用add_subdirectory(BoardX/cmake)时就会失败。我查看了CubeMX生成器的设置，未发现可手动设置库名的选项。编写Python脚本在每次生成后修改文件是一个选项，但肯定有更简洁的方法。请问是否有方法隔离、重命名自动生成的库，或规避冲突？

方法1：子目录作用域+命名空间隔离 #

利用CMake子目录的作用域特性，为每个板的库创建独立命名空间，避免全局冲突：

1. 为每个板创建中间包装配置文件（比如BoardA/CMakeListsWrapper.txt），内容如下：

# BoardA/CMakeListsWrapper.txt
add_subdirectory(cmake)
add_library(BoardA::stm32cubemx ALIAS stm32cubemx)

BoardB的包装文件同理，将别名改为BoardB::stm32cubemx。

2. 根目录CMakeLists.txt中，为两个板指定独立的二进制构建目录，隔离作用域：

# 根目录CMakeLists.txt
# 引入BoardA，指定单独的构建目录
add_subdirectory(Hardwares/BoardA ${CMAKE_BINARY_DIR}/BoardA_build)
# 引入BoardB，指定另一个构建目录
add_subdirectory(Hardwares/BoardB ${CMAKE_BINARY_DIR}/BoardB_build)

# 为BoardA生成可执行文件
add_executable(BoardA_app main.cpp)
target_link_libraries(BoardA_app PRIVATE BoardA::stm32cubemx)

# 为BoardB生成可执行文件
add_executable(BoardB_app main.cpp)
target_link_libraries(BoardB_app PRIVATE BoardB::stm32cubemx)

每个板的stm32cubemx库仅在自身子目录作用域内可见，通过命名空间别名在根目录调用，完全规避冲突。

方法2：CMake函数动态修改库名 #

编写CMake函数，在构建时自动复制并修改CubeMX生成的CMakeLists.txt，无需手动改动原始文件：

在根目录CMakeLists.txt中添加如下函数和调用逻辑：

function(add_board_library BOARD_NAME BOARD_PATH)
    # 创建临时目录，复制自动生成的CMakeLists.txt
    set(TEMP_CMAKE_DIR ${CMAKE_BINARY_DIR}/temp_${BOARD_NAME})
    file(MAKE_DIRECTORY ${TEMP_CMAKE_DIR})
    file(COPY ${BOARD_PATH}/cmake/CMakeLists.txt DESTINATION ${TEMP_CMAKE_DIR})

    # 替换库名为带板标识的名称
    file(READ ${TEMP_CMAKE_DIR}/CMakeLists.txt CMAKE_CONTENT)
    string(REPLACE "add_library(stm32cubemx INTERFACE)" "add_library(${BOARD_NAME}_stm32cubemx INTERFACE)" CMAKE_CONTENT "${CMAKE_CONTENT}")
    file(WRITE ${TEMP_CMAKE_DIR}/CMakeLists.txt "${CMAKE_CONTENT}")

    # 引入修改后的配置
    add_subdirectory(${TEMP_CMAKE_DIR} ${CMAKE_BINARY_DIR}/build_${BOARD_NAME})

    # 创建别名方便调用
    add_library(${BOARD_NAME}::stm32cubemx ALIAS ${BOARD_NAME}_stm32cubemx)
endfunction()

# 调用函数引入两个板的库
add_board_library(BoardA ${CMAKE_SOURCE_DIR}/Hardwares/BoardA)
add_board_library(BoardB ${CMAKE_SOURCE_DIR}/Hardwares/BoardB)

# 生成可执行文件
add_executable(BoardA_app main.cpp)
target_link_libraries(BoardA_app PRIVATE BoardA::stm32cubemx)

add_executable(BoardB_app main.cpp)
target_link_libraries(BoardB_app PRIVATE BoardB::stm32cubemx)

该方法会在构建阶段自动修改临时副本的库名，不影响CubeMX生成的原始文件，重新生成代码后仍能自动适配。

方法3：对象库手动包装（适合配置稳定场景） #

如果上述方法不适用，可将每个板的源码打包成对象库，手动同步CubeMX生成的编译参数：

# 处理BoardA
file(GLOB_RECURSE BoardA_SOURCES 
    Hardwares/BoardA/Src/*.c 
    Hardwares/BoardA/Src/*.s
)
add_library(BoardA_STM32 OBJECT ${BoardA_SOURCES})

# 同步CubeMX生成的编译定义和头文件路径
target_compile_definitions(BoardA_STM32 PRIVATE
    USE_HAL_DRIVER
    STM32F401xE
    $<$<CONFIG:Debug>:DEBUG>
)
target_include_directories(BoardA_STM32 PRIVATE
    Hardwares/BoardA/Core/Inc
    # 补充其他自动生成的头文件目录
)

# 同理处理BoardB
file(GLOB_RECURSE BoardB_SOURCES 
    Hardwares/BoardB/Src/*.c 
    Hardwares/BoardB/Src/*.s
)
add_library(BoardB_STM32 OBJECT ${BoardB_SOURCES})

target_compile_definitions(BoardB_STM32 PRIVATE
    USE_HAL_DRIVER
    STM32F407xx # 替换为BoardB的芯片型号
    $<$<CONFIG:Debug>:DEBUG>
)
target_include_directories(BoardB_STM32 PRIVATE
    Hardwares/BoardB/Core/Inc
    # 补充其他自动生成的头文件目录
)

# 链接到可执行文件
add_executable(BoardA_app main.cpp)
target_link_libraries(BoardA_app PRIVATE BoardA_STM32)

add_executable(BoardB_app main.cpp)
target_link_libraries(BoardB_app PRIVATE BoardB_STM32)

注意：该方法需要在CubeMX修改硬件配置后，手动同步编译参数和头文件路径，适合配置不频繁变动的场景。

内容的提问来源于stack exchange，提问作者toin