# 添加自定义分发包配置

下面介绍了如何添加自定义分发包配置并重新编译工作区。

为 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

[分发包特性](https://docs.yoctoproject.org/5.0.11/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`。

1. 要验证定义的 `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
2. 若要验证输出，请运行以下命令：

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

Note

如果您有权访问 `meta-qcom-extras`，请将其 `EXTRALAYERS ?=` `${WORKSPACE}/layers/meta-qcom-extras` `conf/bblayers.conf` 添加到文件中。
3. 若要重新生成镜像，请运行以下命令：

bitbake qcom-multimedia-image
        Copy to clipboard

## 启用或禁用 `DISTRO_FEATURES`

`DISTRO_FEATURES` 提供了一种机制来验证生成的镜像中包含哪些软件包。您可以通过 `DISTRO_FEATURES` 变量选择要启用的功能，该变量是在 `test-distro.conf` 分发包的配置文件中设置或附加的。有关更多信息，请参阅[分发包特性](https://docs.yoctoproject.org/5.0.11/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: Nov 04, 2025

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