警告

您正在阅读的 ROS 2 文档版本已达到 EOL(生命周期结束),不再受官方支持。如果您想了解最新信息,请访问 Jazzy.

发布团队/存储库

本页介绍了将发布源托管在 ros2-gbp.

什么是 ROS 2 GBP?

ros2-gbp 是一个托管 ROS 软件包发布库的 GitHub 组织。它还维护着发布团队的列表、每个发布团队的成员列表以及由发布团队维护的发布仓库列表。 https://github.com/ros2-gbp/ros2-gbp-github-org.与 ros2-gbp-github-org 的交互是通过提出 GitHub 问题来完成的。建议您尽早申请加入发布团队并建立发布仓库,因为 ros2-gbp 维护者可能需要一些时间来回复您的请求。

什么是发布团队?

发布团队是一个 GitHub 团队 发布团队是由一组负责一个或多个版本库发布流程的人员组成。发布团队通常由一个组织、一个工作组甚至个人组成,并以其所代表的团队或小组命名。发布团队及其相关发布库的列表维护在 ros2-gbp-github-org.

您必须是计划发布项目的发布团队成员。 如果您打算在现有团队下发布版本库,请按照以下步骤操作 加入发布团队.如果您打算组建一个新团队,请遵循以下步骤 启动新的发布团队.

加入发布团队

填写 更新发布小组成员问题 问题模板,如果您的项目已存在发布团队,但您不是其中一员。

启动新的发布团队

填写 新发布团队问题 如果您的项目还没有发布团队,请申请创建一个新的发布团队。

什么是版本库?

版本库是指具有以下功能的资源库

  • 存储发布过程中生成的文件,供 ROS 构建库使用

  • 缓存发布过程中的配置,以简化未来版本库的后续发布工作

要在 ROS 2 中发布一个版本,必须拥有一个独立于源代码库的版本库。

创建新的版本库

如果您的软件源是 ROS 社区的新成员,您应该首先在 ROS/ROSDISTRO 增加一个 消息来源 您的版本库的条目。rosdistro 数据库的审查过程将确保您的版本库和软件包符合 REP 144 软件包命名规则 和其他要求。软件包名称获得批准并合并后,请填写 添加新版本库问题 问题模板。

如果我现有的发布软件仓库不在 ros2-gbp 上怎么办?

在 ros2-gbp 出现之前发布的软件包,其发布源可能托管在其他地方。现在,我们强烈建议将发布源放在这个专门的 GitHub 组织中。如果你正在将 ROS 1 软件包移植到 ROS 2,并计划首次将软件包发布到 ROS 2,请按照标准流程为你的 ROS 2 版本申请一个新的发布源。如果你之前已经为 ROS 2 发布了软件包,那么在提出 添加新版本库问题, 指定当前版本库的网址其余的按照标准程序进行。

备注

如果你不打算将发布库发布到 Rolling 中,那么稳定发行版仍然支持托管在其他地方的发布库。由于从 Rolling 创建的稳定版将从 ros2-gbp 组织中的发行版仓库开始,因此建议所有 ROS 2 发行版都使用 ros2-gbp 发行版仓库,以避免发行版信息碎片化。

未来,ros2-gbp 版本库可能会成为一个硬性要求,为所有 ROS 2 发行版维护一个单一的版本库可以简化滚动发行版维护者和软件包维护者的版本维护工作。