optimal & fix file cmake

This commit is contained in:
2026-08-03 22:40:26 +07:00
parent 33ee9b7f31
commit 2223453639
120 changed files with 12204 additions and 1886 deletions

View File

@@ -1,8 +1,8 @@
cmake_minimum_required(VERSION 3.0.2)
project(mission_adapters VERSION 1.0.0 LANGUAGES CXX)
project(mission_adapters VERSION 0.2.0 LANGUAGES CXX)
# ========================================================
# Detect build mode
# Build mode detection
# ========================================================
if(DEFINED CATKIN_DEVEL_PREFIX OR DEFINED CATKIN_TOPLEVEL)
set(BUILDING_WITH_CATKIN TRUE)
@@ -12,6 +12,7 @@ else()
message(STATUS "Building mission_adapters with Standalone CMake")
endif()
# ========================================================
# C++ Standard
# ========================================================
@@ -19,18 +20,24 @@ set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)
# ========================================================
# Common dependencies
# ========================================================
find_package(PCL REQUIRED)
find_package(OpenMP REQUIRED)
find_package(Boost REQUIRED COMPONENTS system)
find_package(Eigen REQUIRED)
# ========================================================
# Standalone mode
# Common dependencies
#
# Chỉ những thứ code thật sự dùng: message contract (robot_protocol_msgs / robot_geometry_msgs),
# tiện ích ROS-like (robot_cpp / robot_time) và Boost header (boost::shared_ptr trong message).
# PCL / OpenMP / Eigen của bản trước là di sản copy từ template planner, gói này không dùng.
# ========================================================
if (NOT BUILDING_WITH_CATKIN)
# Boost.DLL cần system + filesystem để nạp plugin theo library_path.
find_package(Boost REQUIRED COMPONENTS system filesystem)
find_package(Threads REQUIRED)
find_package(yaml-cpp REQUIRED)
# ========================================================
# Standalone configuration
# ========================================================
if(NOT BUILDING_WITH_CATKIN)
set(CMAKE_POSITION_INDEPENDENT_CODE ON)
@@ -38,174 +45,154 @@ if (NOT BUILDING_WITH_CATKIN)
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
set(CMAKE_BUILD_RPATH "${CMAKE_BINARY_DIR}")
# ⚠️ NOTE: Đây KHÔNG phải package thật -> chỉ để placeholder
# Test/<pkg> -> src/AMR_T800/pnkx_nav_core/src
set(PNKX_NAV_CORE_SRC_DIR
"${CMAKE_CURRENT_SOURCE_DIR}/../../pnkx_nav_core/src"
)
# Test/<pkg> -> T800_ws/devel/lib
set(WORKSPACE_DEVEL_LIB_DIR
"${CMAKE_CURRENT_SOURCE_DIR}/../../../../devel/lib"
)
file(GLOB STANDALONE_PACKAGE_INCLUDE_DIRS
LIST_DIRECTORIES true
${PNKX_NAV_CORE_SRC_DIR}/*/include
${PNKX_NAV_CORE_SRC_DIR}/*/*/include
${PNKX_NAV_CORE_SRC_DIR}/*/*/*/include
${PNKX_NAV_CORE_SRC_DIR}/*/*/*/*/include
)
set(STANDALONE_INCLUDE_DIRS
${STANDALONE_PACKAGE_INCLUDE_DIRS}
/usr/local/include
)
set(PACKAGES_DIR
robot_costmap_2d
robot_nav_core
robot_nav_core2
robot_nav_msgs
robot_std_msgs
robot_geometry_msgs
robot_cpp
robot_tf3_geometry_msgs
robot_visualization_msgs
robot_nav_2d_utils
data_convert
robot_time
robot_xmlrpcpp
)
find_library(TF3_LIBRARY
NAMES tf3
PATHS /usr/lib /usr/local/lib /usr/lib/x86_64-linux-gnu
)
if(NOT TF3_LIBRARY)
message(FATAL_ERROR "❌ tf3 library not found")
if(EXISTS ${WORKSPACE_DEVEL_LIB_DIR})
link_directories(${WORKSPACE_DEVEL_LIB_DIR})
endif()
link_directories(/usr/local/lib)
# ========================================================
# Catkin mode
# Catkin configuration
# ========================================================
else()
find_package(catkin REQUIRED COMPONENTS
robot_costmap_2d
robot_nav_core
robot_nav_core2
robot_nav_msgs
robot_std_msgs
robot_geometry_msgs
robot_cpp
robot_tf3_geometry_msgs
robot_visualization_msgs
robot_nav_2d_utils
data_convert
robot_time
robot_geometry_msgs
robot_protocol_msgs
robot_std_msgs
)
find_library(TF3_LIBRARY
NAMES tf3
PATHS /usr/lib /usr/local/lib /usr/lib/x86_64-linux-gnu
)
if(NOT TF3_LIBRARY)
message(FATAL_ERROR "❌ tf3 library not found")
endif()
catkin_package(
INCLUDE_DIRS include
LIBRARIES ${PROJECT_NAME}
INCLUDE_DIRS
include
LIBRARIES
mission_adapters
CATKIN_DEPENDS
robot_costmap_2d
robot_nav_core
robot_nav_core2
robot_nav_msgs
robot_std_msgs
robot_geometry_msgs
robot_cpp
robot_tf3_geometry_msgs
robot_visualization_msgs
robot_nav_2d_utils
data_convert
DEPENDS PCL Boost
robot_time
robot_geometry_msgs
robot_protocol_msgs
robot_std_msgs
DEPENDS
Boost
)
include_directories(
include
include_directories(include)
# SYSTEM: header của dependency (robot_cpp/console.h khai hàng chục hằng màu không dùng) sẽ ngập
# warning dưới -Wall -Wextra và che mất warning của chính gói này.
include_directories(SYSTEM
${catkin_INCLUDE_DIRS}
${PCL_INCLUDE_DIRS}
${Boost_INCLUDE_DIRS}
)
endif()
# ========================================================
# Libraries
# ========================================================
# # utils lib
# add_library(${PROJECT_NAME}_utils SHARED
# src/angle_utils.cpp
# src/config.cpp
# )
# main planner lib
add_library(${PROJECT_NAME} SHARED
src/mission_adapters.cpp
# ========================================================
# Core library
# ========================================================
add_library(mission_adapters SHARED
src/types.cpp
src/event.cpp
src/mission_manager.cpp
src/mission_executor.cpp
src/event_processor.cpp
src/mission_config.cpp
src/plugin_registry.cpp
)
# Gói này KHÔNG kế thừa cờ -w của pnkx_nav_core: warning ở đây phải nhìn thấy được.
target_compile_options(mission_adapters PRIVATE -Wall -Wextra)
target_include_directories(mission_adapters
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
$<INSTALL_INTERFACE:include>
)
# ========================================================
# Catkin linking
# Linking
# ========================================================
if(BUILDING_WITH_CATKIN)
# add_dependencies(${PROJECT_NAME}_utils ${catkin_EXPORTED_TARGETS})
add_dependencies(${PROJECT_NAME} ${catkin_EXPORTED_TARGETS})
add_dependencies(mission_adapters
${${PROJECT_NAME}_EXPORTED_TARGETS}
${catkin_EXPORTED_TARGETS}
)
# target_include_directories(${PROJECT_NAME}_utils
# PUBLIC
# $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
# $<INSTALL_INTERFACE:include>
# )
target_include_directories(${PROJECT_NAME}
target_link_libraries(mission_adapters
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
$<INSTALL_INTERFACE:include>
${catkin_LIBRARIES}
PRIVATE
Boost::boost
Boost::system
Boost::filesystem
Threads::Threads
${CMAKE_DL_LIBS}
yaml-cpp
)
# target_link_libraries(${PROJECT_NAME}_utils
# PUBLIC ${catkin_LIBRARIES}
# PRIVATE Boost::system
# ${TF3_LIBRARY}
# )
target_link_libraries(${PROJECT_NAME}
# PUBLIC ${PROJECT_NAME}_utils
PUBLIC ${catkin_LIBRARIES}
PUBLIC ${PCL_LIBRARIES}
PRIVATE Boost::system
${TF3_LIBRARY}
OpenMP::OpenMP_CXX
)
# ========================================================
# Standalone linking
# ========================================================
else()
# target_include_directories(${PROJECT_NAME}_utils
# PUBLIC
# $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
# $<INSTALL_INTERFACE:include>
# )
target_include_directories(mission_adapters
PRIVATE
${STANDALONE_INCLUDE_DIRS}
${Boost_INCLUDE_DIRS}
)
target_include_directories(${PROJECT_NAME}
target_link_libraries(mission_adapters
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
$<INSTALL_INTERFACE:include>
${PACKAGES_DIR}
PRIVATE
Boost::boost
Boost::system
Boost::filesystem
Threads::Threads
${CMAKE_DL_LIBS}
yaml-cpp
)
# target_link_libraries(${PROJECT_NAME}_utils
# PUBLIC ${PACKAGES_DIR} # ⚠️ placeholder
# PRIVATE Boost::system
# ${TF3_LIBRARY}
# )
target_link_libraries(${PROJECT_NAME}
# PUBLIC ${PROJECT_NAME}_utils
PUBLIC ${PACKAGES_DIR} # ⚠️ placeholder
PUBLIC ${PCL_LIBRARIES}
PRIVATE Boost::system
${TF3_LIBRARY}
OpenMP::OpenMP_CXX
)
# set_target_properties(${PROJECT_NAME}_utils PROPERTIES
# LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}
# BUILD_RPATH "${CMAKE_BINARY_DIR}"
# INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib"
# )
set_target_properties(${PROJECT_NAME} PROPERTIES
set_target_properties(mission_adapters PROPERTIES
LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}
BUILD_RPATH "${CMAKE_BINARY_DIR}"
INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib"
@@ -213,12 +200,110 @@ else()
endif()
# ========================================================
# Plugins — mỗi nguồn mission là một .so riêng.
#
# Tên file .so phải khớp khoá `library_path` trong
# `pnkx_nav_core/config/mission_adapters_params.yaml`; tên symbol export phải khớp khoá `type`
# trong `mission_sources`. Lệch một trong hai thì build vẫn sạch còn runtime báo "không tìm thấy".
# ========================================================
set(MISSION_ADAPTERS_PLUGIN_TARGETS
mission_adapters_goal_source
mission_adapters_vda5050_source
)
add_library(mission_adapters_goal_source SHARED plugins/goal_source_adapter.cpp)
add_library(mission_adapters_vda5050_source SHARED plugins/vda5050_source_adapter.cpp)
foreach(plugin_target ${MISSION_ADAPTERS_PLUGIN_TARGETS})
target_compile_options(${plugin_target} PRIVATE -Wall -Wextra)
set_target_properties(${plugin_target} PROPERTIES POSITION_INDEPENDENT_CODE ON)
target_include_directories(${plugin_target}
PUBLIC
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/plugins>
)
target_link_libraries(${plugin_target}
PUBLIC
mission_adapters
PRIVATE
Boost::boost
Threads::Threads
)
if(NOT BUILDING_WITH_CATKIN)
target_include_directories(${plugin_target} PRIVATE ${STANDALONE_INCLUDE_DIRS})
target_link_libraries(${plugin_target} PRIVATE ${PACKAGES_DIR})
set_target_properties(${plugin_target} PROPERTIES
LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}
BUILD_RPATH "${CMAKE_BINARY_DIR}"
INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib"
)
endif()
endforeach()
# ========================================================
# Example
#
# Có build để tài liệu không trôi khỏi API: đổi contract mà quên ví dụ thì build gãy ngay.
# ========================================================
option(BUILD_MISSION_ADAPTERS_EXAMPLES "Build mission_adapters examples" ON)
if(BUILD_MISSION_ADAPTERS_EXAMPLES)
add_executable(robot_control_example examples/robot_control_example.cpp)
target_compile_options(robot_control_example PRIVATE -Wall -Wextra)
target_link_libraries(robot_control_example
PRIVATE
mission_adapters
Threads::Threads
)
if(NOT BUILDING_WITH_CATKIN)
target_include_directories(robot_control_example
PRIVATE
${STANDALONE_INCLUDE_DIRS}
)
target_link_libraries(robot_control_example PRIVATE ${PACKAGES_DIR})
endif()
# Demo: chạy một VDA5050 Order qua VDA5050SourceAdapter và in ra các chặng thu được.
# Link thẳng plugin source adapter thay vì nạp qua boost::dll — demo chỉ cần xem kết quả cắt
# chặng, không cần kiểm tra đường nạp plugin.
add_executable(vda5050_order_demo examples/vda5050_order_demo.cpp)
target_compile_options(vda5050_order_demo PRIVATE -Wall -Wextra)
target_link_libraries(vda5050_order_demo
PRIVATE
mission_adapters
mission_adapters_vda5050_source
Threads::Threads
)
if(NOT BUILDING_WITH_CATKIN)
target_include_directories(vda5050_order_demo PRIVATE ${STANDALONE_INCLUDE_DIRS})
target_link_libraries(vda5050_order_demo PRIVATE ${PACKAGES_DIR})
endif()
endif()
# ========================================================
# Install
# ========================================================
if(BUILDING_WITH_CATKIN)
install(TARGETS ${PROJECT_NAME}
install(TARGETS mission_adapters ${MISSION_ADAPTERS_PLUGIN_TARGETS}
ARCHIVE DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION}
LIBRARY DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION}
RUNTIME DESTINATION ${CATKIN_GLOBAL_BIN_DESTINATION}
@@ -229,15 +314,9 @@ if(BUILDING_WITH_CATKIN)
FILES_MATCHING PATTERN "*.h"
)
if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/plugins.xml)
install(FILES plugins.xml
DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION}
)
endif()
else()
install(TARGETS ${PROJECT_NAME}
install(TARGETS mission_adapters ${MISSION_ADAPTERS_PLUGIN_TARGETS}
EXPORT ${PROJECT_NAME}-targets
ARCHIVE DESTINATION lib
LIBRARY DESTINATION lib
@@ -255,56 +334,71 @@ else()
FILES_MATCHING PATTERN "*.h"
)
if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/plugins.xml)
install(FILES plugins.xml
DESTINATION share/${PROJECT_NAME}
)
endif()
endif()
# ========================================================
# Unit Test
# Tests
#
# Gói này đăng ký test với catkin/ctest (chạy được qua `catkin_make run_tests`) VÀ mở
# EXCLUDE_FROM_ALL để binary có mặt sau `catkin_make` thường — chạy thẳng
# ./devel/lib/mission_adapters/<test> theo đúng quy trình verify của repo.
# ========================================================
if(CATKIN_ENABLE_TESTING)
if(CATKIN_ENABLE_TESTING AND BUILDING_WITH_CATKIN)
find_package(catkin REQUIRED COMPONENTS
robot_costmap_2d
robot_nav_core
robot_nav_core2
robot_nav_msgs
robot_std_msgs
robot_geometry_msgs
robot_cpp
robot_tf3_geometry_msgs
robot_visualization_msgs
robot_nav_2d_utils
data_convert
)
message(STATUS "CATKIN_ENABLE_TESTING=${CATKIN_ENABLE_TESTING}")
if(COMMAND catkin_add_gtest)
message(STATUS "catkin_add_gtest exists")
else()
if(NOT COMMAND catkin_add_gtest)
message(FATAL_ERROR "catkin_add_gtest NOT FOUND")
endif()
catkin_add_gtest(test_mission_adapters
test/mission_adapters_test.cpp
set(MISSION_ADAPTERS_TESTS
event_bus_test
adapter_test
mission_manager_test
mission_lifecycle_test
plugin_registry_test
)
if(TARGET test_mission_adapters)
target_link_libraries(test_mission_adapters
mission_adapters
${catkin_LIBRARIES}
pthread
)
foreach(test_name ${MISSION_ADAPTERS_TESTS})
catkin_add_gtest(${test_name} test/${test_name}.cpp)
target_include_directories(test_mission_adapters PRIVATE
${CMAKE_CURRENT_SOURCE_DIR}/include
${catkin_INCLUDE_DIRS}
)
endif()
if(TARGET ${test_name})
set_target_properties(${test_name} PROPERTIES EXCLUDE_FROM_ALL FALSE)
target_compile_options(${test_name} PRIVATE -Wall -Wextra)
target_include_directories(${test_name}
PRIVATE
${CMAKE_CURRENT_SOURCE_DIR}/include
${CMAKE_CURRENT_SOURCE_DIR}/plugins
${CMAKE_CURRENT_SOURCE_DIR}/test
)
target_include_directories(${test_name} SYSTEM
PRIVATE
${catkin_INCLUDE_DIRS}
)
# catkin_add_gtest dùng target_link_libraries dạng plain, nên phần bổ sung cũng phải plain.
#
# Test link thẳng plugin .so để kiểm logic chuyển đổi ở mức unit; đường nạp qua Boost.DLL
# được kiểm riêng trong plugin_registry_test.
target_link_libraries(${test_name}
mission_adapters
${MISSION_ADAPTERS_PLUGIN_TARGETS}
${catkin_LIBRARIES}
pthread
)
# plugin_registry_test nạp .so từ devel/lib theo library_path, nên cần cả hai plugin đã build.
add_dependencies(${test_name} ${MISSION_ADAPTERS_PLUGIN_TARGETS})
# Đường tới cây config và thư mục .so của test, để binary tự trỏ đúng chỗ khi chạy qua ctest
# (ctest không mang theo PNKX_NAV_CORE_CONFIG_DIR hay LD_LIBRARY_PATH của shell).
target_compile_definitions(${test_name} PRIVATE
MISSION_ADAPTERS_TEST_CONFIG_DIR="${CMAKE_CURRENT_SOURCE_DIR}/test/config"
MISSION_ADAPTERS_TEST_LIBRARY_DIR="${CATKIN_DEVEL_PREFIX}/lib"
)
endif()
endforeach()
endif()