Next Tutorial: Nodes and Topics Previous Tutorial: Introduction
Overview
This page contains instructions to install Gazebo Transport on all the support platforms including major Linux distributions, Mac OS X and Windows.
You can find all Gazebo Transport versions at https://gazebosim.org/libs/transport.
Binary Install
Ubuntu
Setup your computer to accept software from packages.osrfoundation.org:
Setup keys:
Install Gazebo Transport:
Be sure to replace <#>
with a number value, such as 8
or 9
, depending on which version you need.
Mac OS X
Gazebo Transport and several of its dependencies can be compiled on OS X with Homebrew using the osrf/simulation tap. Gazebo Transport is straightforward to install on Mac OS X 10.9 (Mavericks) or higher. Installation on older versions requires changing the default standard library and rebuilding dependencies due to the use of c++11. For purposes of this documentation, Assuming OS X 10.9 or greater is in use. Here are the instructions:
Install homebrew, which should also prompt you to install the XCode command-line tools:
Run the following commands:
Be sure to replace <#>
with a number value, such as 8
or 9
, depending on which version you need.
Windows
Install Conda package management system. Miniconda suffices.
Create if necessary, and activate a Conda environment:
Install:
Be sure to replace <#>
with a number value, such as 1 or 2, depending on which version you need.
Source Install
Ubuntu Linux
For compiling the latest version of Gazebo Transport you will need an Ubuntu distribution equal to 20.04 (Focal) or newer.
Make sure you have removed the Ubuntu pre-compiled binaries before installing from source:
Install prerequisites. A clean Ubuntu system will need:
Clone the repository
Configure and build
Configure Gazebo Transport (choose either method a or b below):
A. Release mode (recommended): This will generate optimized code, but will not have debug symbols. Use this mode if you don't need to use GDB (advanced).
Note: You can use a custom install path to make it easier to switch between source and debian installs:
B. Debug mode: This will generate code with debug symbols. Gazebo Transport will run slower, but you'll be able to use GDB.
The output from cmake ../
may generate a number of errors and warnings about missing packages. You must install the missing packages that have errors and re-run cmake ../
. Make sure all the build errors are resolved before continuing (they should be there from the earlier step in which you installed prerequisites).
Make note of your install path, which is output from cmake and should look something like:
Build Gazebo Transport:
Install Gazebo Transport:
If you decide to install gazebo in a local directory you'll need to modify your LD_LIBRARY_PATH
:
Uninstalling Source-based Install
If you need to uninstall Gazebo Transport or switch back to a debian-based install when you currently have installed the library from source, navigate to your source code directory's build folders and run make uninstall
:
macOS
- Clone the repository Be sure to replacegit clone https://github.com/gazebosim/gz-transport -b gz-transport<#>
<#>
with a number value, such as 10 or 11, depending on which version you need. From version 12 usegz-transport<#>
for lower versions useign-transport<#>
- Install dependencies Be sure to replacebrew install --only-dependencies gz-transport<#>
<#>
with a number value, such as 10 or 11, depending on which version you need. - Configure and build cd gz-transportmkdir buildcd buildcmake ..make
- Optionally, install sudo make install
Windows
Prerequisites
First, follow the gz-cmake tutorial for installing Conda, Visual Studio, CMake, etc., prerequisites, and creating a Conda environment.
Navigate to condabin
if necessary to use the conda
command (i.e., if Conda is not in your PATH
environment variable. You can find the location of condabin
in Anaconda Prompt, where conda
).
Activate the Conda environment:
Install prerequisites:
Install Gazebo dependencies:
You can view available versions and their dependencies:
Install dependencies, replacing <#>
with the desired versions:
Building from Source
- Navigate to where you would like to build the library, and clone the repository. # Optionally, append `-b gz-transport#` (replace # with a number) to check out a specific version.From version 12 use `gz-transport<#>` for lower versions use `ign-transport<#>`git clone https://github.com/gazebosim/gz-transport.git
- Configure and build cd gz-transportmkdir buildcd buildcmake .. -DBUILD_TESTING=OFF # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\installcmake --build . --config Release
- Optionally, install. You will likely need to run a terminal with admin privileges for this call to succeed. cmake --install . --config Release
Optionally, build the examples
If you installed to a custom location, you may need to specify
-DCMAKE_PREFIX_PATH
, pointing to the directory containing the filegz-transport<#>-config.cmake
. That file is installed to theCMAKE_INSTALL_PREFIX
, for example,path\to\install\gz-transport<#>\lib\cmake\gz-transport<#>
.cd gz-transport\examplemkdir buildcd buildcmake .. # Optionally, -DCMAKE_PREFIX_PATH=path\to\cmake\configcmake --build . --config ReleaseTry an example
responserIn another terminal, run
requester
Documentation
Visit the documentation page.
Build documentation
Upload documentation to gazebosim.org.
If you're creating a new release, then tell gazebosim.org about the new version. For example:
Testing
Tests can be run by building the test
target. From your build directory you can run:
Note: Python tests require running sudo make install
before running make test
.