1.3.1. Linux installation from sources using colcon¶
colcon is a command line tool based on CMake aimed at building sets of software packages in a tidy and easy way. The instructions for installing the AML-IP using colcon application from sources and its required dependencies are provided in this page.
Follow the instructions below to build eProsima AML-IP, after making sure all required dependencies are installed in your system (Dependencies).
22.214.171.124.1. Download eProsima dependencies¶
AML-IPdirectory and download the
.reposfile that will be used to install AML-IP and its dependencies:
mkdir -p ~/AML-IP/src cd ~/AML-IP wget https://raw.githubusercontent.com/eProsima/AML-IP/main/amlip.repos vcs import src < amlip.repos
In case there are already some eProsima libraries installed in the system, it is not required to download and build every dependency in the
.reposfile, but just those projects that are not already in the system. Refer to section eProsima dependencies in order to check how to source those libraries.
126.96.36.199.2. Build packages¶
Build the packages:
colcon build --packages-up-to-regex amlip
Not all the sub-packages of all the dependencies are required.
In order to build only the packages required, use the colcon option
e.g. the AML-IP C++ library is completely built using
For more details about the colcon available arguments, please refer to packages selection
page of the colcon manual.
Being based on CMake, it is possible to pass the CMake configuration options to the
command. For more information on the specific syntax, please refer to the
CMake specific arguments
page of the colcon manual.
For more details about the available CMake options, please refer to the CMake options section.
188.8.131.52.3. Run Tests¶
Tests are not automatically built within the AML-IP project. Use CMake option BUILD_TESTS when building the project in order to activate tests. This could also be done by a colcon.meta file to only activate tests in the desired packages.
Build the packages with tests:
colcon build --packages-select-regex amlip --cmake-args "-DBUILD_TESTS=ON"
Run tests. Use
--packages-select <package-name>to only execute tests of a specific package:
colcon test --event-handlers=console_direct+ --packages-select amlip_cpp
184.108.40.206. Source installation¶
To source the installation of the previously built AML-IP (in order to use its tools or link against it), use the following command:
220.127.116.11. Build demos¶
There is a demo sub-package that can be installed along with the project. In order to install this package use one of these 2 commands:
# To build all sub-packages
# To only build demo package and its dependencies
colcon build --packages-up-to amlip_demo_nodes