1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82
|
\page install Installation
# Overview
This tutorial describes how to install Ignition Utils on Linux, Mac OS X and
Windows via either a binary distribution or from source.
[Install](#install)
* [Binary Install](#binary-install)
* [Source Install](#source-install)
* [Prerequisites](#prerequisites)
* [Building from Source](#building-from-source)
# Install
We recommend following the [Binary Install](#binary-install) instructions to get up and running as quickly and painlessly as possible.
The [Source Install](#source-install) instructions should be used if you need the very latest software improvements, you need to modify the code, or you plan to make a contribution.
## Binary Install
### Ubuntu Linux
Setup your computer to accept software from *packages.osrfoundation.org*:
```{.sh}
sudo sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list'
```
Setup keys:
```{.sh}
wget http://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add -
```
Install Ignition Utils:
```
sudo apt install libignition-utils<#>-dev
```
Be sure to replace `<#>` with a number value, such as 1 or 2, depending on
which version you need.
## Source Install
Source installation can be performed in UNIX systems by first installing the
necessary prerequisites followed by building from source.
### Building from source
1. Clone the repository
```
git clone https://github.com/ignitionrobotics/ign-utils -b ign-utils<#>
```
Be sure to replace `<#>` with a number value, such as 1 or 2, depending on
which version you need.
2. Install dependencies
```
export SYSTEM_VERSION=bionic
sudo apt -y install \
$(sort -u $(find . -iname 'packages-'$SYSTEM_VERSION'.apt' -o -iname 'packages.apt') | tr '\n' ' ')
```
3. Configure and build
```
cd ign-utils; mkdir build; cd build; cmake ..; make
```
4. Optionally, install Ignition Utils
```
sudo make install
```
|