您正在阅读的是旧版本但仍受支持的 ROS 2 文档。 Jazzy.

发布轨道

什么是轨道？

Bloom 要求用户在首次发布软件包时输入配置信息。将这些配置信息存储在发布库中是有好处的，这样我们就不必手动输入那些在后续发布中不会改变的配置信息。

由于在为不同的 ROS 发行版发布软件包时，某些配置会有所不同，因此 bloom 会使用 释放轨道，以存储用于释放的配置 每个发行版。按照惯例，你应该创建与你要发布的 ROS 发行版同名的轨道。

所有释放轨道配置都存储在 tracks.yaml 的主分支上。

轨道配置

更详细的轨道配置说明以及 Bloom 的提示。

版本库网址

这是版本库的 URL，格式应为 https://github.com/ros2-gbp/my_repo-release.git 如果您的版本库托管在 ros2-gbp。

没有 合理的 默认 释放 知识库 网址 可以 是 决心 从 以前 发布。发布 知识库 网址 [压机 走进 至 中止]:

粘贴发布源 URL 并按 Enter。

此外，Bloom 可能还会询问你有关初始化新版本库的问题，如下所示：

新鲜 初始化 笨蛋 知识库 被发现一个 最初 空的 承诺 是 要去的地方 至 是 做了。继续 [是/否]?

只需按 Enter 键接受默认的 "是"。

存储库名称

版本库名称并不重要，但建议将其设置为项目名称。

存储库 名称：
   上游部门
      默认值 价值、 离开 此 作为 上游部门 如果 你 是 不确定
   <名称>；
      名称 的 的 知识库 (中古 于 的 档案馆 名字)
   ['上游'；]:

键入项目名称（例如 我的项目) 并按回车键。

上游存储库 URI

"(《世界人权宣言》) 上游存储库 是您的源代码所在的版本库。这很可能是一个 https 链接，指向您托管在 GitHub 或 GitLab 等 git 托管服务上的项目。

上游 存储库 URI：
   <uri>；
      任何 有效 URI. 这 变量 会 是 模板化、 对于 范例 一个 svn 网址
      会 是 模板化 作为 这样： "https://svn.foo.com/foo/tags/foo-:{版本}"；
      其中 的 :{版本} 象征性 将 是 取代 与 的 版本 对于 此 释放。
   [无]:

确保您 使用 https 地址 例如 https://github.com/my_organization/my_repo.git) 而不是 ssh 地址。

上游 VCS 类型

这是 上游存储库 URI的版本控制系统 (VCS) 类型。您必须指定版本库使用的 VCS 类型，从 svn, 笨蛋, hg 或 卷烟.

上游 VCS 类型
   svn
      上游 通用资源识别号 是 a svn 知识库
   笨蛋
      上游 通用资源识别号 是 a 笨蛋 知识库
   hg
      上游 通用资源识别号 是 a hg 知识库
   卷烟
      上游 通用资源识别号 是 a 压缩包
   ['git'；]:

大多数软件源将使用 git，但一些传统软件源可能使用 hg 或 svn。

版本

这是您要发布的软件包的版本。例如 1.0.3)

版本：
   :{问}
      这 办法 那 的 用户 将 是 提示 对于 的 版本 每种 释放。
      这 还 办法 那 的 上游部门 发展 将 是 忽略不计。
   :{汽车}
      这 办法 的 版本 将 是 猜到了 从 的 发展 分支。
      这 办法 那 的 发展 分支机构 必须 是 设置、 的 发展 分支机构 必须 存在、
      和 那儿 必须 是 a 有效 package.xml 于 的 上游部门 发展 分支。
   版本>；
      这 将 是 的 版本 用过
      它 必须 是 最新的 对于 每种 新 上游部门 版本。
   ['；：{自动}'；]:

将其设置为 :{ 自动｝ (默认设置，也是推荐设置）将自动从开发分支的 package.xml 中确定版本。

将其设置为 ：{问｝ 每次运行 bloom 发布版本时，都会弹出提示询问版本。

发布标签

版本标签指的是要从哪个标签或分支导入代码。

发布 标签
   :{版本}
      这 办法 那 的 释放 标签 将 比赛 的 :{版本} 标签
      这 会 是 进一步 模板化、 对于 例如 "foo-:{version}"； 或 "v:{版本}"；

      这 会 描绘 任何 vcs 参考文献 对于 笨蛋 那 办法 {标签 分支、 散列},
      对于 hg 那 办法 {标签 分支、 散列}, 对于 svn 那 办法 a 修订 号
      对于 卷烟 此 价值 双倍 作为 的 字幕 通讯录 (如果 的 知识库 是
      于 foo/ 的 的 卷烟 球、 提出问题 动物 这里 将 原因 的 内容 的
      foo/ 至 是 进口 至 上游部门 而是 的 动物 它本身).
   :{问}
      这 办法 的 用户 将 是 提示 对于 的 释放 标签 关于 每种 释放。
   :{无}
      对于 svn 和 卷烟 只是 你 会 设置 的 释放 标签 至 :{无}, 那么 那
      它 是 忽略不计。  对于 svn 此 办法 没有 修订 编号 是 用过
   [':{version}'；]:

将其设置为 版本 (默认设置，也是推荐设置）将使版本标签与版本标签相匹配。

一种不太常见的设置是将其设置为分支名称，以便在从上游项目发布时始终拉入该分支。

或者，如果您希望每次发布时都被提示输入不同的标记，请输入 ：{问｝. ：{问｝ 是非常有用的，如果上游项目有频繁的标签发布，而你希望每次发布时都引用新标签的话。

上游开发分支

上游开发分支的名称是你的 上游存储库.如果每个 ROS 发行版都使用不同的分支，则每个发行轨道的该字段都会不同。它用于确定您要发布的软件包的版本。 版本 设置为 :{ 自动｝.

上游 发展 分支机构：
   vcs 参考资料>；
      分支机构 于 上游部门 知识库 关于 其中 至 搜索 对于 的 版本。
      这 是 中古 只是 当 版本 是 设置 至 '；：{自动}'；.
   [无]:

要从名为 简陋输入 简陋.将此作为 无 会导致版本由版本库的默认分支决定（不建议这样做）。

ROS 发行版

这是您计划发布软件包的发行版。

ROS 发行版：
   ROS distro>；
      这 会 是 任何 有效 ROS distro、 例如 靛蓝 动能、 月球、 轻柔
   ['靛蓝'；]:

如果您计划发布到 ROS humble，请输入 简陋.

补丁目录

这是对发布版本进行附加补丁的目录。

补丁 目录
   <path 于 盛开 分支机构
      这 会 是 任何 有效 相对的 路 于 的 盛开 分支。 "(《世界人权宣言》) 内容
      的 此 小册子 将 是 叠加 关于 的 上游部门 分支机构 后 每种
      上游导入。  此外、 任何 package.xml 文件 发现 于 的
      覆盖物 将 有 的 :{版本} 字符串 取代 与 的 当前
      版本 作为 已发布。
   :{无}
      使用 此 如果 你 想 至 关闭 叠加 的 文件
   [无]:

在发行版中添加附加补丁是一项很少使用的功能。几乎所有软件包都应将此作为默认设置 无.

版本库推送 URL

发布 存储库 推动 URL：
   :{无}
      这 表明 那 的 默认 释放 网址 应 是 用过
   <url>；
      (可选的) 二手 当 推动 至 远程 释放 库。 这 是 只是
      用得上 当 的 释放 uri 其中 是 于 的 rosdistro 文件 是 不 可写。
      这 是 有用 对于 例如 当 a 释放者 就会 喜欢 至 使用 a ssh 网址
      至 推动 颇为 于 a https:// url.
   [无]:

在大多数情况下，可保留为默认值。