# 添加自定义分发包配置

以下小节介绍如何添加自定义分发包配置并重建工作区。

## Qualcomm 定义的分发包配置概述

为 Qualcomm Linux 定义的参考分发包位于 `<workspace>/layers/meta-qcom-distro/conf/distro/qcom-wayland.conf`。要检查 DISTRO\_FEATURES 变量，请运行以下命令：

bitbake -e | grep ^DISTRO_FEATURES=
    Copy to clipboard

输出：

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"
    Copy to clipboard

Note

[分发包特性](https://docs.yoctoproject.org/5.0.6/singleindex.html#distro-features)描述了输出中显示的 DISTRO\_FEATURES。

## 添加分发配置

要添加分发包配置文件，请执行以下操作：

1. 在 `<workspace>/layers/meta-qcom-distro/conf/distro` 中添加一个 `test-distro.conf` 文件。
2. 使用与 `qcom-wayland.conf` 相同的内容， 即，`cp qcom-wayland.conf test-distro.conf`。
3. 在 `test-distro.conf` 文件中配置 `DISTRO_NAME = "Test Reference Distro with Wayland"`。
4. 在 `test-distro.conf` 文件中配置 `DISTROOVERRIDES = "test-dist"`。
5. 使用source设置环境并用export配置环境变量，如下所示：

MACHINE="qcs6490-rb3gen2-core-kit" DISTRO="test-distro" source setup-environment
        Copy to clipboard

用source配置环境后，当前工作区目录更改为 `<workspace>/build-test-distro`。要验证定义的 `test-distro` 是否已生效，请打开 `conf/auto.conf` 文件以确认以下内容：

# This configuration file is dynamically generated every time
    # set_bb_env.sh is sourced to set up a workspace.  DO NOT EDIT.
    #--------------------------------------------------------------
    DISTRO ?= "test-distro"
    Copy to clipboard

若要验证输出，请运行以下命令：

bitbake -e | grep ^DISTROOVERRIDES=
    DISTROOVERRIDES="test-dist"
    Copy to clipboard

Note

如果您有权访问 `meta-qcom-extras`，请将其 `EXTRALAYERS ?=` `${WORKSPACE}/layers/meta-qcom-extras` `conf/bblayers.conf` 添加到文件中。

若要重新生成镜像，请运行以下命令：

bitbake qcom-multimedia-image
    Copy to clipboard

## 启用或禁用 DISTRO\_FEATURES

DISTRO\_FEATURES 提供一种机制来验证哪些软件包必须包含在生成的镜像中。您可以通过 DISTRO\_FEATURES 变量选择要启用的功能，该变量在 `test-distro.conf` 分发包的配置文件中设置或附加。有关更多信息，请参阅[分发包特性](https://docs.yoctoproject.org/5.0.6/singleindex.html#distro-features)。

Note

选择由社区定义的功能。

1. 打开文件 `test-distro.conf` 并添加下面一行内容 ：

DISTRO_FEATURES:append = " cramfs"
        Copy to clipboard
2. 测试更改是否已生效，然后重新生成：

bitbake -e | grep ^DISTRO_FEATURES=
        Copy to clipboard

    输出如下：

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"
        Copy to clipboard
3. 若要重新生成，请运行以下命令：

bitbake qcom-multimedia-image
        Copy to clipboard

Last Published: Jul 24, 2025

[Previous Topic
添加自定义机器配置](https://docs.qualcomm.com/bundle/publicresource/80-70020-27SC/topics/add_custom_machine_configurations.md) [Next Topic
添加镜像配方](https://docs.qualcomm.com/bundle/publicresource/80-70020-27SC/topics/add_image_recipes.md)