【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

相关文章

ROS话题通信流程自定义数据格式

ROS话题通信流程自定义数据格式 需求流程实现步骤定义msg文件编辑配置文件编译 在 ROS 通信协议中,数据载体是一个较为重要组成部分,ROS 中通过 std_msgs 封装了一些原生的数据类型,比如:String、Int32、Int64、Char、Bool、Empty… 但是,这些数据一般只包含一个 data 字段,结构的单一意味着功能上的局限性,当传输一些复杂的数据,比如:

Steam邮件推送内容有哪些?配置教程详解!

Steam邮件推送功能是否安全?如何个性化邮件推送内容? Steam作为全球最大的数字游戏分发平台之一,不仅提供了海量的游戏资源,还通过邮件推送为用户提供最新的游戏信息、促销活动和个性化推荐。AokSend将详细介绍Steam邮件推送的主要内容。 Steam邮件推送:促销优惠 每当平台举办大型促销活动,如夏季促销、冬季促销、黑色星期五等,用户都会收到邮件通知。这些邮件详细列出了打折游戏、

X-AnyLabeling使用教程

1.AI 模型自动分割标注使用教程 2.AI 模型自动目标检测标注使用教程

青龙面板2.9之Cdle傻妞机器人编译教程

看到有的朋友对傻妞机器人感兴趣,这里写一下傻妞机器人的编译教程。 第一步,这里以linux amd64为例,去官网下载安装go语言安装包: 第二步,输入下方指令 cd /usr/local && wget https://golang.google.cn/dl/go1.16.7.linux-amd64.tar.gz -O go1.16.7.linux-amd64.tar.gz

青龙面板部署通用教程,含服务器、路由器、X86等部署方法

1. 拉取镜像/更新镜像 docker pull whyour/qinglong:latest 2. 删除镜像 docker rmi whyour/qinglong:latest 3. 启动容器 普通服务器 docker run -dit \-v $PWD/ql/config:/ql/config \-v $PWD/ql/log:/ql/log \-v $PWD/ql/db:

宝塔面板部署青龙面板教程【简单易上手】

首先,你得有一台部署了宝塔面板的服务器(自己用本地电脑也可以)。 宝塔面板部署自行百度一下,很简单,这里就不走流程了,官网版本就可以,无需开心版。 首先,打开宝塔面板的软件商店,找到下图这个软件(Docker管理器)安装,青龙面板还是安装在docker里,这里依赖宝塔面板安装和管理docker。 安装完成后,进入SSH终端管理,输入代码安装青龙面板。ssh可以直接宝塔里操作,也可以安装ssh连接

PS系统教程25

介绍软件 BR(bridge) PS 配套软件,方便素材整理、管理素材 作用:起到桥梁作用 注意:PS和BR尽量保持版本一致 下载和安装可通过CSDN社区搜索,有免费安装指导。 安装之后,我们打开照片只需双击照片,就自动在Ps软件中打开。 前提:电脑上有PS软件 三种预览格式 全屏预览 评星级 直接按数字键就可以 方向键可以更换图片 esc退出 幻灯片放

flex布局学习笔记(flex布局教程)

前端笔试⾯试经常会问到:不定宽⾼如何⽔平垂直居中。最简单的实现⽅法就是flex布局,⽗元素加上如下代码即 可: display: flex; justify-content: center; align-items :center; 。下⾯详细介绍下flex布局吧。   2009年,W3C提出了 Flex布局,可以简便⼂完整⼂响应式地实现各种页⾯布局。⽬前已得到了所有浏览器的⽀持,这意味着,现

IPython小白教程:提升你的Python交互式编程技巧,通俗易懂!

IPython是一个增强的Python交互式shell,它提供了丰富的功能和便捷的交互方式,使得Python开发和数据分析工作更加高效。本文将详细介绍IPython的基本概念、使用方法、主要作用以及注意事项。 一、IPython简介 1. IPython的起源 IPython由Fernando Pérez于2001年创建,旨在提供一个更高效的Python交互式编程环境。 2. IPyt

ROS2从入门到精通4-4:局部控制插件开发案例(以PID算法为例)

目录 0 专栏介绍1 控制插件编写模板1.1 构造控制插件类1.2 注册并导出插件1.3 编译与使用插件 2 基于PID的路径跟踪原理3 控制插件开发案例(PID算法)常见问题 0 专栏介绍 本专栏旨在通过对ROS2的系统学习,掌握ROS2底层基本分布式原理,并具有机器人建模和应用ROS2进行实际项目的开发和调试的工程能力。 🚀详情:《ROS2从入门到精通》 1 控制插