Skip to content

Hydro :: First Time Release

stonier edited this page Sep 14, 2014 · 1 revision

Detailed Guide

Preparations

sudo apt-get install python-bloom python-rosdep python-rospkg

PreRelease Preparation

You need to do a bit of preparation to sign your source repository up for doing pre-releases.

Make sure you add the branch name ('version' key) that you're working from. This will usually be hydro or hydro-devel.

  • Do the pre-release.
  • Use the 'devel' option, not 'latest'

Fix any bugs that show up and pre-release till you get it right. You might also like to do a catkin_make_isolated build locally as that sometimes highlights errors that hide when compiling every package collectively.

Stack Preparation

$ catkin_generate_changelog
# Do some cleanup, then get it ready with the next tagged number
$ catkin_tag_changelog
# Commit and push your changes
$ catkin_prepare_release --bump=patch

Bloom Config Repo

Example below is for rocon_multimaster:

$ git clone https://github.com/yujinrobot-release/rocon_multimaster-release
$ cd rocon_multimaster-release
$ git-bloom-config new hydro

The configuration process will ask you a few questions, make sure you:

  • Set Repository Name to your repo name (e.g. rocon_multimaster)
  • Set Upstream repository URI to your code repo (e.g. https://github.com/robotics-in-concert/rocon_multimaster.git)
  • Set Upstream Devel Branch to the branch you are releasing from (e.g. hydro-devel or hydro)
  • Set ROS Distro to hydro.
  • Set Release Repository Push URI to https://github.com/yujinrobot-release/rocon_multimaster-release.git.
$ git push --all; git push --tags

Bloom Release

$ git clone https://github.com/robotics-in-concert rocon_multimaster
$ bloom-release --track hydro --rosdistro hydro rocon_multimaster

The first time you do this it will have no release information in rosdistro, so it will ask you for the release repo, i.e. here ``https://github.com/yujinrobot-release/rocon_multimaster-release.git`.

When it finishes the bloom process it will send a pull request to rosdistro with updated information.

Clone this wiki locally