Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add Windows installation #34

Merged
merged 6 commits into from
Jan 21, 2021
Merged

Add Windows installation #34

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
f3f7a10
add windows installation
mabelzhang Dec 24, 2020
73e9df8
tweaks
mabelzhang Dec 24, 2020
a882227
backport #27
mabelzhang Jan 14, 2021
f20a230
standardize to ign-common format
mabelzhang Jan 14, 2021
e25ba68
change nesting
mabelzhang Jan 14, 2021
bcd9e93
spacing nit
Jan 20, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 1 addition & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,20 +23,7 @@ of libraries designed to rapidly develop robot applications.

## Installation

Standard installation can be performed in UNIX systems using the following
steps:

mkdir build/
cd build/
cmake ..
sudo make install

## Uninstallation

To uninstall the software installed with the previous steps:

cd build/
sudo make uninstall
See the [installation tutorial](https://ignitionrobotics.org/api/plugin/1.1/installation.html).

## Test

Expand Down
184 changes: 127 additions & 57 deletions tutorials/02_installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,105 +1,175 @@
\page installation Installation

This tutorial describes how to install Ignition Plugin on [Ubuntu Linux](#ubuntu_install) and [macOS](#macos_install) via either a binary distribution or from source. Support for Windows is coming soon.
These instructions are for installing only Ignition Plugin.
If you're interested in using all the Ignition libraries, check out this [Ignition installation](https://ignitionrobotics.org/docs/latest/install).

We recommend following the Binary Installation instructions to get up and running as quickly and painlessly as possible.

## Ubuntu ## {#ubuntu_install}
The Source Installation 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.

# Ubuntu

## Prerequisites

Ignition Plugin version 1 requires Ubuntu Bionic, while version 0
can be used with Ubuntu Xenial.

If you don't already have the `lsb-release` package installed, please do so now:
```{.sh}
```
sudo apt-get update
sudo apt-get install lsb-release
```

Setup your computer to accept software from
[packages.osrfoundation.org](http://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 Plugin
## Binary Installation

```{.sh}
On Ubuntu systems, `apt-get` can be used to install `ignition-plugin`:
```
sudo apt-get update
sudo apt-get install libignition-plugin-dev
sudo apt install libignition-plugin-dev
```

**Build from source**
## Source Installation

Run the following to install dependencies
```{.sh}
sudo apt-get install libignition-cmake2-dev
```
1. Install Ignition dependencies
```
sudo apt-get install libignition-cmake2-dev
```

Clone the ign-plugin repository from GitHub
```{.sh}
git clone https://github.com/ignitionrobotics/ign-plugin
```
2. Clone the repository
```
git clone https://github.com/ignitionrobotics/ign-plugin
```

Then build using CMake
```{.sh}
cd ign-plugin
mkdir build
cd build
cmake ..
make
sudo make install
```
3. Configure and build
```
cd ign-plugin
mkdir build
cd build
cmake ..
make
```

4. Optionally, install
```
sudo make install
```

# macOS

## macOS ## {#macos_install}
## Prerequisites

Ignition Plugin and several of its dependencies can be installed on macOS
with [Homebrew](http://brew.sh/) using the [osrf/simulation
tap](https://github.com/osrf/homebrew-simulation). Ignition Plugin version 1
requires macOS High Sierra (10.13) or later, while version 0 supports
Sierra (10.12) or later.

**Install Binaries using Homebrew**
## Binary Installation

Install homebrew, which should also prompt you to install the XCode
command-line tools:
1. Install Homebrew, which should also prompt you to install the XCode command-line tools
```
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```

```{.sh}
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
2. Run the following commands
```
brew tap osrf/simulation
brew install ignition-plugin1
```

Run the following commands:
## Source Installation

```{.sh}
brew tap osrf/simulation
brew install ignition-plugin1
```
1. Install dependencies
```
brew tap osrf/simulation
brew install ignition-plugin1 --only-dependencies
```

**Build from source using Homebrew**
2. Clone the repository
```
git clone https://github.com/ignitionrobotics/ign-plugin
```

Run the following to install dependencies
```{.sh}
brew tap osrf/simulation
brew install ignition-plugin1 --only-dependencies
```
3. Configure and build
```
cd ign-plugin
mkdir build
cd build
cmake ..
make
```

4. Optionally, install
```
sudo make install
```

Clone the ign-plugin repository from GitHub
```{.sh}
git clone https://github.com/ignitionrobotics/ign-plugin
# Windows

## Prerequisites

First, follow the [ign-cmake](https://github.com/ignitionrobotics/ign-cmake) tutorial for installing Conda, Visual Studio, CMake, and other prerequisites, and also for 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``).

Create if necessary, and activate a Conda environment:
```
conda create -n ign-ws
conda activate ign-ws
```

## Binary Installation

Then build using CMake
```{.sh}
cd ign-plugin
mkdir build
cd build
cmake ..
make
sudo make install
```
conda install libignition-plugin<#> --channel conda-forge
```

Be sure to replace `<#>` with a number value, such as 2 or 3, depending on
which version you need.

## Source Installation

This assumes you have created and activated a Conda environment while installing the Prerequisites.

1. Install Ignition dependencies:

You can view available versions and their dependencies:
```
conda search libignition-plugin* --channel conda-forge --info
```

Install dependencies, replacing `<#>` with the desired version:
```
conda install libignition-cmake<#> --channel conda-forge
```

2. Navigate to where you would like to build the library, and clone the repository.
```
# Optionally, append `-b ign-plugin#` (replace # with a number) to check out a specific version
git clone https://github.com/ignitionrobotics/ign-plugin.git
```

3. Configure and build
```
cd ign-plugin
mkdir build
cd build
cmake .. -DBUILD_TESTING=OFF # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install
cmake --build . --config Release
```

4. Optionally, install
```
cmake --install . --config Release
```