【ROS翻译】ROS2 Ament教程

2024-05-30 18:08
文章标签 教程 翻译 ros ros2 ament

本文主要是介绍【ROS翻译】ROS2 Ament教程,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!


 说明:
 本文首发于 Playfish Blog,转载请保留链接。


概述


这将为你提供一个快速总结,如何使用一个工作空间来启动和运行。它将是一个实用的教程,并不是用来取代核心文档的。

背景


Ament是catkin元构建工具的一个迭代。欲了解更多有关Ament设计的资料,请参阅 本文件。

该源可以在 ament Github组织中找到。

先决条件


开发环境


请确保根据build-from-source 指令设置开发环境。

基础知识


一个ament空间是一个具有特定结构的目录,通常有一个src子目录,在该子目录中,源代码将位于其中,一般情况下,目录开始为空。

Ament是由源生成的。默认情况下,它将创建一个和src并行的目录:build和install目录。build目录将是存储中间文件的地方。对于每个包,将在其中创建一个子文件夹,其中将调用CMake。install目录是每个包被安装到的地方。

注意:与catkin相比,没有devel目录。

 创建目录结构


在~/ros2_ws下创建基本目录结构:

mkdir -p ~/ros_ws/src
cd ~/ros2_ws

这是~/ros2_ws的目录结构,你可以在这一点上看到:
.
└── src1 directory, 0 files

添加源码

首先,我们需要安装一个没有任何ROS2安装的底层。

wget https://raw.githubusercontent.com/ros2/ros2/master/ros2.repos
vcs import ~/ros2_ws/src < ros2.repos

这是~/ros2_ws的目录结构,你可以期望在添加了数据源之后(请注意,具体的结构和目录的数量可能会随着时间而变化)


.
├── ros2.repos
└── src├── ament│   ├── ament_cmake│   ├── ament_index|   ...│   ├── osrf_pycommon│   └── uncrustify├── eProsima│   ├── Fast-CDR│   └── Fast-RTPS├── ros│   ├── class_loader│   └── console_bridge└── ros2├── ament_cmake_ros├── common_interfaces├── demos...├── urdfdom├── urdfdom_headers└── vision_opencv51 directories, 1 file


运行build


因为这是一个引导环境,我们需要通过它的完整路径调用ament.py。

注意:在将来,一旦在你的系统上安装了ament,或者在工作环境下,这将不再是必要的。

由于在ament上没有devel空间,因此需要安装它支持的每个包--symlink-install。

这允许通过将source空间中的文件(例如Python文件或其他未编译的资源)更改为更快的迭代,从而更改已安装的文件。

src/ament/ament_tools/scripts/ament.py build --build-tests --symlink-install

运行测试


要运行你刚刚构建的测试,使用--build-test选项,运行以下操作:

src/ament/ament_tools/scripts/ament.py test

如果你在包括测试之前建好了(并且安装了)工作区,你可以跳过构建和安装步骤来加快进程。

src/ament/ament_tools/scripts/ament.py test --skip-build --skip-install

source环境


当构造成功完成构建时,输出将在install目录中。

要使用你需要的可执行文件和库,请将install/bin目录添加到你的路径中。

Ament将在install目录中生成bash文件,以帮助设置环境。

这些文件将向你的路径和库路径添加所需的元素,并提供由包导出的bash或shell命令。

. install/local_setup.bash

NB:这与catkin略有不同。

local_setup.*文件与setup.*文件略有不同。它只会应用当前工作区的设置。

当使用多个工作空间时,你仍然会提供setup.*文件获取环境,包括所有的父工作区。

尝试演示


通过环境来源,你现在可以运行由ament构建的可执行文件。
ros2 run demo_nodes_cpp listener &
ros2 run demo_nodes_cpp talker

你会看到数字在增加。

让我们删除节点并尝试创建我们自己的工作区覆盖。
^-C
kill %1

开发你的功能包


在 REP 140中,Ament使用和catkin一样的指定文件package.xml。

你可以在src目录下创建你自己的功能包,然而,在迭代的时候要用一个叠加来进行迭代。

创建覆盖


现在你已经设置好了你的引导,你也会发现ament在你的路径上。

让我们创建一个新的覆盖目录: ~/ros2_overlay_ws。

mkdir -p ~/ros2_overlay_ws/src
cd ~/ros2_overlay_ws/src

并且我们开始覆盖 ros2/examples 存储库:

# If you know that you're using the latest branch of all
# repositories in the underlay, you can also get the latest
# version of the ros2/examples repository, with this command:
#   git clone https://github.com/ros2/examples.git
# Otherwise, clone a copy from the underlay source code:
git clone ~/ros2_ws/src/ros2/examples

构建覆盖层,但是让我们使用debug构建,这样我们就可以确保得到调试符号:

cd ~/ros2_overlay_ws
ament build --cmake-args -DCMAKE_BUILD_TYPE=Debug

现在这个覆盖层在现有的覆盖层之上,所以你会发现`talker`现在指的是来自底层的那个。

如果你source ~/ros2_overlay_ws/install/local_setup.bash将更改为在覆盖层中引用talker。

如果你正在返回一个新的终端到你的开发,并且想要在你的覆盖层上进行开发,你可以简单地提供~/ros2_overlay_ws/install/setup.bash将自动地为所有的父工作区环境提供源。

创建自己的包


你可以创建自己的包。
等效的catkin_create_package将被移植到ament,但目前还没有。

空间支持多种构建类型。
推荐的构建类型是ament_cmake和ament_python。
也支持纯cmake包。
它将增加对更多 构建类型的支持。

ament_python构建的一个示例是 ament_tools包,其中setup.py是构建的主要入口点。

像 demo_nodes_cpp这样的包使用ament_cmake构建类型,并使用CMake作为构建工具。

提示


  •  如果你不想构建一个特定的包,那么在目录中放置一个名为“AMENT_IGNORE”的空文件,它将不会被索引。

    "Catch all"选项,例如:--cmake-args应该放在其他选项之后,或用'--'分隔:
    
ament build . --force-cmake-configure --cmake-args -DCMAKE_BUILD_TYPE=Debug -- --ament-cmake-args -DCMAKE_BUILD_TYPE=Release


  •  如果你想从包运行单个特定的测试:
ament test --only-packages YOUR_PKG_NAME --ctest-args -R YOUR_TEST_IN_PKG



这篇关于【ROS翻译】ROS2 Ament教程的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1016669

相关文章

Nexus安装和启动的实现教程

《Nexus安装和启动的实现教程》:本文主要介绍Nexus安装和启动的实现教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、Nexus下载二、Nexus安装和启动三、关闭Nexus总结一、Nexus下载官方下载链接:DownloadWindows系统根

CnPlugin是PL/SQL Developer工具插件使用教程

《CnPlugin是PL/SQLDeveloper工具插件使用教程》:本文主要介绍CnPlugin是PL/SQLDeveloper工具插件使用教程,具有很好的参考价值,希望对大家有所帮助,如有错... 目录PL/SQL Developer工具插件使用安装拷贝文件配置总结PL/SQL Developer工具插

Java中的登录技术保姆级详细教程

《Java中的登录技术保姆级详细教程》:本文主要介绍Java中登录技术保姆级详细教程的相关资料,在Java中我们可以使用各种技术和框架来实现这些功能,文中通过代码介绍的非常详细,需要的朋友可以参考... 目录1.登录思路2.登录标记1.会话技术2.会话跟踪1.Cookie技术2.Session技术3.令牌技

Python使用Code2flow将代码转化为流程图的操作教程

《Python使用Code2flow将代码转化为流程图的操作教程》Code2flow是一款开源工具,能够将代码自动转换为流程图,该工具对于代码审查、调试和理解大型代码库非常有用,在这篇博客中,我们将深... 目录引言1nVflRA、为什么选择 Code2flow?2、安装 Code2flow3、基本功能演示

Java Spring 中的监听器Listener详解与实战教程

《JavaSpring中的监听器Listener详解与实战教程》Spring提供了多种监听器机制,可以用于监听应用生命周期、会话生命周期和请求处理过程中的事件,:本文主要介绍JavaSprin... 目录一、监听器的作用1.1 应用生命周期管理1.2 会话管理1.3 请求处理监控二、创建监听器2.1 Ser

MySQL 安装配置超完整教程

《MySQL安装配置超完整教程》MySQL是一款广泛使用的开源关系型数据库管理系统(RDBMS),由瑞典MySQLAB公司开发,目前属于Oracle公司旗下产品,:本文主要介绍MySQL安装配置... 目录一、mysql 简介二、下载 MySQL三、安装 MySQL四、配置环境变量五、配置 MySQL5.1

MQTT SpringBoot整合实战教程

《MQTTSpringBoot整合实战教程》:本文主要介绍MQTTSpringBoot整合实战教程,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考... 目录MQTT-SpringBoot创建简单 SpringBoot 项目导入必须依赖增加MQTT相关配置编写

在Java中基于Geotools对PostGIS数据库的空间查询实践教程

《在Java中基于Geotools对PostGIS数据库的空间查询实践教程》本文将深入探讨这一实践,从连接配置到复杂空间查询操作,包括点查询、区域范围查询以及空间关系判断等,全方位展示如何在Java环... 目录前言一、相关技术背景介绍1、评价对象AOI2、数据处理流程二、对AOI空间范围查询实践1、空间查

Logback在SpringBoot中的详细配置教程

《Logback在SpringBoot中的详细配置教程》SpringBoot默认会加载classpath下的logback-spring.xml(推荐)或logback.xml作为Logback的配置... 目录1. Logback 配置文件2. 基础配置示例3. 关键配置项说明Appender(日志输出器

Kali Linux安装实现教程(亲测有效)

《KaliLinux安装实现教程(亲测有效)》:本文主要介绍KaliLinux安装实现教程(亲测有效),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、下载二、安装总结一、下载1、点http://www.chinasem.cn击链接 Get Kali | Kal