From a6752eb2a43f81a5e8ec54e7605d2058aa58d4b9 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 13 Oct 2016 16:19:19 -0700 Subject: ref-manual: Added the 2.2 Migration guide section. (From yocto-docs rev: 668e32419ba59d975a196967e620c384009426a4) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/migration.xml | 427 +++++++++++++++++++++++++++++++++ 1 file changed, 427 insertions(+) (limited to 'documentation') diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index 65a8ba8e30..54adec844e 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -3333,6 +3333,433 @@ +
+ Moving to the Yocto Project 2.2 Release + + + This section provides migration information for moving to the + Yocto Project 2.2 Release from the prior release. + + +
+ + The minimum kernel version is now 3.2.0, due to the upgrade + to glibc 2.24. + Specifically, for AArch64-based targets the version is + 3.14. + For Nios II-based targets, the minimum kernel version is 3.19. + + For x86 and x86_64, you can reset + OLDEST_KERNEL + to anything down to 2.6.32 if desired. + + +
+ +
+ Staging Directories in Sysroot Has Been Simplified + + + The way directories are staged in sysroot has been simplified and + introduces the new + SYSROOT_DIRS, + SYSROOT_DIRS_NATIVE, + and + SYSROOT_DIRS_BLACKLIST. + See the + v2 patch series on the OE-Core Mailing List + for additional information. + +
+ +
+ Removal of Old Images and Other Files in <filename>tmp/deploy</filename> Now Enabled + + + Removal of old images and other files in + tmp/deploy/ is now enabled by default due + to a new staging method used for those files. + As a result of this change, the + RM_OLD_IMAGE + variable is now redundant. + +
+ +
+ BitBake Now Requires Python 3.4+ + + + BitBake requires Python 3.4 or greater. + +
+ +
+ Metadata Must Now Use Python 3 Syntax + + + The metadata is now required to use Python 3 syntax. + For help preparing metadata, see any of the many Python 3 porting + guides available. + Alternatively, you can reference the conversion commits for Bitbake + and you can use OE-Core as a guide for changes. + Following are particular areas of interest: + + * subprocess command-line pipes needing locale decoding + * the syntax for octal values changed + * the iter*() functions changed name + * iterators now return views + * not lists + * changed names for Python modules + + +
+ +
+ Target Python Recipes Switched to Python 3 + + + Most target Python recipes have now been switched to Python 3. + Unfortunately, systems using RPM as a package manager and + providing online package-manager support through SMART still + require Python 2. + +
+ +
+ uClibc Replaced by musl + + + Uclibc has been removed in favor of musl. + +
+ +
+ <filename>${B}</filename> No Longer Default Working Directory for Tasks + + + ${B} + is no longer the default working directory for tasks. + Consequently, any custom tasks you define now need to either + have the + [dirs] flag set, or the task needs to change into the + appropriate working directory manually (e.g using + cd for a shell task). + + The preferred method is to use the + [dirs] flag. + + +
+ +
+ UTF-8 Locale Required on Build Host + + + A UTF-8 locale is required on the build host due to Python 3. + Since C.UTF-8 is not a standard, the default is en_US.UTF-8. + +
+ +
+ <filename>runqemu</filename> Ported to Python + + + runqemu has been ported to Python and has + changed behavior in some cases. + +
+ +
+ BitBake Changes + + + The following changes took place for BitBake: + + + The "goggle" UI and standalone image-writer tool have + been removed as they both require GTK+ 2.0 and + were not being maintained. + + + The Perforce fetcher now supports + SRCREV + for specifying the source revision to use, be it + ${AUTOREV}, + changelist number, p4date, or label, in preference to + separate + SRC_URI + parameters to specify these. + This change is more in-line with how the other fetchers + work for source control systems. + Recipes that fetch from Perforce will need to be updated + to use SRCREV in place of specifying + the source revision within + SRC_URI. + + + Some of BitBake's internal code structures for storing the + recipe cache needed to be changed to support the new + multi-configuration functionality. + These changes will affect external tools that use BitBake's + tinfoil module. + For information on these changes, see the changes made to + the scripts supplied with OpenEmbedded-Core: 1 2. + + + The task management code has been rewritten to avoid using + ID indirection in order to improve performance. + This change is unlikely to cause any problems for most + users. + However, the setscene verification function as pointed to + by BB_SETSCENE_VERIFY_FUNCTION + needed to change signature. + Consequently, a new variable named + BB_SETSCENE_VERIFY_FUNCTION2 + has been added allowing multiple versions of BitBake + to work with suitably written metadata, which includes + OpenEmbedded-Core and Poky. + Anyone with custom BitBake task scheduler code might also + need to update the code to handle the new structure. + + + +
+ +
+ Swabber has Been Removed + + + Swabber, a tool that was intended to detect host contamination in + the build process, has been removed, as it has been unmaintained + and unused for some time and was never particularly effective. + The OpenEmbedded build system has since incorporated a number of + mechanisms including enhanced QA checks that mean that there is + less of a need for such a tool. + +
+ +
+ Removed Recipes + + + The following recipes have been removed: + + + augeas: + No longer needed and has been moved to + meta-oe. + + + directfb: + Unmaintained and has been moved to + meta-oe. + + + gcc: + Removed 4.9 version. + Versions 5.4 and 6.2 are still present. + + + gnome-doc-utils: + No longer needed. + + + gtk-doc-stub: + Replaced by gtk-doc. + + + gtk-engines: + No longer needed and has been moved to + meta-gnome. + + + gtk-sato-engine: + Became obsolete. + + + libglade: + No longer needed and has been moved to + meta-oe. + + + libmad: + Unmaintained and functionally replaced by + libmpg123. + libmad has been moved to + meta-oe. + + + libowl: + Became obsolete. + + + libxsettings-client: + No longer needed. + + + oh-puzzles: + Functionally replaced by + puzzles. + + + oprofileui: + Became obsolete. + OProfile has been largely supplanted by perf. + + + packagegroup-core-directfb.bb: + Removed. + + + core-image-directfb.bb: + Removed. + + + pointercal: + No longer needed and has been moved to + meta-oe. + + + python-imaging: + No longer needed and moved to + meta-python + + + python-pyrex: + No longer needed and moved to + meta-python. + + + sato-icon-theme: + Became obsolete. + + + swabber-native: + Swabber has been removed. + See the + entry on Swabber. + + + tslib: + No longer needed and has been moved to + meta-oe. + + + uclibc: + Removed in favor of musl. + + + xtscal: + No longer needed and moved to + meta-oe + + + +
+ +
+ Removed Classes + + + The following classes have been removed: + + + distutils-native-base: + No longer needed. + + + distutils3-native-base: + No longer needed. + + + sdl: + Only set + DEPENDS + and + SECTION, + which are better set within the recipe instead. + + + sip: + Mostly unused. + + + swabber: + See the + entry on Swabber. + + + +
+ +
+ Minor Packaging Changes + + + The following minor packaging changes have occurred: + + + grub: + Split grub-editenv into its own + package. + + + systemd: + Split container and vm related units into a new package, + systemd-container. + + + util-linux: + Make prlimit a separate package. + + + +
+ +
+ Miscellaneous Changes + + + The following miscellaneous changes have occurred: + + + buildtools-tarball: + Replaced nativesdk-python + with nativesdk-python3. + + + package_regex.inc: + Removed deprecated file. + + + recipetool: + Set a fixed + SRCREV + by default when fetching from Git. + + + devtool: + Set a fixed + SRCREV + by default when fetching from Git. + + + distcc: + GTK+ UI is now disabled by default. + + + packagegroup-core-tools-testapps: + Removed Piglit. + + + image.bbclass: + Renamed COMPRESS(ION) to CONVERSION. + + + +
+
+