使用 rosdep 管理 ROS 2 依赖项

2023-11-06 01:52
文章标签 使用 依赖 管理 ros rosdep

本文主要是介绍使用 rosdep 管理 ROS 2 依赖项，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

系列文章目录

文章目录

  • 系列文章目录
  • 前言 清华源镜像使用
  • 一、什么是 `rosdep`？
  • 二、关于 `package.xml` 文件的一些小知识
  • 三、`rosdep` 是如何工作的？
  • 四、如何知道在 `package.xml` 中输入哪些 `key` ？
  • 五、如何使用 rosdep 工具？
    • 5.1 rosdep 安装
    • 5.2 rosdep 使用
  • 六、rosdep 说明
  • `如果觉得内容不错，请点赞、收藏、关注`

前言 清华源镜像使用

本教程将介绍如何使用 rosdep 管理外部依赖关系。

目前，rosdep 只能在 Linux 和 macOS 上运行，不支持 Windows。长期计划是在
https://github.com/ros-infrastructure/rosdep 中添加对 Windows 的支持。

在 rosdep 使用流程中，我们会有如下两个步骤

sudo rosdep init
rosdep update

我们替换为以下步骤

# 手动模拟 rosdep init
sudo mkdir -p /etc/ros/rosdep/sources.list.d/
sudo curl -o /etc/ros/rosdep/sources.list.d/20-default.list https://mirrors.tuna.tsinghua.edu.cn/github-raw/ros/rosdistro/master/rosdep/sources.list.d/20-default.list
# 为 rosdep update 换源
export ROSDISTRO_INDEX_URL=https://mirrors.tuna.tsinghua.edu.cn/rosdistro/index-v4.yaml
rosdep update# 每次 rosdep update 之前，均需要增加该环境变量
# 为了持久化该设定，可以将其写入 .bashrc 中，例如
echo 'export ROSDISTRO_INDEX_URL=https://mirrors.tuna.tsinghua.edu.cn/rosdistro/index-v4.yaml' >> ~/.bashrc

一、什么是 rosdep？

rosdep 是一种依赖性管理工具，可以处理软件包和外部库。rosdep 本身并不是一个软件包管理器；它是一个元软件包管理器，利用自身对系统和依赖关系的了解，在特定平台上找到合适的软件包进行安装。实际安装是通过系统软件包管理器（如 Debian/Ubuntu 上的 apt、Fedora/RHEL 上的 dnf 等）完成的。

它通常在构建工作区之前被调用，用于安装工作区中的依赖包。

它可以在单个软件包或软件包目录（如工作区）上运行。

从名字上看，rosdep 是为 ROS 设计的，但其实它与 ROS 是半对立的。你可以将它作为一个独立的 Python 软件包安装，在非
ROS 软件项目中使用这个强大的工具。成功运行 rosdep 依赖于可用的 rosdep 密钥，只需几条简单的命令就能从公共 git
仓库下载。

二、关于 package.xml 文件的一些小知识

package.xml 是软件中的一个文件，rosdep 会在其中找到一系列依赖项。package.xml 中的依赖关系列表必须完整、正确，这样所有工具才能确定软件包的依赖关系。缺少或不正确的依赖关系会导致用户无法使用软件包，工作区中的软件包被无序构建，以及软件包无法发布。

package.xml 文件中的依赖关系通常被称为 “rosdep keys”。这些依赖关系由软件包的创建者手动填充到 package.xml 文件中，并应详尽无遗地列出软件包所需的所有非构建库和软件包。

它们用以下标记表示（完整规范请参见 REP-149）：

  1. <depend>
    这些是软件包在构建和运行时都应提供的依赖项。对于 C++ 软件包，毫无疑问，请使用此标记。纯 Python 软件包通常没有联编阶段，因此不应使用此标记，而应使用 <exec_depend>。
  2. <build_depend>
    如果只在构建软件包时而不是在执行时使用特定的依赖关系，可以使用 <build_depend> 标签。
    有了这种依赖关系，软件包的已安装二进制文件就不需要安装该特定软件包了。
    不过，如果你的软件包导出的头文件包含了该依赖的头文件，那就会产生问题。在这种情况下，您还需要使用 <build_export_depend>。
  3. <build_export_depend>
    如果您导出的头文件包含依赖包中的头文件，那么其他 <build_depend> 依赖于您的软件包也会需要该头文件。这主要适用于头文件和 CMake 配置文件。由您导出的库引用的库包通常应指定 ，因为在执行时也需要它们。
  4. <exec_depend>
    该标签声明了运行软件包时所需的共享库、可执行文件、Python 模块、启动脚本和其他文件的依赖关系。
  5. <test_depend>
    此标记声明仅测试需要的依赖项。此处的依赖项不应与 <build_depend>、<exec_depend> 或 <depend> 指定的键重复。

三、rosdep 是如何工作的？

rosdep 会检查其路径中的 package.xml 文件或特定软件包，并查找其中存储的 rosdep 密钥。然后，这些密钥会与中央索引相互参照，在各种软件包管理器中找到相应的 ROS 软件包或软件库。最后，一旦找到软件包，它们就会被安装并准备就绪！

rosdep 的工作方式是在本地计算机上检索中央索引，这样它就不必在每次运行时访问网络（在 Debian/Ubuntu 上，其配置存储在 /etc/ros/rosdep/sources.list.d/20-default.list 中）。

中央索引被称为 rosdistro，可以在网上找到。我们将在下一节进一步探讨。

四、如何知道在 package.xml 中输入哪些 key ？

问得好，很高兴你这么问！

如果您想在软件包中依赖的软件包是基于 ROS 的，并且已经发布到 ROS 生态系统 1 中，例如 nav2_bt_navigator，那么您只需使用软件包的名称即可。你可以在 https://github.com/ros/rosdistro 的 <distro>/distribution.yaml （例如 humble/distribution.yaml）中找到所有已发布的 ROS 软件包的列表。

如果你想依赖一个非 ROS 软件包（通常称为 “系统依赖”），就需要找到特定库的密钥。一般来说，有两个文件值得关注：

  • rosdep/base.yaml 包含 apt 系统依赖项

  • rosdep/python.yaml 包含 Python 依赖项

要查找密钥，请在这些文件中搜索您的库并找到名称。这就是要放入 package.xml 文件的密钥。

例如，假设一个软件包依赖于 doxygen，因为它是一个注重文档质量的伟大软件（提示提示）。我们会在 rosdep/base.yaml 中搜索 doxygen，然后找到

doxygen:arch: [doxygen]debian: [doxygen]fedora: [doxygen]freebsd: [doxygen]gentoo: [app-doc/doxygen]macports: [doxygen]nixos: [doxygen]openembedded: [doxygen@meta-oe]opensuse: [doxygen]rhel: [doxygen]ubuntu: [doxygen]

这意味着我们的 rosdep 密钥是 doxygen，它可以在不同操作系统的软件包管理器中解析为不同的名称进行安装。

五、如何使用 rosdep 工具？

5.1 rosdep 安装

如果将 rosdep 与 ROS 结合使用，它将与 ROS 发行版一起打包，非常方便。这是获取 rosdep 的推荐方法，你可以用以下方法安装它：

apt-get install python3-rosdep

在 Debian 和 Ubuntu 上，还有一个类似的软件包，名为 python3-rosdep2。如果已安装了该软件包，请确保在安装
python3-rosdep 前将其删除。

如果您在 ROS 之外使用 rosdep，系统软件包可能不可用。在这种情况下，您可以直接从 https://pypi.org 安装：

pip install rosdep

5.2 rosdep 使用

既然我们已经对 rosdep、package.xml 和 rosdistro 有了一定的了解，那么我们就可以使用该工具本身了！首先，如果这是第一次使用 rosdep，必须通过以下方式对其进行初始化：

sudo rosdep init
rosdep update

这将初始化 rosdep，而 update 将更新本地缓存的 rosdistro 索引。偶尔更新一下 rosdep 以获取最新索引是个好主意。

最后，我们可以运行 rosdep install 安装依赖包。通常情况下，我们会在一个包含许多软件包的工作区中一次性调用该程序，以安装所有依赖包。如果在工作区的根目录下，src 目录包含源代码，则会出现如下调用。

rosdep install --from-paths src -y --ignore-src

rosdep install -i --from-path src --rosdistro iron -y

如下：

  • –from-paths src 指定了检查 package.xml 文件的路径，以便为其解析密钥。

  • -y表示对软件包管理器的所有提示默认为 “是”，安装时无需提示

  • –ignore-src "表示如果软件包本身也在工作区中，即使存在 rosdep 密钥，也会忽略安装依赖包。

还有其他参数和选项可用。使用 rosdep -h 查看这些参数和选项，或访问 http://docs.ros.org/en/independent/api/rosdep/html/ 查看更完整的 rosdep 文档。

六、rosdep 说明

Usage: rosdep [options] <command> <args>Commands:rosdep check <stacks-and-packages>...check if the dependencies of package(s) have been met.rosdep install <stacks-and-packages>...download and install the dependencies of a given package or packages.rosdep dbgenerate the dependency database and print it to the console.rosdep initinitialize rosdep sources in /etc/ros/rosdep.  May require sudo.rosdep keys <stacks-and-packages>...list the rosdep keys that the packages depend on.rosdep resolve <rosdeps>resolve <rosdeps> to system dependenciesrosdep updateupdate the local rosdep database based on the rosdep sources.rosdep what-needs <rosdeps>...print a list of packages that declare a rosdep on (at leastone of) <rosdeps>rosdep where-defined <rosdeps>...print a list of yaml files that declare a rosdep on (at leastone of) <rosdeps>rosdep fix-permissionsRecursively change the permissions of the user's ros home directory.May require sudo.  Can be useful to fix permissions after calling"rosdep update" with sudo accidentally.Options:-h, --help            show this help message and exit--os=OS_NAME:OS_VERSIONOverride OS name and version (colon-separated), e.g.ubuntu:lucid-c SOURCES_CACHE_DIR, --sources-cache-dir=SOURCES_CACHE_DIROverride /home/kuanli/.ros/rosdep/sources.cache-v, --verbose         verbose display--version             print just the rosdep version, then exit--all-versions        print rosdep version and version of installers, thenexit--reinstall           (re)install all dependencies, even if alreadyinstalled-y, --default-yes     Tell the package manager to default to y or fail wheninstalling-s, --simulate        Simulate install-r                    Continue installing despite errors.-q                    Quiet. Suppress output except for errors.-a, --all             select all packages-n                    Do not consider implicit/recursive dependencies.  Onlyvalid with 'keys', 'check', and 'install' commands.-i, --ignore-packages-from-source, --ignore-srcAffects the 'check', 'install', and 'keys' verbs. Ifspecified then rosdep will ignore keys that are foundto be catkin or ament packages anywhere in theROS_PACKAGE_PATH, AMENT_PREFIX_PATH or in any of thedirectories given by the --from-paths option.--skip-keys=SKIP_KEYSAffects the 'check' and 'install' verbs. The specifiedrosdep keys will be ignored, i.e. not resolved and notinstalled. The option can be supplied multiple times.A space separated list of rosdep keys can also bepassed as a string. A more permanent solution tolocally ignore a rosdep key is creating a local rosdeprule with an empty list of packages (include it in/etc/ros/rosdep/sources.list.d/ before the defaults).--filter-for-installers=FILTER_FOR_INSTALLERSAffects the 'db' verb. If supplied, the output of the'db' command is filtered to only list packages whoseinstaller is in the provided list. The option can besupplied multiple times. A space separated list ofinstallers can also be passed as a string. Example:`--filter-for-installers "apt pip"`--from-paths          Affects the 'check', 'keys', and 'install' verbs. Ifspecified the arguments to those verbs will beconsidered paths to be searched, acting on all catkinpackages found there in.--rosdistro=ROS_DISTROExplicitly sets the ROS distro to use, overriding thenormal method of detecting the ROS distro using theROS_DISTRO environment variable. When used with the'update' verb, only the specified distro will beupdated.--as-root=INSTALLER_KEY:<bool>Override whether sudo is used for a specificinstaller, e.g. '--as-root pip:false' or '--as-root"pip:no homebrew:yes"'. Can be specified multipletimes.--include-eol-distrosAffects the 'update' verb. If specified end-of-lifedistros are being fetched too.-t DEPENDENCY_TYPES, --dependency-types=DEPENDENCY_TYPESDependency types to install, can be given multipletimes. Choose from {'exec', 'buildtool','buildtool_export', 'test', 'build_export', 'doc','build'}. Default: all except doc.

如果觉得内容不错，请点赞、收藏、关注

这篇关于使用 rosdep 管理 ROS 2 依赖项的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/353811。

相关文章

解决Maven项目idea找不到本地仓库jar包问题以及使用mvn install:install-file

解决Maven项目idea找不到本地仓库jar包问题以及使用mvn install:install-file

《解决Maven项目idea找不到本地仓库jar包问题以及使用mvninstall:install-file》：本文主要介绍解决Maven项目idea找不到本地仓库jar包问题以及使用mvnin... 目录Maven项目idea找不到本地仓库jar包以及使用mvn install:install-file基
阅读更多...
Python使用getopt处理命令行参数示例解析(最佳实践)

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数？getopt模块基础实际应用示例与其他参数处理方式的比较常见问http
阅读更多...
C 语言中enum枚举的定义和使用小结

C 语言中enum枚举的定义和使用小结

《C语言中enum枚举的定义和使用小结》在C语言里,enum（枚举）是一种用户自定义的数据类型,它能够让你创建一组具名的整数常量,下面我会从定义、使用、特性等方面详细介绍enum,感兴趣的朋友一起看... 目录1、引言2、基本定义3、定义枚举变量4、自定义枚举常量的值5、枚举与switch语句结合使用6、枚
阅读更多...
使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取
阅读更多...
Maven如何手动安装依赖到本地仓库

Maven如何手动安装依赖到本地仓库

《Maven如何手动安装依赖到本地仓库》：本文主要介绍Maven如何手动安装依赖到本地仓库问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、下载依赖二、安装 JAR 文件到本地仓库三、验证安装四、在项目中使用该依赖1、注意事项2、额外提示总结一、下载依赖登
阅读更多...
使用Python实现图像LBP特征提取的操作方法

使用Python实现图像LBP特征提取的操作方法

《使用Python实现图像LBP特征提取的操作方法》LBP特征叫做局部二值模式,常用于纹理特征提取,并在纹理分类中具有较强的区分能力,本文给大家介绍了如何使用Python实现图像LBP特征提取的操作方... 目录一、LBP特征介绍二、LBP特征描述三、一些改进版本的LBP1.圆形LBP算子2.旋转不变的LB
阅读更多...
Maven的使用和配置国内源的保姆级教程

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

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

Python中__init__方法使用的深度解析

《Python中__init__方法使用的深度解析》在Python的面向对象编程（OOP）体系中,__init__方法如同建造房屋时的奠基仪式——它定义了对象诞生时的初始状态,下面我们就来深入了解下_... 目录一、__init__的基因图谱二、初始化过程的魔法时刻继承链中的初始化顺序self参数的奥秘默认
阅读更多...
SpringBoot使用GZIP压缩反回数据问题

SpringBoot使用GZIP压缩反回数据问题

《SpringBoot使用GZIP压缩反回数据问题》：本文主要介绍SpringBoot使用GZIP压缩反回数据问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录SpringBoot使用GZIP压缩反回数据1、初识gzip2、gzip是什么，可以干什么？3、Spr
阅读更多...
HTML5中的Microdata与历史记录管理详解

HTML5中的Microdata与历史记录管理详解

《HTML5中的Microdata与历史记录管理详解》Microdata作为HTML5新增的一个特性，它允许开发者在HTML文档中添加更多的语义信息，以便于搜索引擎和浏览器更好地理解页面内容，本文将探... 目录html5中的Mijscrodata与历史记录管理背景简介html5中的Microdata使用M
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2