Supported distribution

Currently, only Ubuntu 18.04 distribution has been tested, and is highly recommended. We plan to support Ubuntu 20.04 very soon.

Install development environment

The SolAR framework uses a dedicated pipeline to link and compile code as well as internal tools for third party downloads which should make your job much easier. As you will see later, the SolAR framework is based on QMake originally created by the Qt Company, but compliant with most IDE.

Install QT Creator IDE

As SolAR is using QMake file to setup the projects, we highly recommend to install Qt Creator. Moreover, you will have access to wizards which will help you create new SolAR modules, components and pipelines.

Download the latest version of QTCreator on the following link (scroll down to choose "Downloads for open-source users" for open-source development): QT installer download

When downloaded, right click on the Qt file, select properties, Permissions, and check Authorize execution of the file. Then, run your installer.

Create a Qt account if not already done, select where you want to install Qt.
You don’t need to install Qt SDK, just the Qt Creator. So just check the following components:

  • Qt x.x.x (last version proposed)

    • With Desktop gcc 64-bit (version of gcc is 7.5)

    • Android (if you want to build SolAR for Android)

  • Developer and Designer Tools

and start the installation.

Install dependencies

To download dependencies, the SolAR framework uses the meta dependencies management tool Remaken supporting Conan, VCPKG and its native C++ packaging structure based on pkg-config description files.

Install Remaken

  • Download the XPCF Linux Installer zip file.

  • Uncompress this zip file.

  • If Homebrew is not installed on your machine, you can run the following script ./ Homebrew is used to install Remaken.

  • run source ~/.profile to update brew eval modification to your ${HOME}/.profile. Try brew --version commands in terminal to check installation

  • Then, run ./ 1.8. This will install the version 1.8 of remaken on your machine. If you want to install the latest version, just run ./ Recent version have not been yet validated for SolAR 0.10.0.

  • run again source ~/.profile to update your ${HOME}/.profile.

  • By default, Remaken installer will also install Conan, cmake and pkg_config which will be used afterwards. Try remaken --help, conan -h, and cmake -h commands in a terminal to check installation. Conan will check these remotes when searching for your dependencies.

  • SolAR has its own conan remote to store pre-built dependencies for the common configurations used by the SolAR Framework. You will need to add these conan remotes with the following commands in a command prompt:

conan remote add conan-solar --insert 0
conan remote add conan-bcom --insert 1

You should obtain a list of conan remotes that looks like this:

$ conan remote list
conan-solar: [Verify SSL: True]
conan-bcom: [Verify SSL: True]
conancenter: [Verify SSL: True]

If other remote are installed, such as conan-center or bincrafters (both deprecated), you can remove them by running conan remote remove name_of_the_remote, or just disable them by running conan remote disable name_of_the_remote.

Then, open a command prompt with administrator rights and run:

remaken init -e -f

This command will install the latest version of qmake building rules in your ${USER_HOME}/.remaken/rules folder.

Permanently add the PKG_CONFIG_PATH environment variable pointing to the folders where .pc files can be found:

test -r ~/.profile && echo "export PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/share/pkgconfig" >>~/.profile

and reload your .profile:

source ~/.profile

Finally, you need to configure your remaken profile according to your development environment. To do so, run the following command in a command prompt:

remaken profile init --cpp-std 17 -b gcc -o linux -a x86_64

Set conan profile

As we are using conan to download dependencies, you need to configure your default conan profile. To do so, create a new default profile with the following command:

conan profile new default --detect

Then, update your default profile with the two following commands:

conan profile update settings.compiler.libcxx=libstdc++11 default
conan profile update settings.compiler.cppstd=17 default

Your default profile file available in your ${HOME}/.conan/profiles should looks like the following one:


Now, you are ready to download your dependencies with remaken.

Use Remaken

Remaken uses a file called packagedependencies.txt to describe which depedencies to install, in which version, where to install them, where to download them, with which package manager and with which configuration.

A global packagedepedencies.txt defining the common dependencies with specific packagedependencies-<os>.txt files defining dependencies which are specific for each os are available in the parent GIT repository SolAR, and can be downloaded on the following link:

Copy these files where you want on your computer, open a command prompt in the folder where you have copied the packagedependencies.txt and packagedependencies-<os>.txt files, and run remaken with the following command:

remaken install packagedependencies.txt

This command will install all SolAR dependencies in release mode in your ${HOME}/.remaken/packages folder. You can go and have a cup of coffee while it’s downloading.

To download the dependencies in debug mode, run the following command:

remaken install -c debug packagedependencies.txt
You do not need to launch remaken install on packagedependencies_linux. remaken install packagedependencies.txt will automatically load it depending on the platform you are executing it.

This is done, all your dependencies are downloaded and ready to use !

Some of the module will download and build third parties using Conan which requires CMake (minimum version 3.10).

Build SolAR v0.10.0

Clone SolAR

SolAR is made up of a multitude of projects (SolAR Framework, SolAR pipeline manager, modules, samples, etc.). To help you, we have created a parent repository with sub-modules regrouping all source codes of SolAR projects. You can clone it from the following url:

No space in the path of the folder where you are cloning SolAR !
git clone --recurse-submodules

If you forgot to use --recurse-submodules, you can initialize the submodules afterwards with:

cd SolAR
git submodule update --init --recursive

If you want to move all submodules on HEAD of master, launch the following commands

git submodule foreach --recursive git checkout master
git submodule foreach --recursive git pull

If you do not want to download all the source codes of SolAR, you can have a look to the different repositories available on Github on the Community/Git page.

Build with scripts

For Linux, build scripts are available in the scripts folder. Just run ./ to rebuild the SolAR framework, the modules and their tests, the pipelines and their tests, the samples, the services and their tests. If you want to rebuild them seprately, use the corresponding script.

Build on Qt Creator

Counting the framework, the pipeline manager, modules, module tests, samples, pipelines, pipeline tests, there are more than 60 QT projects on GitHub. In order to ease the building of all these projects, they are grouped in the following parent QT projects available into the root folder of SolAR:

  • SolARCore

  • SolARAllModules

  • SolARAllModulesTests

  • SolARAllSamples

  • SolARAllPipelines

  • SolARAllPipelineTests

  • SolARAllServices

  • SolARAllServicesTests

You can open one of them or all in QT Creator.

If you have not yet run a qmake on each project, some error could appear concerning the fact that conanbuildinfo.pri files do not exist. This is normal, run qmake on each project will create these files, and the error message will no longer appear.

Check by clicking on the Projects tab, and then on the Manage Kits…​ button that your Qt x.x.x GCC 64 bit kit is well configured.

Now, you have to configure your parent project before building them. In your project build settings of your kit, for each configuration (release and debug), add the following argument to the Builds Steps > Make step:

  • SolARCore: install

  • SolARAllModules: install and install_deps

  • SolARAllModulesTests: install and install_deps

  • SolARAllSamples: install and install_deps

  • SolARAllPipelines: install

  • SolARAllPipelineTests: install and install_deps

The install step will copy the built binaries into ${HOME}/.remaken/packages, and the install_deps step will also copy its dependencies.

Since QT Creator 4.14.0, we highly recommand to set the project option qmake system() behavior when parsing to Ignore to highly reduce the project loading time. But do not forget to run qmake on projects before building them.
Add install argurment
Figure 1. Add install and install_deps argument for Debug and Release mode.

If you open several projects, you will have to set their build order. You can do it in QT Creator by defining the dependencies of each project in the Projects menu, select your project, click on Dependencies, and check the projects that depend directly on the selected project (checking `Synchronize configuration' will synchronize all projects in Debug or Release configuration).

Edit build settings
Figure 2. Project dependencies settings
Table 1. Project dependencies
Project Project dependencies












No dependency

Then, in the Build menu, click on Rebuild All Projects for All Configurations, and go get a cup of coffee.


Remaken does not work

Be sure to install, init and use Remaken from a command prompt with admin rights. You can check that cmake, pkg-config and conan are well installed with the following command:

cmake -version
pkg-config --version
conan -v