diff options
Diffstat (limited to 'documentation/ref-manual/migration-3.2.rst')
-rw-r--r-- | documentation/ref-manual/migration-3.2.rst | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/documentation/ref-manual/migration-3.2.rst b/documentation/ref-manual/migration-3.2.rst index 57c74354f9..9b65e26c48 100644 --- a/documentation/ref-manual/migration-3.2.rst +++ b/documentation/ref-manual/migration-3.2.rst | |||
@@ -75,6 +75,37 @@ pseudo will throw an ``abort()`` and direct you to a :yocto_wiki:`wiki page </wi | |||
75 | that explains how to deal with this. | 75 | that explains how to deal with this. |
76 | 76 | ||
77 | 77 | ||
78 | .. _migration-3.2-multilib-mlprefix: | ||
79 | |||
80 | ``MLPREFIX`` now required for multilib when runtime dependencies conditionally added | ||
81 | ------------------------------------------------------------------------------------ | ||
82 | |||
83 | In order to solve some previously intractable problems with runtime | ||
84 | dependencies and multilib, a change was made that now requires the :term:`MLPREFIX` | ||
85 | value to be explicitly prepended to package names being added as | ||
86 | dependencies (e.g. in :term:`RDEPENDS` and :term:`RRECOMMENDS` values) | ||
87 | where the dependency is conditionally added. | ||
88 | |||
89 | If you have anonymous python or in-line python conditionally adding | ||
90 | dependencies in your custom recipes, and you intend for those recipes to | ||
91 | work with multilib, then you will need to ensure that ``${MLPREFIX}`` | ||
92 | is prefixed on the package names in the dependencies, for example | ||
93 | (from the ``glibc`` recipe): :: | ||
94 | |||
95 | RRECOMMENDS_${PN} = "${@bb.utils.contains('DISTRO_FEATURES', 'ldconfig', '${MLPREFIX}ldconfig', '', d)}" | ||
96 | |||
97 | This also applies when conditionally adding packages to :term:`PACKAGES` where | ||
98 | those packages have dependencies, for example (from the ``alsa-plugins`` recipe): :: | ||
99 | |||
100 | PACKAGES += "${@bb.utils.contains('PACKAGECONFIG', 'pulseaudio', 'alsa-plugins-pulseaudio-conf', '', d)}" | ||
101 | ... | ||
102 | RDEPENDS_${PN}-pulseaudio-conf += "\ | ||
103 | ${MLPREFIX}libasound-module-conf-pulse \ | ||
104 | ${MLPREFIX}libasound-module-ctl-pulse \ | ||
105 | ${MLPREFIX}libasound-module-pcm-pulse \ | ||
106 | " | ||
107 | |||
108 | |||
78 | .. _migration-3.2-packagegroup-core-device-devel: | 109 | .. _migration-3.2-packagegroup-core-device-devel: |
79 | 110 | ||
80 | packagegroup-core-device-devel no longer included in images built for qemu* machines | 111 | packagegroup-core-device-devel no longer included in images built for qemu* machines |