qi 3.1.5

Conan

Additionally, libqi-python is available as a Conan 2 project, which means you can use Conan to fetch dependencies.

You can install and/or upgrade Conan 2 and create a default profile in the following way:

# install/upgrade Conan 2
pip install --upgrade conan~=2
# create a default profile
conan profile detect

Install dependencies from Conan and build with CMake

The procedure to build the project using Conan to fetch dependencies is the following.

Most dependencies are available on Conan Center repository and should not require any additional steps to make them available. However, you might need to first get and export the libqi recipe into your local Conan cache.

# GitHub is available, but you can also use internal GitLab.
QI_REPOSITORY="https://github.com/aldebaran/libqi.git"
QI_VERSION="4.0.1" # Checkout the version your project need.
QI_PATH="$HOME/libqi" # Or whatever path you want.
git clone \
  --depth=1 `# Only fetch one commit.` \
  --branch "qi-framework-v${QI_VERSION}" \
  "${QI_REPOSITORY}" \
  "${QI_PATH}"
conan export "${QI_PATH}" \
  --version "${QI_VERSION}" # Technically not required but some
                            # versions of libqi require it
                            # because of a bug.

You can then install the libqi-python dependencies in Conan.

conan install . \
  --build=missing `# Build dependencies binaries that are missing in Conan.` \
  -s build_type=Debug `# Build in debug mode.` \
  -c tools.build:skip_test=true `# Skip tests building for dependencies.` \
  -c '&:tools.build:skip_test=false' # Do not skip tests for the project.

This will generate a build directory containing a configuration with a toolchain file that allows CMake to find dependencies inside the Conan cache.

You can then invoke CMake directly inside the build configuration directory to configure and build the project. Fortunately, Conan also generates a CMake preset that simplifies the process. The name of the preset may differ on your machine. You may need to find the preset generated by Conan first by calling:

cmake --list-presets

Here, we’ll assume that the preset is named conan-linux-x86_64-gcc-debug. To start building, you need to configure with CMake and then build:

cmake --preset conan-linux-x86_64-gcc-debug
cmake --build --preset conan-linux-x86_64-gcc-debug

Tests can now be invoked using CTest, but they require a runtime environment from Conan so that all dependencies are found:

source build/linux-x86_64-gcc-debug/generators/conanrun.sh
ctest --preset conan-linux-x86_64-gcc-debug --output-on-failure
source build/linux-x86_64-gcc-debug/generators/deactivate_conanrun.sh

Finally, you can install the project in the directory of your choice.

The project defines a single install component, the Module component.

# `cmake --install` does not support presets sadly.
cmake \
  --install build/linux-x86_64-gcc-debug \
  --component Module --prefix ~/my-libqi-python-install

conan install . \
  --build=missing `# Build dependencies binaries that are missing in Conan.` \
  -c tools.build:skip_test=true # Skip any test.

pip install -U build
python -m build \
  --config-setting cmake.define.CMAKE_TOOLCHAIN_FILE=$PWD/build/linux-x86_64-gcc-release/generators/conan_toolchain.cmake

pip install -U auditwheel # or `delocate` on MacOS.
auditwheel repair \
  --strip `# Strip debugging symbols to get a lighter archive.` \
  `# The desired platform, which may differ depending on your build host.` \
  `# With Ubuntu 20.04, we can target manylinux_2_31. Newer versions of` \
  `# Ubuntu will have to target newer versions of manylinux.` \
  `# If you don't need a manylinux archive, you can also target the` \
  `# 'linux_x86_64' platform.` \
  --plat manylinux_2_31_x86_64 \
  `# Path to the wheel archive.` \
  dist/qi-*.whl
# The wheel will be by default placed in a `./wheelhouse/` directory.