Skip to main content
The following explains how to add a custom distribution configuration and rebuild the workspace. The reference distribution defined for Qualcomm Linux is at <workspace>/layers/meta-qcom-distro/conf/distro/qcom-distro.conf. To inspect the DISTRO_FEATURES variable, run the following command: 
bitbake -e | grep ^DISTRO_FEATURES=
Output: 
DISTRO_FEATURES="acl alsa argp bluetooth debuginfod ext2 ipv4 ipv6 largefile pcmcia usbgadget usbhost wifi xattr nfs zeroconf pci 3g nfc  vfat seccomp pam overlayfs acl xattr selinux ptest security virtualization tpm wayland vulkan opengl systemd pulseaudio gobject-introspection-data ldconfig"
Distribution features describe the DISTRO_FEATURES shown in the output.

​
Add distribution configuration

To add a distribution configuration file, do the following:
  1. Add a test-distro.conf file in <workspace>/layers/meta-qcom-distro/conf/distro.
  2. Use the same content as qcom-distro.conf, that is, cp qcom-distro.conf test-distro.conf.
  3. Set DISTRO_NAME = "Test reference distribution" in the test-distro.conf file.
  4. Set DISTROOVERRIDES = "test-dist" in the test-distro.conf file.
  5. Use meta-qcom/ci/qcom-distro.yml as a reference to create a the test-distro distribution file.
  6. To initialize the kas build environment, run the following command: 
    kas shell meta-qcom/ci/rb3gen2-core-kit.yml:meta-qcom/ci/test-distro.yml
After initializing the kas build environment, to verify if the test-distro has taken effect and to build the image, follow the steps:
  1. To verify if the test-distro defined has taken effect, open the conf/local.conf file to confirm the following: 
    DISTRO ?= "test-distro"
  2. To verify the output, run the following command: 
    bitbake -e | grep ^DISTROOVERRIDES=
DISTROOVERRIDES="test-dist"
    Note If you have access to meta-qcom-extras, add it to EXTRALAYERS ?=${WORKSPACE}/layers/meta-qcom-extras in the conf/bblayers.conf file.
  3. To rebuild the image, run the following command: 
    bitbake qcom-multimedia-image

​
Enable or disable DISTRO_FEATURES

DISTRO_FEATURES provide a mechanism to verify which packages are included in the generated images. You can select the features you want to enable through the DISTRO_FEATURES variable, which is set or appended to in a test-distro.conf configuration file of a distribution. For more information, see Distribution features. Note Select a feature defined by the community.
  1. Open the test-distro.conf file and add the following line: 
    DISTRO_FEATURES:append = " cramfs"
  2. Test if the change has taken effect, and then rebuild: 
    bitbake -e | grep ^DISTRO_FEATURES=
    The output is as follows: 
    DISTRO_FEATURES="acl alsa argp bluetooth debuginfod ext2 ipv4 ipv6 largefile pcmcia usbgadget usbhost wifi xattr nfs zeroconf pci 3g nfc  vfat seccomp pam overlayfs acl xattr selinux ptest security virtualization tpm usrmerge sota wayland vulkan opengl cramfs systemd pulseaudio gobject-introspection-data ldconfig"
  3. To rebuild, run the following command: 
    bitbake qcom-multimedia-image