Table of Contents:

Apertis provides tools, pre-installed in the Apertis SDK, for the purpose of downloading and interacting with sysroots.

These tools are pre-installed in the Apertis SDK. The SDK images shipped by Apertis are meant to be run in VirtualBox. They provide a common, reproducible environment to build both platform packages and application-bundles for Apertis. The tool provides general manual pages so you can get command information by using man ade on the SDK.

This page formerly contained information on building and debugging applications built on top of the legacy Canterbury-based application framework. As part of the migration to the next-gen framework, this documentation has been migrated to the Flatpak guide.

Installation of a sysroot

ade sysroot list is used to check which sysroots are already installed on the SDK. If there’s no installed sysroot image, the result would be like the following message.

$ ade sysroot list
No sysroot installed in directory /opt/sysroot/.

ade sysroot latest provides the version and downloadable URL of the sysroot image.

$ ade sysroot latest
* No distribution specified, defaulting to host distribution
* No release version specified, defaulting to host release version
* No architecture specified, defaulting to 'armhf'
* Checking latest version available for apertis - v2021 (armhf)
* Retrieved latest version: apertis v2021 - 20210915.0115 (armhf)
* Download URL: https://images.apertis.org/daily/v2021/20210915.0115/armhf/sysroot/sysroot-apertis-v2021-armhf-20210915.0115.tar.gz

The ade sysroot install command will do everything needed to install the latest sysroot version on your SDK, from downloading to installing without any manual intervention. This will default to installing a sysroot for armhf, using the distribution and release of the current SDK, specify using the command line arguments if this is not what is required (see ade sysroot install --help for more information):

$ ade sysroot install
* No distribution specified, defaulting to host distribution
* No release version specified, defaulting to host release version
* No architecture specified, defaulting to 'armhf'
* Installing version apertis v2021 - 20210915.0115 (armhf)
sysroot.tar.gz |==================================================| 100%

When the installation command has completed its job, the installed status can be checked with ade sysroot installed.

$ ade sysroot installed
* No distribution specified, defaulting to host distribution
* No release version specified, defaulting to host release version
* No architecture specified, defaulting to 'armhf'
* Retrieved current version: apertis v2021 - 20210915.0115 (armhf)