ROS2 库包设置和使用 Catch2 进行单元测试

说明

        本文的目的是了解如何在 ROS2 中创建库，以供其他 ROS2 包使用。除此之外，本文还介绍了如何使用 catch2 框架编写单元测试。本文的第 1 部分将详细介绍如何创建库包。第 2 部分将介绍 ROS2 软件包如何利用创建的库

上篇  ROS2 库包设置和使用 Catch2 进行单元测试

一、项目结构大纲

库的流程

  1. 在包含/点下为 2d 点创建标题.hpp
  2. 在 src/point 下为 2d 点添加实现类.cpp
  3. 为测试下的测试类/主类创建入口点.cpp
  4. 在测试/test_point.cpp下添加单元测试
  5. 在 cmake/try_out_utils-config.cmake.in 下为 cmake 添加命名空间配置
  6. 在根项目目录下创建 CMakeLists.txt （此处指定了 lib 的配置）
  7. 在根项目目录下创建包.xml

 二、程序代码实现

2.1 为 2d 点创建标题.hpp

// include/try_out_utils/point.hpp#ifndef TRY_OUT_UTILS__POINT_HPP_
#define TRY_OUT_UTILS__POINT_HPP_namespace try_out_utils
{
class Point
{
private:double x_;double y_;public:Point(double x, double y);double get_x();double get_y();
};
}  // namespace try_out_utils#endif  // TRY_OUT_UTILS__POINT_HPP_

 2.2 为 2d 点添加实现类.cpp

        具有两个私有变量 x 和 y 的标头类，用于表示 2d 中的点及其 getter 和 setter 方法

// src/point.cpp
#include <try_out_utils/point.hpp>
Point::Point(double x, double y)
{this->x_ = x;this->y_ = y;
}
double Point::get_x()
{return this->x_;
}
double Point::get_y()
{return this->y_;
}

之前在标头类中声明的 2d 点的实现类

// test/main.cpp
#define CATCH_CONFIG_MAIN
#include <catch2/catch.hpp>

测试用例的 Catch2 入口点

// test/test_point.cpp
#include <catch2/catch.hpp>
#include <try_out_utils/point.hpp>
TEST_CASE("Test for point", "[]")
{SECTION("Test for point with object creation"){Point p(11, 10);REQUIRE(p.get_x() == 11);REQUIRE(p.get_y() == 10);}
}

对点类进行单元测试以创建新的点对象

@PACKAGE_INIT@get_filename_component(try_out_utils_CMAKE_DIR "${CMAKE_CURRENT_LIST_FILE}" PATH)include(CMakeFindDependencyMacro)if(NOT TARGET try_out_utils::try_out_utils)include("${try_out_utils_CMAKE_DIR}/try_out_utils-targets.cmake")
endif()check_required_components(try_out_utils)

三、编译文件CMake

Cmake 配置别名，以便外部包可以引用该库作为 try_out_utils::try_out_utils

# setting up cmake minimum version and project name
cmake_minimum_required(VERSION 3.8)
project(try_out_utils VERSION 0.1.0)# setting c++ version standard to 17
if(NOT CMAKE_CXX_STANDARD)set(CMAKE_CXX_STANDARD 17)
endif()# adding compiler arguments
if(CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID MATCHES "Clang")add_compile_options(-Wall -Wextra -Wpedantic)
endif()# added to use install directory variables
include(GNUInstallDirs)# adding external dependencies required
find_package(ament_cmake REQUIRED)
find_package(rclcpp REQUIRED)
find_package(ament_cmake_catch2 REQUIRED)
find_package(Catch2 REQUIRED)# creating library package with reference to required files
add_library(${PROJECT_NAME} SHAREDsrc/point.cpp
)# including external directories reference for the created library
target_include_directories(try_out_utils PUBLIC$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
)# helpers functions for creating config files that can be included by other projects to find and use a package
include(CMakePackageConfigHelpers)set(INSTALL_CONFIG_DIR "${CMAKE_INSTALL_LIBDIR}/${PROJECT_NAME}/cmake")
set(PACKAGE_CONFIG_VERSION_FILE "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}-config-version.cmake")
set(PACKAGE_CONFIG_FILE "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}-config.cmake")# creating version configuration for external package to perform compatibility check
configure_package_config_file("${CMAKE_CURRENT_LIST_DIR}/cmake/${PROJECT_NAME}-config.cmake.in"${PACKAGE_CONFIG_FILE}INSTALL_DESTINATION ${INSTALL_CONFIG_DIR}
)# creating version configuration for external package to perform compatibility check
write_basic_package_version_file(${PACKAGE_CONFIG_VERSION_FILE}COMPATIBILITY ExactVersion
)# installing library files
install(TARGETS try_out_utilsEXPORT try_out_utils-targetsDESTINATION lib
)# installing all reference header files
install(DIRECTORY include/try_out_utilsDESTINATION include/
)# installing cmake config files for try_out_utils
install(FILES${PACKAGE_CONFIG_VERSION_FILE}${PACKAGE_CONFIG_FILE}DESTINATION ${INSTALL_CONFIG_DIR}
)# installing cmake config files for try_out_utils-targets
install(EXPORT try_out_utils-targetsFILE try_out_utils-targets.cmakeNAMESPACE try_out_utils::DESTINATION ${INSTALL_CONFIG_DIR}
)# exporting the try_out_utils-target cmake config to build folder
export(EXPORT try_out_utils-targetsFILE ${CMAKE_CURRENT_BINARY_DIR}/try_out_utils-targets.cmakeNAMESPACE try_out_utils::
)# checking whether build includes test
if(BUILD_TESTING)# listing files for testingfile(GLOB_RECURSE unit_test_srcs "test/*.cpp")# adding listed files for testingament_add_catch2(test_try_out_utils ${unit_test_srcs} TIMEOUT 300)# linking libraries required to the current package for testingtarget_link_libraries(test_try_out_utilstry_out_utilsCatch2::Catch2)find_package(ament_lint_auto REQUIRED)ament_lint_auto_find_test_dependencies()
endif()ament_package()

   让我们详细介绍一下上面创建的cmakelist

  1. include（GNUInstallDirs） — 允许使用 cmake 安装变量
  2. add_library — 使用指定的参照文件创建库
  3. target_include_directories — 要包含在目标中的内部和外部包中的目录
  4. include（CMakePackageConfigHelpers） — 用于创建配置文件的帮助程序函数，其他项目可以包含这些文件来查找和使用包
  5. configure_package_config_file — 在创建用于安装项目或库的 or 文件时，应使用代替普通命令。它通过避免已安装文件中的硬编码路径来帮助使生成的包可重定位configure_package_config_file()configure_file()<PackageName>Config.cmake<PackageName>-config.cmakeConfig.cmake
  6. write_basic_package_version_file — 应该用于创建版本配置文件，以便导入此库的外部包可以执行与此处提供的版本兼容性检查
  7. 在目标位置安装目录 — 表单将一个或多个目录的内容安装到给定目标DIRECTORY
  8. 在目标位置安装文件 — 表单指定为项目安装文件的规则。在指定目标中安装文件FILES
  9. 在目标位置安装导出 — 该窗体生成并安装一个 Make 文件，其中包含用于将目标从安装树导入到另一个项目中的代码EXPORT
  10. 出口 — 创建一个可能由外部项目包含的文件，以从当前项目的生成树中导入命名的目标。这在交叉编译期间非常有用，可以生成实用程序可执行文件，这些实用程序可执行文件可以在一个项目中的主机平台上运行，然后将它们导入到为目标平台编译的另一个项目中。将字符串附加到写入文件的所有目标名称前面<filename><target>...(NAMESPACE)<namespace>
  11. 使用导出在目标位置安装目标 — 在指定目标位置安装目标的代码段。选项将已安装的目标文件与名为EXPORT<export-name>
  12. ament_add_catch2 — 使用为测试提供的测试文件创建测试目标
  13. target_link_libraries — 将目标与指定的
    库链接起来（Ament 是一个用 Cmake 编写的包装器，用于简化 colcon 构建的一些功能）
<?xml version="1.0"?>
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
<package format="3"><name>try_out_utils</name><version>0.1.0</version><description>Utility package for commonly used functions</description><maintainer email="sample@email.com">santosh balaji</maintainer><license>Apache License 2.0</license><buildtool_depend>ament_cmake</buildtool_depend><test_depend>ament_lint_auto</test_depend><test_depend>ament_lint_common</test_depend><test_depend>ament_cmake_catch2</test_depend><test_depend>ament_cmake_uncrustify</test_depend><export><build_type>ament_cmake</build_type></export>
</package>

  四、包依赖关系

      用于指定依赖项的包文件

# To build created package
colcon build --packages-select try_out_utils# To run tests on package
colcon test --event-handlers console_direct+ --packages-select try_out_utils

        运行上述命令以构建和测试库包

执行后的测试结果

下篇 ROS2 库包设置和使用 Catch2 进行单元测试

五、项目结构大纲

六、库的流程

  1. 在包含/try_out/point_checker.hpp 下为逻辑函数创建标头
  2. 在 src/point_checker.cpp 下为逻辑函数添加实现类
  3. 为测试下的测试类/主类创建入口点.cpp
  4. 在测试/test_point_checker.cpp下添加单元测试
  5. 在根项目目录下创建 CMakeLists.txt
  6. 在根项目目录下创建包.xml

七、程序实现

// include/try_out/point_checker.hpp
#ifndef TRY_OUT__POINT_CHECKER_HPP_
#define TRY_OUT__POINT_CHECKER_HPP_#include <try_out_utils/point.hpp>
#include <memory>
#include <cmath>
#include <vector>class PointChecker
{
private:std::vector<try_out_utils::Point *> points_;public:void add_point(double x, double y);std::vector<std::vector<double>> find_distance_matrix();
};#endif  // TRY_OUT__POINT_CHECKER_HPP_

带有向量的标头类，用于存储点和逻辑函数

// src/point_checker.cpp#include <try_out/point_checker.hpp>#include <vector>void PointChecker::add_point(double x, double y)
{try_out_utils::Point * point = new try_out_utils::Point(x, y);this->points_.push_back(point);
}std::vector<std::vector<double>> PointChecker::find_distance_matrix()
{std::vector<std::vector<double>> overall_vect;for (unsigned int i = 0; i < this->points_.size(); i++) {std::vector<double> inner_vect;for (unsigned int j = 0; j < this->points_.size(); j++) {double x_compute =(this->points_[j]->get_x() - this->points_[i]->get_x()) *(this->points_[j]->get_x() - this->points_[i]->get_x());double y_compute =(this->points_[j]->get_y() - this->points_[i]->get_y()) *(this->points_[j]->get_y() - this->points_[i]->get_y());double distance = std::sqrt(x_compute + y_compute);inner_vect.push_back(distance);}overall_vect.push_back(inner_vect);}return overall_vect;
}int main()
{PointChecker point_checker;point_checker.add_point(5, 5);return 0;
}

前面在标头中声明的逻辑类的实现类。此处添加了距离计算逻辑

// test/main.cpp
#define CATCH_CONFIG_MAIN
#include <catch2/catch.hpp>

测试用例的 Catch2 入口点

// test/test_point_checker.cpp#include <catch2/catch.hpp>
#include <try_out/point_checker.hpp>
#include <vector>
#include <cmath>
TEST_CASE("Test for point checker", "[]")
{SECTION("Test for distance matrix computation"{PointChecker point_checker;point_checker.add_point(1, 1);point_checker.add_point(2, 2);point_checker.add_point(3, 3);std::vector<std::vector<double>> result = point_checker.find_distance_matrix();REQUIRE(result.size() == 3);REQUIRE(result[0].size() == 3);REQUIRE(result[1].size() == 3);REQUIRE(result[2].size() == 3);REQUIRE(result[0][0] == 0);REQUIRE(std::round(result[0][1] - 1.4142135624) == 0);REQUIRE(std::round(result[0][2] - 2.8284271247) == 0);REQUIRE(std::round(result[1][2] - 1.4142135624) == 0);REQUIRE(result[1][1] == 0);REQUIRE(std::round(result[1][2] - 1.4142135624) == 0);REQUIRE(std::round(result[2][0] - 2.8284271247) == 0);REQUIRE(std::round(result[2][1] - 1.4142135624) == 0); REQUIRE(result[2][2] == 0);}
}

点检查器类的单元测试，用于计算提供的点之间的距离

# setting up cmake minimum version and project name
cmake_minimum_required(VERSION 3.8)
project(try_out VERSION 0.1.0)# setting c++ version standard to 17
if(NOT CMAKE_CXX_STANDARD)set(CMAKE_CXX_STANDARD 17)
endif()# adding compiler arguments
if(CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID MATCHES "Clang")add_compile_options(-Wall -Wextra -Wpedantic)
endif()# adding external dependencies required
find_package(ament_cmake REQUIRED)
find_package(rclcpp REQUIRED)
find_package(try_out_utils REQUIRED)
find_package(ament_cmake_catch2 REQUIRED)
find_package(Catch2 REQUIRED)# creating library package with reference to required files
add_library(try_out SHAREDsrc/point_checker.cpp
)# including external directory reference for the created library
target_include_directories(try_out PUBLIC$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>${rclcpp_INCLUDE_DIRS})# including external library reference for the created library
target_link_libraries(try_outPUBLICtry_out_utils::try_out_utils
)# creating executables with reference to required files
add_executable(try src/point_checker.cpp)# including external directory reference for the created executable
target_include_directories(try PUBLIC$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>${rclcpp_INCLUDE_DIRS})# including external library reference for the created executable
target_link_libraries(try${rclcpp_LIBRARIES}try_out_utils::try_out_utils
)# installing executable file
install(TARGETS
try
DESTINATION lib})# installing library file
install(TARGETS try_outDESTINATION lib
)# installing all reference header files
install(DIRECTORY include/try_outDESTINATION include/
)# checking whether build includes test
if(BUILD_TESTING)# listing files for testingfile(GLOB_RECURSE unit_test_srcs "test/*.cpp")# adding listed files for testingament_add_catch2(test_try_out ${unit_test_srcs} TIMEOUT 300)# linking libraries required to the current package for testingtarget_link_libraries(test_try_outtry_outtry_out_utils::try_out_utilsCatch2::Catch2)find_package(ament_lint_auto REQUIRED)ament_lint_auto_find_test_dependencies()
endif()ament_package()

九、编译环节

让我们详细介绍一下上面创建的cmakelist

  1. add_library — 使用指定的参照文件创建库
  2. add_executable — 使用指定文件创建可执行文件
  3. target_include_directories — 要包含在目标中的内部和外部包中的目录。可以使用命令
  4. target_link_libraries — 将目标与指定的库链接
  5. 在目标位置安装目录 — 表单将一个或多个目录的内容安装到给定目标DIRECTORY
  6. 在目标位置安装目标 — 表单指定从项目安装目标的规则TARGETS
  7. ament_add_catch2 — 使用提供的
    测试文件创建测试目标（Ament 是一个用 Cmake 编写的包装器，用于简化 colcon 构建的一些功能）
<?xml version="1.0"?>
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
<package format="3"><name>try_out</name><version>0.1.0</version><description>Work package which utilizes the created library package</description><maintainer email="santechselva@gmail.com">santosh balaji</maintainer><license>Apache License 2.0</license><buildtool_depend>ament_cmake</buildtool_depend><depend>try_out_utils</depend><test_depend>ament_lint_auto</test_depend><test_depend>ament_lint_common</test_depend><test_depend>ament_cmake_catch2</test_depend><test_depend>ament_cmake_uncrustify</test_depend><export><build_type>ament_cmake</build_type></export>
</package>

十、单元测试实现

        用于指定依赖项的包文件

# To build created package
colcon build --packages-select try_out# To run tests on package
colcon test --event-handlers console_direct+ --packages-select try_out

运行上述命令以构建和测试库包

执行后的测试结果

参考资料
GitHub - open-rmf/rmf_utils: Internal utilities for RMF libraries (Robotics middleware framework utilities)
GitHub - open-rmf/rmf_traffic: Traffic management libraries for RMF (Traffic management framework which uses the utility library)
CMake Reference Documentation — CMake 3.27.6 Documentation (Cmake documentation)
ament_cmake user documentation — ROS 2 Documentation: Foxy documentation (Enhanced version of Cmake for ROS2 packages)

Source code
GitHub - santoshbalaji/ros2-library-package-medium: Repository which has package used for ROS2 based work package tutorial

罗斯2
克马克
第2条军规
科尔康
阿门特

 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/125771.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

操作系统知识

操作系统知识

操作系统基础 什么是操作系统&#xff1f; 通过以下四点可以概括操作系统到底是什么&#xff1a; 操作系统&#xff08;Operating System&#xff0c;简称 OS&#xff09;是管理计算机硬件与软件资源的程序&#xff0c;是计算机的基石。操作系统本质上是一个运行在计算机上的…
阅读更多...
矢量图形编辑软件illustrator 2023 mac特点介绍

矢量图形编辑软件illustrator 2023 mac特点介绍

illustrator 2023 mac是一款矢量图形编辑软件&#xff0c;用于创建和编辑排版、图标、标志、插图和其他类型的矢量图形。 illustrator mac软件特点 矢量图形&#xff1a;illustrator创建的图形是矢量图形&#xff0c;可以无限放大而不失真&#xff0c;这与像素图形编辑软件&am…
阅读更多...
基于虚拟阻抗的下垂控制——孤岛双机并联Simulink仿真

基于虚拟阻抗的下垂控制——孤岛双机并联Simulink仿真

&#x1f4a5;&#x1f4a5;&#x1f49e;&#x1f49e;欢迎来到本博客❤️❤️&#x1f4a5;&#x1f4a5; &#x1f3c6;博主优势&#xff1a;&#x1f31e;&#x1f31e;&#x1f31e;博客内容尽量做到思维缜密&#xff0c;逻辑清晰&#xff0c;为了方便读者。 ⛳️座右铭&a…
阅读更多...
LLM评估标准有哪些？

LLM评估标准有哪些？

为了有效衡量和优化LLM的性能和泛化能力&#xff0c;并揭示其优势和局限&#xff0c;建立合理的LLM评价基准具有重要意义。现阶段&#xff0c;主流的LLM评估方法可划分为3类&#xff1a; 1&#xff09;人工评估。 基于人工的评估方法通常需要邀请大量的志愿者或相关领域专家对…
阅读更多...
【图像处理GIU】图像分割（Matlab代码实现）

【图像处理GIU】图像分割（Matlab代码实现）

&#x1f4a5;&#x1f4a5;&#x1f49e;&#x1f49e;欢迎来到本博客❤️❤️&#x1f4a5;&#x1f4a5; &#x1f3c6;博主优势&#xff1a;&#x1f31e;&#x1f31e;&#x1f31e;博客内容尽量做到思维缜密&#xff0c;逻辑清晰&#xff0c;为了方便读者。 ⛳️座右铭&a…
阅读更多...
国庆特别篇：中秋与国庆同日相迎

国庆特别篇：中秋与国庆同日相迎

国庆特别篇&#xff1a;中秋与国庆同日相迎 国庆特别篇&#xff1a;中秋与国庆同日相迎 &#x1f389;摘要引言旅途风景分享 &#x1f5fa;️中秋团圆&#xff0c;返乡之路风景宜人的旅游胜地 技术探讨&#xff1a;Java中的可变参数 &#x1f680;什么是可变参数&#xff1f;使…
阅读更多...
transformer不同的包加载模型的结构不一样

transformer不同的包加载模型的结构不一样

AutoModel AutoModelForTokenClassification 结论&#xff1a; AutoModel加载的模型与AutoModelForTokenClassification最后一层是不一样的&#xff0c;从这个模型来看&#xff0c;AutoModelForTokenClassification加载的结果是对的 问题&#xff1a; 为什么AutoModel和Aut…
阅读更多...
数据分析视角中的商业分析学习笔记

数据分析视角中的商业分析学习笔记

数据分析一大堆&#xff0c;结果却是大家早就知道的结论&#xff1f;是工具和方法出问题了吗&#xff1f;真正原因可能是你的思维有误区。 为什么分析的这么辛苦&#xff0c;得出的结论大家早知道&#xff0c;谁谁都不满意&#xff1f;核心原因有3个&#xff1a; 分析之前&am…
阅读更多...
代码随想录算法训练营第五十九天 | 647. 回文子串 516.最长回文子序列

代码随想录算法训练营第五十九天 | 647. 回文子串 516.最长回文子序列

1. 回文子串 647. 回文子串 - 力扣&#xff08;LeetCode&#xff09; 一个子串左右两个元素相等&#xff0c;并且中间对称&#xff0c;才是回文子串 即 ij 时&#xff0c;[i1: j-1]对称 dp[i][j]&#xff1a; [i:j] 是否是回文字串 当 子串长度大于2 由 dp[i1][j-1] 推出…
阅读更多...
海洋测绘外业总结（2023年9月）

海洋测绘外业总结（2023年9月）

本次外业大约历时2个多月&#xff0c;中间遇到了多波束噪声、电火花电源箱冒烟、侧扫声纳绞车承重头内部线路中断&#xff0c;连接拖鱼的硫化头烧坏问题。 1、多波束噪声的问题 在外业采集过程中&#xff0c;EM2040D多波束水体图呈现了明显三段&#xff0c;意思就是&#xff…
阅读更多...
23.2 Bootstrap框架3

23.2 Bootstrap框架3

1.卡片 1.1卡片样式 在Bootstrap 5中, .card, card-header, .card-body, .card-footer类是用于创建卡片样式.下面是这些类的简单介绍: * 1. .card: 用于创建一个基本的卡片容器它作为一个包裹元素,通常与其他卡片类一起使用.* 2. .card-header: 用于创建卡片的头部部分.通常在…
阅读更多...
【单片机】16-LCD1602和12864和LCD9648显示器

【单片机】16-LCD1602和12864和LCD9648显示器

1.LCD显示器相关背景 1.LCD简介 &#xff08;1&#xff09;显示器&#xff0c;常见显示器&#xff1a;电视&#xff0c;电脑 &#xff08;2&#xff09;LCD&#xff08;Liquid Crystal Display&#xff09;&#xff0c;液晶显示器&#xff0c;原理介绍 &#xff08;3&#xff…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023