【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

相关文章

Python中Tkinter GUI编程详细教程

《Python中TkinterGUI编程详细教程》Tkinter作为Python编程语言中构建GUI的一个重要组件,其教程对于任何希望将Python应用到实际编程中的开发者来说都是宝贵的资源,这篇文... 目录前言1. Tkinter 简介2. 第一个 Tkinter 程序3. 窗口和基础组件3.1 创建窗

Python中Request的安装以及简单的使用方法图文教程

《Python中Request的安装以及简单的使用方法图文教程》python里的request库经常被用于进行网络爬虫,想要学习网络爬虫的同学必须得安装request这个第三方库,:本文主要介绍P... 目录1.Requests 安装cmd 窗口安装为pycharm安装在pycharm设置中为项目安装req

JavaWeb项目创建、部署、连接数据库保姆级教程(tomcat)

《JavaWeb项目创建、部署、连接数据库保姆级教程(tomcat)》:本文主要介绍如何在IntelliJIDEA2020.1中创建和部署一个JavaWeb项目,包括创建项目、配置Tomcat服务... 目录简介:一、创建项目二、tomcat部署1、将tomcat解压在一个自己找得到路径2、在idea中添加

Python + Streamlit项目部署方案超详细教程(非Docker版)

《Python+Streamlit项目部署方案超详细教程(非Docker版)》Streamlit是一款强大的Python框架,专为机器学习及数据可视化打造,:本文主要介绍Python+St... 目录一、针对 Alibaba Cloud linux/Centos 系统的完整部署方案1. 服务器基础配置(阿里

Spring IOC核心原理详解与运用实战教程

《SpringIOC核心原理详解与运用实战教程》本文详细解析了SpringIOC容器的核心原理,包括BeanFactory体系、依赖注入机制、循环依赖解决和三级缓存机制,同时,介绍了SpringBo... 目录1. Spring IOC核心原理深度解析1.1 BeanFactory体系与内部结构1.1.1

SpringBoot集成iText快速生成PDF教程

《SpringBoot集成iText快速生成PDF教程》本文介绍了如何在SpringBoot项目中集成iText9.4.0生成PDF文档,包括新特性的介绍、环境准备、Service层实现、Contro... 目录SpringBoot集成iText 9.4.0生成PDF一、iText 9新特性与架构变革二、环

2025最新版Android Studio安装及组件配置教程(SDK、JDK、Gradle)

《2025最新版AndroidStudio安装及组件配置教程(SDK、JDK、Gradle)》:本文主要介绍2025最新版AndroidStudio安装及组件配置(SDK、JDK、Gradle... 目录原生 android 简介Android Studio必备组件一、Android Studio安装二、A

前端Visual Studio Code安装配置教程之下载、汉化、常用组件及基本操作

《前端VisualStudioCode安装配置教程之下载、汉化、常用组件及基本操作》VisualStudioCode是微软推出的一个强大的代码编辑器,功能强大,操作简单便捷,还有着良好的用户界面,... 目录一、Visual Studio Code下载二、汉化三、常用组件1、Auto Rename Tag2

JavaScript装饰器从基础到实战教程

《JavaScript装饰器从基础到实战教程》装饰器是js中一种声明式语法特性,用于在不修改原始代码的情况下,动态扩展类、方法、属性或参数的行为,本文将从基础概念入手,逐步讲解装饰器的类型、用法、进阶... 目录一、装饰器基础概念1.1 什么是装饰器?1.2 装饰器的语法1.3 装饰器的执行时机二、装饰器的

MySQL 5.7彻底卸载与重新安装保姆级教程(附常见问题解决)

《MySQL5.7彻底卸载与重新安装保姆级教程(附常见问题解决)》:本文主要介绍MySQL5.7彻底卸载与重新安装保姆级教程的相关资料,步骤包括停止服务、卸载程序、删除文件和注册表项、清理环境... 目录一、彻底卸载旧版本mysql(核心步骤)二、MySQL 5.7重新安装与配置三、常见问题解决总结废话不多