4 Migrating to a Newer Yocto Project Release

This chapter provides information you can use to migrate work to a newer Yocto Project release. You can find the same information in the release notes for a given release.

• 4.1 General Migration Considerations
• 4.2 Moving to the Yocto Project 1.3 Release
  • 4.2.1 Local Configuration
    • 4.2.1.1 SSTATE_MIRRORS
    • 4.2.1.2 bblayers.conf
  • 4.2.2 Recipes
    • 4.2.2.1 Python Function Whitespace
    • 4.2.2.2 proto= in SRC_URI
    • 4.2.2.3 nativesdk
    • 4.2.2.4 Task Recipes
    • 4.2.2.5 IMAGE_FEATURES
    • 4.2.2.6 Removed Recipes
  • 4.2.3 Linux Kernel Naming
• 4.3 Moving to the Yocto Project 1.4 Release
  • 4.3.1 BitBake
  • 4.3.2 Build Behavior
  • 4.3.3 Proxies and Fetching Source
  • 4.3.4 Custom Interfaces File (netbase change)
  • 4.3.5 Remote Debugging
  • 4.3.6 Variables
  • 4.3.7 Target Package Management with RPM
  • 4.3.8 Recipes Moved
  • 4.3.9 Removals and Renames
• 4.4 Moving to the Yocto Project 1.5 Release
  • 4.4.1 Host Dependency Changes
  • 4.4.2 atom-pc Board Support Package (BSP)
  • 4.4.3 BitBake
  • 4.4.4 QA Warnings
  • 4.4.5 Directory Layout Changes
  • 4.4.6 Shortened Git SRCREV Values
  • 4.4.7 IMAGE_FEATURES
  • 4.4.8 /run
  • 4.4.9 Removal of Package Manager Database Within Image Recipes
  • 4.4.10 Images Now Rebuild Only on Changes Instead of Every Time
  • 4.4.11 Task Recipes
  • 4.4.12 BusyBox
  • 4.4.13 Automated Image Testing
  • 4.4.14 Build History
  • 4.4.15 udev
  • 4.4.16 Removed and Renamed Recipes
  • 4.4.17 Other Changes
• 4.5 Moving to the Yocto Project 1.6 Release
  • 4.5.1 archiver Class
  • 4.5.2 Packaging Changes
  • 4.5.3 BitBake
    • 4.5.3.1 Matching Branch Requirement for Git Fetching
    • 4.5.3.2 Python Definition substitutions
    • 4.5.3.3 SVK Fetcher
    • 4.5.3.4 Console Output Error Redirection
    • 4.5.3.5 task-taskname Overrides
  • 4.5.4 Changes to Variables
    • 4.5.4.1 TMPDIR
    • 4.5.4.2 PRINC
    • 4.5.4.3 IMAGE_TYPES
    • 4.5.4.4 COPY_LIC_MANIFEST
    • 4.5.4.5 COPY_LIC_DIRS
    • 4.5.4.6 PACKAGE_GROUP
    • 4.5.4.7 Preprocess and Post Process Command Variable Behavior
  • 4.5.5 Package Test (ptest)
  • 4.5.6 Build Changes
  • 4.5.7 qemu-native
  • 4.5.8 core-image-basic
  • 4.5.9 Licensing
  • 4.5.10 CFLAGS Options
  • 4.5.11 Custom Image Output Types
  • 4.5.12 Tasks
  • 4.5.13 update-alternative Provider
  • 4.5.14 virtclass Overrides
  • 4.5.15 Removed and Renamed Recipes
  • 4.5.16 Removed Classes
  • 4.5.17 Reference Board Support Packages (BSPs)
• 4.6 Moving to the Yocto Project 1.7 Release
  • 4.6.1 Changes to Setting QEMU PACKAGECONFIG Options in local.conf
  • 4.6.2 Minimum Git version
  • 4.6.3 Autotools Class Changes
  • 4.6.4 Binary Configuration Scripts Disabled
  • 4.6.5 eglibc 2.19 Replaced with glibc 2.20
  • 4.6.6 Kernel Module Autoloading
  • 4.6.7 QA Check Changes
  • 4.6.8 Removed Recipes
  • 4.6.9 Miscellaneous Changes
• 4.7 Moving to the Yocto Project 1.8 Release
  • 4.7.1 Removed Recipes
  • 4.7.2 BlueZ 4.x / 5.x Selection
  • 4.7.3 Kernel Build Changes
  • 4.7.4 SSL 3.0 is Now Disabled in OpenSSL
  • 4.7.5 Default Sysroot Poisoning
  • 4.7.6 Rebuild Improvements
  • 4.7.7 QA Check and Validation Changes
  • 4.7.8 Miscellaneous Changes
• 4.8 Moving to the Yocto Project 2.0 Release
  • 4.8.1 GCC 5
  • 4.8.2 Gstreamer 0.10 Removed
  • 4.8.3 Removed Recipes
  • 4.8.4 BitBake datastore improvements
  • 4.8.5 Shell Message Function Changes
  • 4.8.6 Extra Development/Debug Package Cleanup
  • 4.8.7 Recipe Maintenance Tracking Data Moved to OE-Core
  • 4.8.8 Automatic Stale Sysroot File Cleanup
  • 4.8.9 linux-yocto Kernel Metadata Repository Now Split from Source
  • 4.8.10 Additional QA checks
  • 4.8.11 Miscellaneous Changes
• 4.9 Moving to the Yocto Project 2.1 Release
  • 4.9.1 Variable Expansion in Python Functions
  • 4.9.2 Overrides Must Now be Lower-Case
  • 4.9.3 Expand Parameter to getVar() and getVarFlag() is Now Mandatory
  • 4.9.4 Makefile Environment Changes
  • 4.9.5 libexecdir Reverted to ${prefix}/libexec
  • 4.9.6 ac_cv_sizeof_off_t is No Longer Cached in Site Files
  • 4.9.7 Image Generation is Now Split Out from Filesystem Generation
  • 4.9.8 Removed Recipes
  • 4.9.9 Class Changes
  • 4.9.10 Build System User Interface Changes
  • 4.9.11 ADT Removed
  • 4.9.12 Poky Reference Distribution Changes
  • 4.9.13 Packaging Changes
  • 4.9.14 Tuning File Changes
  • 4.9.15 Supporting GObject Introspection
  • 4.9.16 Miscellaneous Changes
• 4.10 Moving to the Yocto Project 2.2 Release
  • 4.10.1 Minimum Kernel Version
  • 4.10.2 Staging Directories in Sysroot Has Been Simplified
  • 4.10.3 Removal of Old Images and Other Files in tmp/deploy Now Enabled
  • 4.10.4 Python Changes
    • 4.10.4.1 BitBake Now Requires Python 3.4+
    • 4.10.4.2 UTF-8 Locale Required on Build Host
    • 4.10.4.3 Metadata Must Now Use Python 3 Syntax
    • 4.10.4.4 Target Python Recipes Switched to Python 3
    • 4.10.4.5 buildtools-tarball Includes Python 3
  • 4.10.5 uClibc Replaced by musl
  • 4.10.6 ${B} No Longer Default Working Directory for Tasks
  • 4.10.7 runqemu Ported to Python
  • 4.10.8 Default Linker Hash Style Changed
  • 4.10.9 KERNEL_IMAGE_BASE_NAME no Longer Uses KERNEL_IMAGETYPE
  • 4.10.10 BitBake Changes
  • 4.10.11 Swabber has Been Removed
  • 4.10.12 Removed Recipes
  • 4.10.13 Removed Classes
  • 4.10.14 Minor Packaging Changes
  • 4.10.15 Miscellaneous Changes
• 4.11 Moving to the Yocto Project 2.3 Release
  • 4.11.1 Recipe-specific Sysroots
  • 4.11.2 PATH Variable
  • 4.11.3 Changes to Scripts
  • 4.11.4 Changes to Functions
  • 4.11.5 BitBake Changes
  • 4.11.6 Absolute Symbolic Links
  • 4.11.7 GPLv2 Versions of GPLv3 Recipes Moved
  • 4.11.8 Package Management Changes
  • 4.11.9 Removed Recipes
  • 4.11.10 Wic Changes
  • 4.11.11 QA Changes
  • 4.11.12 Miscellaneous Changes
• 4.12 Moving to the Yocto Project 2.4 Release
  • 4.12.1 Memory Resident Mode
  • 4.12.2 Packaging Changes
  • 4.12.3 Removed Recipes
  • 4.12.4 Kernel Device Tree Move
  • 4.12.5 Package QA Changes
  • 4.12.6 README File Changes
  • 4.12.7 Miscellaneous Changes
• 4.13 Moving to the Yocto Project 2.5 Release
  • 4.13.1 Packaging Changes
  • 4.13.2 Removed Recipes
  • 4.13.3 Scripts and Tools Changes
  • 4.13.4 BitBake Changes
  • 4.13.5 Python and Python 3 Changes
  • 4.13.6 Miscellaneous Changes
• 4.14 Moving to the Yocto Project 2.6 Release
  • 4.14.1 GCC 8.2 is Now Used by Default
  • 4.14.2 Removed Recipes
  • 4.14.3 Packaging Changes
  • 4.14.4 XOrg Protocol dependencies
  • 4.14.5 distutils and distutils3 Now Prevent Fetching Dependencies During the do_configure Task
  • 4.14.6 linux-yocto Configuration Audit Issues Now Correctly Reported
  • 4.14.7 Image/Kernel Artifact Naming Changes
  • 4.14.8 SERIAL_CONSOLE Deprecated
  • 4.14.9 Configure Script Reports Unknown Options as Errors
  • 4.14.10 Override Changes
  • 4.14.11 systemd Configuration is Now Split Into systemd-conf
  • 4.14.12 Automatic Testing Changes
  • 4.14.13 OpenSSL Changes
  • 4.14.14 BitBake Changes
  • 4.14.15 Security Changes
  • 4.14.16 Post Installation Changes
  • 4.14.17 Python 3 Profile-Guided Optimization
  • 4.14.18 Miscellaneous Changes
• 4.15 Moving to the Yocto Project 2.7 Release
  • 4.15.1 BitBake Changes
  • 4.15.2 Eclipse Support Removed
  • 4.15.3 qemu-native Splits the System and User-Mode Parts
  • 4.15.4 The upstream-tracking.inc File Has Been Removed
  • 4.15.5 The DISTRO_FEATURES_LIBC Variable Has Been Removed
  • 4.15.6 License Value Corrections
  • 4.15.7 Packaging Changes
  • 4.15.8 Removed Recipes
  • 4.15.9 Removed Classes
  • 4.15.10 Miscellaneous Changes
• 4.16 Moving to the Yocto Project 3.0 Release
  • 4.16.1 Init System Selection
  • 4.16.2 LSB Support Removed
  • 4.16.3 Removed Recipes
  • 4.16.4 Packaging Changes
  • 4.16.5 CVE Checking
  • 4.16.6 Bitbake Changes
  • 4.16.7 Sanity Checks
  • 4.16.8 Miscellaneous Changes
• 4.17 Moving to the Yocto Project 3.1 Release
  • 4.17.1 Minimum system requirements
  • 4.17.2 mpc8315e-rdb machine removed
  • 4.17.3 Python 2 removed
  • 4.17.4 Reproducible builds now enabled by default
  • 4.17.5 Impact of ptest feature is now more significant
  • 4.17.6 Removed recipes
  • 4.17.7 features_check class replaces distro_features_check
  • 4.17.8 Removed classes
  • 4.17.9 SRC_URI checksum behaviour
  • 4.17.10 npm fetcher changes
  • 4.17.11 Packaging changes
  • 4.17.12 Additional warnings
  • 4.17.13 wic image type now used instead of live by default for x86
  • 4.17.14 Miscellaneous changes
• 4.18 Moving to the Yocto Project 3.2 Release
  • 4.18.1 Minimum system requirements
  • 4.18.2 Removed recipes
  • 4.18.3 Removed classes
  • 4.18.4 pseudo path filtering and mismatch behaviour
  • 4.18.5 MLPREFIX now required for multilib when runtime dependencies conditionally added
  • 4.18.6 packagegroup-core-device-devel no longer included in images built for qemu* machines
  • 4.18.7 DHCP server/client replaced
  • 4.18.8 Packaging changes
  • 4.18.9 Package QA check changes
  • 4.18.10 Globbing no longer supported in file:// entries in SRC_URI
  • 4.18.11 deploy class now cleans DEPLOYDIR before do_deploy
  • 4.18.12 Custom SDK / SDK-style recipes need to include nativesdk-sdk-provides-dummy
  • 4.18.13 ld.so.conf now moved back to main glibc package
  • 4.18.14 Host DRI drivers now used for GL support within runqemu
  • 4.18.15 initramfs images now use a blank suffix
  • 4.18.16 Image artifact name variables now centralised in image-artifact-names class
  • 4.18.17 Miscellaneous changes