【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

相关文章

Ubuntu固定虚拟机ip地址的方法教程

《Ubuntu固定虚拟机ip地址的方法教程》本文详细介绍了如何在Ubuntu虚拟机中固定IP地址,包括检查和编辑`/etc/apt/sources.list`文件、更新网络配置文件以及使用Networ... 1、由于虚拟机网络是桥接,所以ip地址会不停地变化,接下来我们就讲述ip如何固定 2、如果apt安

PyCharm 接入 DeepSeek最新完整教程

《PyCharm接入DeepSeek最新完整教程》文章介绍了DeepSeek-V3模型的性能提升以及如何在PyCharm中接入和使用DeepSeek进行代码开发,本文通过图文并茂的形式给大家介绍的... 目录DeepSeek-V3效果演示创建API Key在PyCharm中下载Continue插件配置Con

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll

在不同系统间迁移Python程序的方法与教程

《在不同系统间迁移Python程序的方法与教程》本文介绍了几种将Windows上编写的Python程序迁移到Linux服务器上的方法,包括使用虚拟环境和依赖冻结、容器化技术(如Docker)、使用An... 目录使用虚拟环境和依赖冻结1. 创建虚拟环境2. 冻结依赖使用容器化技术(如 docker)1. 创

Spring Boot整合log4j2日志配置的详细教程

《SpringBoot整合log4j2日志配置的详细教程》:本文主要介绍SpringBoot项目中整合Log4j2日志框架的步骤和配置,包括常用日志框架的比较、配置参数介绍、Log4j2配置详解... 目录前言一、常用日志框架二、配置参数介绍1. 日志级别2. 输出形式3. 日志格式3.1 PatternL

MySQL8.2.0安装教程分享

《MySQL8.2.0安装教程分享》这篇文章详细介绍了如何在Windows系统上安装MySQL数据库软件,包括下载、安装、配置和设置环境变量的步骤... 目录mysql的安装图文1.python访问网址2javascript.点击3.进入Downloads向下滑动4.选择Community Server5.

CentOS系统Maven安装教程分享

《CentOS系统Maven安装教程分享》本文介绍了如何在CentOS系统中安装Maven,并提供了一个简单的实际应用案例,安装Maven需要先安装Java和设置环境变量,Maven可以自动管理项目的... 目录准备工作下载并安装Maven常见问题及解决方法实际应用案例总结Maven是一个流行的项目管理工具

本地私有化部署DeepSeek模型的详细教程

《本地私有化部署DeepSeek模型的详细教程》DeepSeek模型是一种强大的语言模型,本地私有化部署可以让用户在自己的环境中安全、高效地使用该模型,避免数据传输到外部带来的安全风险,同时也能根据自... 目录一、引言二、环境准备(一)硬件要求(二)软件要求(三)创建虚拟环境三、安装依赖库四、获取 Dee

MySql9.1.0安装详细教程(最新推荐)

《MySql9.1.0安装详细教程(最新推荐)》MySQL是一个流行的关系型数据库管理系统,支持多线程和多种数据库连接途径,能够处理上千万条记录的大型数据库,本文介绍MySql9.1.0安装详细教程,... 目录mysql介绍:一、下载 Mysql 安装文件二、Mysql 安装教程三、环境配置1.右击此电脑

在idea中使用mysql数据库超详细教程

《在idea中使用mysql数据库超详细教程》:本文主要介绍如何在IntelliJIDEA中连接MySQL数据库,并使用控制台执行SQL语句,还详细讲解了如何使用MyBatisGenerator快... 目录一、连接mysql二、使用mysql三、快速生成实体、接口、sql文件总结一、连接mysql在ID