Skip to content

Commit d9e0c59

Browse files
authored
Ionic Ubuntu source install: rosdep instructions (#568)
Add instructions for installing dependencies using rosdep. Signed-off-by: Steve Peters <[email protected]>
1 parent 88eec33 commit d9e0c59

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

ionic/install_ubuntu_src.md

+32
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,38 @@ sudo apt -y install \
103103
$(sort -u $(find . -iname 'packages-'`lsb_release -cs`'.apt' -o -iname 'packages.apt' | grep -v '/\.git/') | sed '/gz\|sdf/d' | tr '\n' ' ')
104104
```
105105

106+
Alternatively, if you want to install dependencies using
107+
[rosdep](https://docs.ros.org/en/rolling/Tutorials/Intermediate/Rosdep.html),
108+
ensure that [rosdep is installed](https://docs.ros.org/en/rolling/Tutorials/Intermediate/Rosdep.html#how-do-i-use-the-rosdep-tool)
109+
and use the following command:
110+
111+
```bash
112+
cd ~/workspace/src
113+
rosdep install -i --from-path . -y \
114+
--skip-keys "gz-cmake3 DART libogre-dev libogre-next-2.3-dev"
115+
```
116+
117+
The `rosdep` command attempts to install dependencies listed in `package.xml`
118+
files, but when problems arise the `--skip-keys` argument is used. Explanations
119+
for its use in the previous line are given below:
120+
121+
* `gz-cmake3`: `gz-tools2` can build from source against
122+
[both `gz-cmake3` and `gz-cmake4`](https://github.com/gazebosim/gz-tools/pull/128),
123+
and this workspace only contains `gz-cmake4`. The `gz-tools2` `package.xml`
124+
file only [depends on gz-cmake3](https://github.com/gazebosim/gz-tools/blob/2b228e5b956/package.xml#L13)
125+
and since that package is not present, use `--skip-keys gz-cmake3`.
126+
* `DART`: `gz-physics8` can build against [dartsim](http://dartsim.github.io),
127+
which is listed as DART in the [gz-physics package.xml file](https://github.com/gazebosim/gz-physics/blob/gz-physics8_8.0.0/package.xml#L16).
128+
This package is not in the workspace, so `DART` is added to the `--skip-keys`
129+
string.
130+
See the discussion in [gz-physics#608](https://github.com/gazebosim/gz-physics/pull/608#discussion_r1589512231)
131+
for more background on the package name used for `DART`.
132+
* `libogre-dev` and `libogre-next-2.3-dev`: `gz-rendering9` can build against
133+
ogre 1.9 and ogre-next 2.3. The debian package names are listed as
134+
dependencies in the [gz-rendering package.xml](https://github.com/gazebosim/gz-rendering/blob/gz-rendering9_9.0.0/package.xml#L22-L23)
135+
but they are not available on all Linux versions, so work around with
136+
`--skip-keys "libogre-dev libogre-next-2.3-dev"`.
137+
106138
## Building the Gazebo Libraries
107139

108140
Once the compiler and all the sources are in place it is time to compile them.

0 commit comments

Comments
 (0)