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.

Note: About Support Services for Yocto Tools

By default, The Qt Company will only provide customer support for the Yocto recipes on the reference platforms, as delivered with Qt for Device Creation, 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 Compatible Linux Distribution and that you have installed all the required dependencies for the Yocto tools listed in Required Packages for the Build Host.

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.

Note: When using the Google repo tool, you don't need to use the b2qt-init-build-env script anymore. Its usage is still supported if you have installed meta-boot2qt sources from the installer. If you want to initialize the Yocto environment from the meta-boot2qt sources, run the following commands:

cd <BuildDir>
<INSTALL_DIR>/<Qt version>/Boot2Qt/sources/meta-boot2qt/b2qt-init-build-env init --device imx6qsabresd