From ea8c38f2466fe555519561739d8f288d9ec218ae Mon Sep 17 00:00:00 2001 From: Mabel Zhang Date: Thu, 24 Dec 2020 10:06:39 -0500 Subject: [PATCH 1/6] move Documentation and Testing sections back to README Signed-off-by: Mabel Zhang --- README.md | 59 +++++++++++++++++++++++++++- tutorials/01_install.md | 87 ++++++++++++++++++++++++++++++++++++++++- 2 files changed, 143 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 02baacd24..6cf397b8e 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,9 @@ which can be used to add custom widgets. * [Source Install](#markdown-header-source-install) - * [Prerequisites](#markdown-header-prerequisites) +[Testing](#testing) + +[Folder Structure](#folder-structure) * [Building from Source](#markdown-header-building-from-source) @@ -165,6 +167,61 @@ After building, to run all tests: See [this tutorial](https://ignitionrobotics.org/api/gui/3.0/install.html) for further instructions on how to disable testing, run test coverage, etc. +# Documentation + +API documentation and tutorials can be accessed at +[https://ignitionrobotics.org/libs/gui](https://ignitionrobotics.org/libs/gui) + +You can also generate the documentation from a clone of this repository by following these steps. + +1. You will need [Doxygen](http://www.doxygen.org/). On Ubuntu Doxygen can be installed using + + ``` + sudo apt-get install doxygen + ``` + +2. Clone the repository + + ``` + git clone https://github.com/ignitionrobotics/ign-gui + ``` + +3. Configure and build the documentation. + + ``` + cd ign-gui + mkdir build + cd build + cmake ../ + make doc + ``` + +4. View the documentation by running the following command from the `build` directory. + + ``` + firefox doxygen/html/index.html + ``` + +# Testing + +Follow these steps to run tests and static code analysis in your clone of this repository. + +1. Follow the [source install instruction](#source-install). + +2. Run tests. + + ``` + make test + ``` + +3. Static code checker. + + ``` + make codecheck + ``` + +See the [Writing Tests section of the contributor guide](https://ignitionrobotics.org/docs/all/contributing#writing-tests) for help creating or modifying tests. + # Folder Structure * `include/ignition/gui`: Contains all the files which will be installed, such as diff --git a/tutorials/01_install.md b/tutorials/01_install.md index ca97711cb..c90b65180 100644 --- a/tutorials/01_install.md +++ b/tutorials/01_install.md @@ -2,5 +2,88 @@ Next Tutorial: \ref commandline -Refer to [Ignition GUI's entry page](https://ignitionrobotics.org/libs/gui) -for install instructions. +# Install + +These instructions are for installing only Ignition GUI. If you're interested +in using all the Ignition libraries, not only Igniton GUI, check out this +[Ignition installation](https://ignitionrobotics.org/docs/latest/install). + +We recommend following the binary install instructions to get up and running as +quickly and painlessly as possible. + +The source install instructions should be used if you need the very latest +software improvements, if you need to modify the code, or if you plan to make a +contribution. + +## Binary Install + +### Ubuntu + +On Ubuntu, it's possible to install Ignition GUI as follows: + +Add OSRF packages: + + echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list + sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys D2486D2DD83DB69272AFE98867170598AF249743 + sudo apt update + +Install Ignition GUI: + + sudo apt install libignition-gui<#>-dev + +Be sure to replace `<#>` with a number value, such as 1 or 2, depending on +which version you need. + +### macOS + +On macOS, add OSRF packages: + + ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" + brew tap osrf/simulation + +Install Ignition GUI: + + brew install ignition-gui<#> + +Be sure to replace `<#>` with a number value, such as 1 or 2, depending on +which version you need. + +## Source Install + +### Prerequisites + +#### Ubuntu Bionic 18.04 or above + +Add OSRF packages: + + sudo apt update + sudo apt -y install wget lsb-release gnupg + sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list' + wget http://packages.osrfoundation.org/gazebo.key -O - | apt-key add - + sudo apt-add-repository -s "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -c -s) main" + +Clone source code: + + # This checks out the `master` branch. You can append `-b ign-gui#` (replace # with a number) to checkout a specific version + git clone http://github.com/ignitionrobotics/ign-gui + +Install dependencies + + sudo apt -y install $(sort -u $(find . -iname 'packages.apt') | tr '\n' ' ') + +Only on Bionic, update the GCC compiler version: + + sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 + + +### Building from source + +Build and install as follows: + + cd ign-gui + mkdir build + cd build + cmake .. + make -j4 + sudo make install + From 5f9e71110f9ef5711f1344d32a8823263dde68fa Mon Sep 17 00:00:00 2001 From: Mabel Zhang Date: Thu, 24 Dec 2020 10:34:17 -0500 Subject: [PATCH 2/6] add windows installation Signed-off-by: Mabel Zhang --- tutorials/01_install.md | 74 ++++++++++++++++++++++++++++++++++++++--- 1 file changed, 70 insertions(+), 4 deletions(-) diff --git a/tutorials/01_install.md b/tutorials/01_install.md index c90b65180..98a1cb92b 100644 --- a/tutorials/01_install.md +++ b/tutorials/01_install.md @@ -48,11 +48,15 @@ Install Ignition GUI: Be sure to replace `<#>` with a number value, such as 1 or 2, depending on which version you need. +### Windows + +Binary install is pending ``ignition-rendering`` and ``ignition-gui`` being added to conda-forge. + ## Source Install -### Prerequisites +### Ubuntu Bionic 18.04 or above -#### Ubuntu Bionic 18.04 or above +#### Install Prerequisites Add OSRF packages: @@ -75,8 +79,7 @@ Only on Bionic, update the GCC compiler version: sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 - -### Building from source +#### Build from source Build and install as follows: @@ -87,3 +90,66 @@ Build and install as follows: make -j4 sudo make install +### Windows + +#### Install Prerequisites + +First, follow the [ign-cmake](https://github.com/ignitionrobotics/ign-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``). + +Create if necessary, and activate a Conda environment: + +``` +conda create -n ign-ws +conda activate ign-ws +``` + +Install dependencies: +``` +conda install qt --channel conda-forge +``` + +Install Ignition dependencies, replacing `<#>` with the desired versions: + +``` +conda install libignition-cmake<#> libignition-common<#> libignition-math<#> libignition-transport<#> libignition-msgs<#> libignition-plugin<#> libignition-tools<#> --channel conda-forge +``` + +Before [ign-rendering](https://github.com/ignitionrobotics/ign-rendering) becomes available on conda-forge, follow its tutorial to build it from source. + +#### Build from source + +1. Activate the Conda environment created in the prerequisites: + + ``` + conda activate ign-ws + ``` + +1. Navigate to where you would like to build the library, and clone the repository. + + ``` + # Optionally, append `-b ign-gui#` (replace # with a number) to check out a specific version + git clone https://github.com/ignitionrobotics/ign-gui.git + ``` + +1. Configure and build + + ``` + cd ign-gui + mkdir build + cd build + ``` + + Before ``ign-rendering`` becomes available on conda-forge, we need to build it from source and specify the path containing ``ignition-rendering<#>-config.cmake`` and ``ignition-rendering<#>-ogre-config.cmake`` in ``CMAKE_PREFIX_PATH``. That path could be ``ign-rendering-install-path\lib\cmake``, for example. + + ``` + cmake .. -DBUILD_TESTING=OFF -DCMAKE_PREFIX_PATH=path\containing\ignition-rendering-config # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install + cmake --build . --config Release + ``` + +1. Optionally, install + + ``` + cmake --install . --config Release + ``` From 9bbdfcc85cca3bf3a7478f2e673ec996ca3a1a94 Mon Sep 17 00:00:00 2001 From: John Shepherd Date: Wed, 20 Jan 2021 09:25:55 -0800 Subject: [PATCH 3/6] nits Signed-off-by: John Shepherd --- README.md | 2 +- tutorials/01_install.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 6cf397b8e..5b30b6a68 100644 --- a/README.md +++ b/README.md @@ -192,7 +192,7 @@ You can also generate the documentation from a clone of this repository by follo cd ign-gui mkdir build cd build - cmake ../ + cmake .. make doc ``` diff --git a/tutorials/01_install.md b/tutorials/01_install.md index 98a1cb92b..9ad0095e0 100644 --- a/tutorials/01_install.md +++ b/tutorials/01_install.md @@ -73,7 +73,7 @@ Clone source code: Install dependencies - sudo apt -y install $(sort -u $(find . -iname 'packages.apt') | tr '\n' ' ') + sudo apt -y install $(sort -u $(find . -iname 'packages.apt') | tr '\n' ' ') Only on Bionic, update the GCC compiler version: @@ -148,7 +148,7 @@ Before [ign-rendering](https://github.com/ignitionrobotics/ign-rendering) become cmake --build . --config Release ``` -1. Optionally, install +1. Optionally, install. You will likely need to run a terminal with admin privileges for this call to succeed. ``` cmake --install . --config Release From 977f8cc98df30ae212b432fc8bf0af3de05d96ba Mon Sep 17 00:00:00 2001 From: John Shepherd Date: Wed, 20 Jan 2021 09:30:12 -0800 Subject: [PATCH 4/6] another nit Signed-off-by: John Shepherd --- tutorials/01_install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/01_install.md b/tutorials/01_install.md index 9ad0095e0..1c386ed00 100644 --- a/tutorials/01_install.md +++ b/tutorials/01_install.md @@ -141,7 +141,7 @@ Before [ign-rendering](https://github.com/ignitionrobotics/ign-rendering) become cd build ``` - Before ``ign-rendering`` becomes available on conda-forge, we need to build it from source and specify the path containing ``ignition-rendering<#>-config.cmake`` and ``ignition-rendering<#>-ogre-config.cmake`` in ``CMAKE_PREFIX_PATH``. That path could be ``ign-rendering-install-path\lib\cmake``, for example. + As ``ign-rendering`` is not yet available on conda-forge, we need to build it from source and specify the path containing ``ignition-rendering<#>-config.cmake`` and ``ignition-rendering<#>-ogre-config.cmake`` in ``CMAKE_PREFIX_PATH``. That path could be ``ign-rendering-install-path\lib\cmake``, for example. ``` cmake .. -DBUILD_TESTING=OFF -DCMAKE_PREFIX_PATH=path\containing\ignition-rendering-config # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install From 4034218cb137f19a1f6fc800431615cbea5b183b Mon Sep 17 00:00:00 2001 From: John Shepherd Date: Wed, 20 Jan 2021 14:25:57 -0800 Subject: [PATCH 5/6] move docs and testing to install Signed-off-by: John Shepherd --- README.md | 59 -------------- tutorials/01_install.md | 168 ++++++++++++++++++++++++++-------------- 2 files changed, 110 insertions(+), 117 deletions(-) diff --git a/README.md b/README.md index 5b30b6a68..c51a6fd30 100644 --- a/README.md +++ b/README.md @@ -39,10 +39,6 @@ which can be used to add custom widgets. [Usage](#markdown-header-usage) -[Documentation](#markdown-header-documentation) - -[Testing](#markdown-header-testing) - [Folder Structure](#markdown-header-folder-structure) [Code of Conduct](#markdown-header-code-of-conduct) @@ -167,61 +163,6 @@ After building, to run all tests: See [this tutorial](https://ignitionrobotics.org/api/gui/3.0/install.html) for further instructions on how to disable testing, run test coverage, etc. -# Documentation - -API documentation and tutorials can be accessed at -[https://ignitionrobotics.org/libs/gui](https://ignitionrobotics.org/libs/gui) - -You can also generate the documentation from a clone of this repository by following these steps. - -1. You will need [Doxygen](http://www.doxygen.org/). On Ubuntu Doxygen can be installed using - - ``` - sudo apt-get install doxygen - ``` - -2. Clone the repository - - ``` - git clone https://github.com/ignitionrobotics/ign-gui - ``` - -3. Configure and build the documentation. - - ``` - cd ign-gui - mkdir build - cd build - cmake .. - make doc - ``` - -4. View the documentation by running the following command from the `build` directory. - - ``` - firefox doxygen/html/index.html - ``` - -# Testing - -Follow these steps to run tests and static code analysis in your clone of this repository. - -1. Follow the [source install instruction](#source-install). - -2. Run tests. - - ``` - make test - ``` - -3. Static code checker. - - ``` - make codecheck - ``` - -See the [Writing Tests section of the contributor guide](https://ignitionrobotics.org/docs/all/contributing#writing-tests) for help creating or modifying tests. - # Folder Structure * `include/ignition/gui`: Contains all the files which will be installed, such as diff --git a/tutorials/01_install.md b/tutorials/01_install.md index 1c386ed00..d2787fa8d 100644 --- a/tutorials/01_install.md +++ b/tutorials/01_install.md @@ -22,14 +22,16 @@ contribution. On Ubuntu, it's possible to install Ignition GUI as follows: Add OSRF packages: - - echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list - sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys D2486D2DD83DB69272AFE98867170598AF249743 - sudo apt update + ``` + echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list + sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys D2486D2DD83DB69272AFE98867170598AF249743 + sudo apt update + ``` Install Ignition GUI: - - sudo apt install libignition-gui<#>-dev + ``` + sudo apt install libignition-gui<#>-dev + ``` Be sure to replace `<#>` with a number value, such as 1 or 2, depending on which version you need. @@ -37,20 +39,22 @@ which version you need. ### macOS On macOS, add OSRF packages: - - ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" - brew tap osrf/simulation + ``` + ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" + brew tap osrf/simulation + ``` Install Ignition GUI: - - brew install ignition-gui<#> + ``` + brew install ignition-gui<#> + ``` Be sure to replace `<#>` with a number value, such as 1 or 2, depending on which version you need. ### Windows -Binary install is pending ``ignition-rendering`` and ``ignition-gui`` being added to conda-forge. +Binary install is pending `ignition-rendering` and `ignition-gui` being added to conda-forge. ## Source Install @@ -59,36 +63,41 @@ Binary install is pending ``ignition-rendering`` and ``ignition-gui`` being adde #### Install Prerequisites Add OSRF packages: - - sudo apt update - sudo apt -y install wget lsb-release gnupg - sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list' - wget http://packages.osrfoundation.org/gazebo.key -O - | apt-key add - - sudo apt-add-repository -s "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -c -s) main" + ``` + sudo apt update + sudo apt -y install wget lsb-release gnupg + sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list' + wget http://packages.osrfoundation.org/gazebo.key -O - | apt-key add - + sudo apt-add-repository -s "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -c -s) main" + ``` Clone source code: - - # This checks out the `master` branch. You can append `-b ign-gui#` (replace # with a number) to checkout a specific version - git clone http://github.com/ignitionrobotics/ign-gui + ``` + # This checks out the `master` branch. You can append `-b ign-gui#` (replace # with a number) to checkout a specific version + git clone http://github.com/ignitionrobotics/ign-gui + ``` Install dependencies - - sudo apt -y install $(sort -u $(find . -iname 'packages.apt') | tr '\n' ' ') + ``` + sudo apt -y install $(sort -u $(find . -iname 'packages.apt') | tr '\n' ' ') + ``` Only on Bionic, update the GCC compiler version: - - sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 + ``` + sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 + ``` #### Build from source Build and install as follows: - - cd ign-gui - mkdir build - cd build - cmake .. - make -j4 - sudo make install + ``` + cd ign-gui + mkdir build + cd build + cmake .. + make -j4 + sudo make install + ``` ### Windows @@ -96,10 +105,9 @@ Build and install as follows: First, follow the [ign-cmake](https://github.com/ignitionrobotics/ign-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``). +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 @@ -111,7 +119,6 @@ conda install qt --channel conda-forge ``` Install Ignition dependencies, replacing `<#>` with the desired versions: - ``` conda install libignition-cmake<#> libignition-common<#> libignition-math<#> libignition-transport<#> libignition-msgs<#> libignition-plugin<#> libignition-tools<#> --channel conda-forge ``` @@ -121,35 +128,80 @@ Before [ign-rendering](https://github.com/ignitionrobotics/ign-rendering) become #### Build from source 1. Activate the Conda environment created in the prerequisites: - - ``` - conda activate ign-ws - ``` + ``` + conda activate ign-ws + ``` 1. Navigate to where you would like to build the library, and clone the repository. - - ``` - # Optionally, append `-b ign-gui#` (replace # with a number) to check out a specific version - git clone https://github.com/ignitionrobotics/ign-gui.git - ``` + ``` + # Optionally, append `-b ign-gui#` (replace # with a number) to check out a specific version + git clone https://github.com/ignitionrobotics/ign-gui.git + ``` 1. Configure and build + ``` + cd ign-gui + mkdir build + cd build + ``` + + As `ign-rendering` is not yet available on conda-forge, we need to build it from source and specify the path containing `ignition-rendering<#>-config.cmake` and `ignition-rendering<#>-ogre-config.cmake` in `CMAKE_PREFIX_PATH`. That path could be `ign-rendering-install-path\lib\cmake`, for example. + ``` + cmake .. -DBUILD_TESTING=OFF -DCMAKE_PREFIX_PATH=path\containing\ignition-rendering-config # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install + cmake --build . --config Release + ``` - ``` - cd ign-gui - mkdir build - cd build - ``` +1. Optionally, install. You will likely need to run a terminal with admin privileges for this call to succeed. + ``` + cmake --install . --config Release + ``` - As ``ign-rendering`` is not yet available on conda-forge, we need to build it from source and specify the path containing ``ignition-rendering<#>-config.cmake`` and ``ignition-rendering<#>-ogre-config.cmake`` in ``CMAKE_PREFIX_PATH``. That path could be ``ign-rendering-install-path\lib\cmake``, for example. +# Documentation - ``` - cmake .. -DBUILD_TESTING=OFF -DCMAKE_PREFIX_PATH=path\containing\ignition-rendering-config # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install - cmake --build . --config Release - ``` +API documentation and tutorials can be accessed at +[https://ignitionrobotics.org/libs/gui](https://ignitionrobotics.org/libs/gui) -1. Optionally, install. You will likely need to run a terminal with admin privileges for this call to succeed. +You can also generate the documentation from a clone of this repository by following these steps. + +1. You will need [Doxygen](http://www.doxygen.org/). On Ubuntu Doxygen can be installed using + ``` + sudo apt-get install doxygen + ``` + +2. Clone the repository + ``` + git clone https://github.com/ignitionrobotics/ign-gui + ``` + +3. Configure and build the documentation. + ``` + cd ign-gui + mkdir build + cd build + cmake .. + make doc + ``` + +4. View the documentation by running the following command from the `build` directory. + ``` + firefox doxygen/html/index.html + ``` + +# Testing + +Follow these steps to run tests and static code analysis in your clone of this repository. + +1. Follow the [source install instruction](#source-install). + +2. Run tests. + ``` + make test + ``` + +3. Static code checker. + ``` + make codecheck + ``` + +See the [Writing Tests section of the contributor guide](https://ignitionrobotics.org/docs/all/contributing#writing-tests) for help creating or modifying tests. - ``` - cmake --install . --config Release - ``` From f1610c19f83028910c2a08c48ab26044e71ac3ae Mon Sep 17 00:00:00 2001 From: John Shepherd Date: Thu, 21 Jan 2021 11:08:17 -0800 Subject: [PATCH 6/6] remove install and folder structure Signed-off-by: John Shepherd --- README.md | 80 +------------------------------------------------------ 1 file changed, 1 insertion(+), 79 deletions(-) diff --git a/README.md b/README.md index c51a6fd30..52d397271 100644 --- a/README.md +++ b/README.md @@ -27,16 +27,6 @@ which can be used to add custom widgets. [Install](#markdown-header-install) -* [Binary Install](#markdown-header-binary-install) - -* [Source Install](#markdown-header-source-install) - -[Testing](#testing) - -[Folder Structure](#folder-structure) - - * [Building from Source](#markdown-header-building-from-source) - [Usage](#markdown-header-usage) [Folder Structure](#markdown-header-folder-structure) @@ -58,65 +48,7 @@ which can be used to add custom widgets. # Install -We recommend following the [Binary Install](#markdown-header-binary-install) instructions to get up and running as quickly and painlessly as possible. - -The [Source Install](#markdown-header-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 - -On Ubuntu Bionic, it's possible to install Ignition GUI's version 1 as follows: - -Add OSRF packages: - - echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable bionic main" > /etc/apt/sources.list.d/gazebo-stable.list - sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys D2486D2DD83DB69272AFE98867170598AF249743 - sudo apt update - -Install Ignition GUI: - - sudo apt install libignition-gui3-dev - -## Source Install - -There are currently two versions under active development: - -* **Version 0**: It makes use of `QWidgets`, which are common on traditional - desktop-oriented interfaces. Requires Ubuntu Xenial or Higher. - -* **Version 1**: It makes use of `QtQuick`, which allows developing more - modern-looking apps with animations and a mobile/web feel. Requires Ubuntu - Bionic or higher. - -### Prerequisites - -#### Ubuntu Bionic 18.04 or above - -Install dependencies: - - sudo apt update - sudo apt -y install wget lsb-release gnupg - sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list' - sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-prerelease `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-prerelease.list' - wget http://packages.osrfoundation.org/gazebo.key -O - | apt-key add - - sudo apt-add-repository -s "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -c -s) main" - sudo apt-get build-dep -y ignition-gui3 - sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 800 --slave /usr/bin/g++ g++ /usr/bin/g++-8 --slave /usr/bin/gcov gcov /usr/bin/gcov-8 - -Clone source code: - - # This checks out the `default` branch. You can append `-b ign-gui#` (replace # with a number) to checkout a specific version - git clone http://github.com/ignitionrobotics/ign-gui - -### Building from source - -Build and install as follows: - - cd ign-gui - mkdir build - cd build - cmake .. - make -j4 - sudo make install +See [the install tutorial](https://ignitionrobotics.org/api/gui/3.0/install.html). # Usage @@ -153,16 +85,6 @@ export IGN_CONFIG_PATH=$HOME/.ignition/tools/configs This issue is tracked [here](https://github.com/ignitionrobotics/ign-tools/issues/8/too-strict-looking-for-config-paths). -# Testing - -After building, to run all tests: - - cd build - make test - -See [this tutorial](https://ignitionrobotics.org/api/gui/3.0/install.html) for -further instructions on how to disable testing, run test coverage, etc. - # Folder Structure * `include/ignition/gui`: Contains all the files which will be installed, such as