【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

相关文章

springboot使用Scheduling实现动态增删启停定时任务教程

《springboot使用Scheduling实现动态增删启停定时任务教程》:本文主要介绍springboot使用Scheduling实现动态增删启停定时任务教程,具有很好的参考价值,希望对大家有... 目录1、配置定时任务需要的线程池2、创建ScheduledFuture的包装类3、注册定时任务,增加、删

如何为Yarn配置国内源的详细教程

《如何为Yarn配置国内源的详细教程》在使用Yarn进行项目开发时,由于网络原因,直接使用官方源可能会导致下载速度慢或连接失败,配置国内源可以显著提高包的下载速度和稳定性,本文将详细介绍如何为Yarn... 目录一、查询当前使用的镜像源二、设置国内源1. 设置为淘宝镜像源2. 设置为其他国内源三、还原为官方

Maven的使用和配置国内源的保姆级教程

《Maven的使用和配置国内源的保姆级教程》Maven是⼀个项目管理工具,基于POM(ProjectObjectModel,项目对象模型)的概念,Maven可以通过一小段描述信息来管理项目的构建,报告... 目录1. 什么是Maven?2.创建⼀个Maven项目3.Maven 核心功能4.使用Maven H

IDEA自动生成注释模板的配置教程

《IDEA自动生成注释模板的配置教程》本文介绍了如何在IntelliJIDEA中配置类和方法的注释模板,包括自动生成项目名称、包名、日期和时间等内容,以及如何定制参数和返回值的注释格式,需要的朋友可以... 目录项目场景配置方法类注释模板定义类开头的注释步骤类注释效果方法注释模板定义方法开头的注释步骤方法注

Python虚拟环境终极(含PyCharm的使用教程)

《Python虚拟环境终极(含PyCharm的使用教程)》:本文主要介绍Python虚拟环境终极(含PyCharm的使用教程),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录一、为什么需要虚拟环境?二、虚拟环境创建方式对比三、命令行创建虚拟环境(venv)3.1 基础命令3

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

python连接本地SQL server详细图文教程

《python连接本地SQLserver详细图文教程》在数据分析领域,经常需要从数据库中获取数据进行分析和处理,下面:本文主要介绍python连接本地SQLserver的相关资料,文中通过代码... 目录一.设置本地账号1.新建用户2.开启双重验证3,开启TCP/IP本地服务二js.python连接实例1.

Python 安装和配置flask, flask_cors的图文教程

《Python安装和配置flask,flask_cors的图文教程》:本文主要介绍Python安装和配置flask,flask_cors的图文教程,本文通过图文并茂的形式给大家介绍的非常详细,... 目录一.python安装:二,配置环境变量,三:检查Python安装和环境变量,四:安装flask和flas

Spring Security基于数据库的ABAC属性权限模型实战开发教程

《SpringSecurity基于数据库的ABAC属性权限模型实战开发教程》:本文主要介绍SpringSecurity基于数据库的ABAC属性权限模型实战开发教程,本文给大家介绍的非常详细,对大... 目录1. 前言2. 权限决策依据RBACABAC综合对比3. 数据库表结构说明4. 实战开始5. MyBA

Ubuntu中远程连接Mysql数据库的详细图文教程

《Ubuntu中远程连接Mysql数据库的详细图文教程》Ubuntu是一个以桌面应用为主的Linux发行版操作系统,这篇文章主要为大家详细介绍了Ubuntu中远程连接Mysql数据库的详细图文教程,有... 目录1、版本2、检查有没有mysql2.1 查询是否安装了Mysql包2.2 查看Mysql版本2.