Boot to Qt for embedded Linux is built using the tools and resources from the Yocto Project, and is based on Yocto's reference distribution (Poky). You can use the same tools to build custom Boot to Qt images and QBSP files. This topic describes the requirements for the custom build environment and instructs how you can set up the environment.

By default, The Qt Company will only provide customer support for the Yocto recipes on the reference platforms, as delivered with Boot to Qt, and setting up the development environment for them. Receiving support for any other configuration requires a separate service agreement between a customer and The Qt Company.

Requirements for Environment

When you customize Boot to Qt, you should be familiar with the Yocto tools and the concept of recipes. For more information, see Yocto Project documentation.

Before you start making custom Boot to Qt builds or QBSP files, ensure that your build host fulfills the requirements listed in Supported Linux Distribution and that you have installed all the required dependencies for the Yocto tools listed in Required Packages for the Build Host. Qt has additional requirements for the compiler and needs a more recent version of GCC than Yocto. Make sure your build host has a supported GCC version available.

Additionally, you need to install the git-lfs and Google repo tools.

Initializing Yocto Build Environment

Use the Google repo tool to initialize the Yocto environment:

cd <BuildDir>
repo init -u git://code.qt.io/yocto/boot2qt-manifest -m <manifest>
repo sync

Where manifest is one of the XML manifest files available in the https://code.qt.io/cgit/yocto/boot2qt-manifest.git/tree/ repository. A separate manifest file is available for each release and all the current branches have manifests that follow the latest changes.

After the Yocto environment is set up, you need to configure the build environment for your target device.