lawnchair/GITHUB_CHANGELOG.md

Bubble Tea

Bubble Tea [QPR1]

🏗️ Development 5 Release 1

Build: BD4.2712 (latest)

Compatibility list:

🏗️ Crash	🥞 Fully supported
Android 8.0	Android 10* (Limited)
Android 8.1	Android 11* (Limited)
Android 9	Android 12.0
	Android 12.1
	Android 13
	Android 14
	Android 15
	Android 16
	Android 16.1

Fixes

• [Launcher] Limited Android 11 support
• [Launcher] Limited Android 10 support

🥞 Development 4 Release 1 (Snapshot 10)

Bug fixes only You may see duplicated changelogs in this release because of merged diverged timeline.

In this release, the initial 16-dev branch has now merged to QPR1 branch, meaning you'll have tons of improvements from upstream Launcher3 source.

Build: BD4.2412 (latest), BD4.2112, BD4.2012, BD4.2311, BS10.2111, BS10.2011

Compatibility list:

🏗️ Crash	🥞 Fully supported
Android 8.1	Android 12.0
Android 9	Android 12.1
Android 10	Android 13
Android 11	Android 14
	Android 15
	Android 16

Features

• [Launcher] Move to Google Sans Flex font (TODO)*
• [Lawnchair] Material 3 Expressive Settings (Phase 2, TODO)* * [Lawnchair] Better At-a-Glance perceptive wallpaper colour luminance detection* * Big word that means Lawnchair will take system default hint bright/dark theme and fallback to luminosity detection for bright/dark mode detection in At a Glance.* * [Launcher] Enable Material Expressive Folder Expansion animation flag*
  • Disabled due to rendering bugs*
• [Launcher/Font] Variable font for Launcher3 (????????)*
• [Launcher/Popup] Dynamically get app widget popup icon*
• [Launcher] Foldable support (actually real)*
• [Launcher] Google Sans Flex font uses almost the exact same configuration as Pixel*
• [Launcher] Enable bulk loading by default*
• [Launcher] Tablet support (ish)*

Fixes

• [Launcher] Fix a lot of internal basic functionality*
• [Lawnchair] Re-added some Lawnchair-specific code*
• [Launcher] Fix workspace navigation*
• [Launcher] Fix allapps navigation*
• [Launcher] Fix folder navigation*
• [Launcher] Support Android 12.0/12.1/13/14/15*
• [Lawnchair/Smartspace] At-a-Glance can't launch activity due to background startup restrictions on Android 14 and above*
• [Launcher] Use Lawnchair theming colour for allapps*
• [WM-Shell] Fix conflict with prebuilts aidl, make Release build work again*
• [Launcher/Desktop] Correct deviceHasLargeScreen check for Baklava*
• [Lawnchair/Search] Make search layout changes work*
• [Lawnchair/Smartspace] Allow disabling the smartspace feature*
• [Launcher3] Widget preview crash for no reason at all on compatible Android version*
• [Launcher3] Correct fallback (blur unsupported) allapps colour

Snapshot 9 (Development 4 Release 1)

This snapshot marks the first time Bubble Tea QPR1 is able to assemble the APK without errors, all that's left is bug bash testing. Limited visibility closed testing is available.

Build: BS9.2011

This is a developer-focused change log:

• Re-added searchuilib
• SearchUiLib updated to latest commits before being private
• Exclude disabled variant of Compose launcher3 features
• Fix all errors in Lawnchair side

Snapshot 8 (Development 4 Release 1)

Build: BS8.1811

This snapshot marks the first time Bubble Tea QPR1 is able to compile ALL of the Launcher3 code without errors, that leaves Lawnchair code as the remaining task before successfully compiling Bubble Tea QPR1

This is a developer-focused change log:

• Migrate some functions to new changes
• WM-Shell (and WM-Shell Shared) updated to Android 16-0.0_r3 (Android 16.0.0 Release 3)
• Add Mechanics (SystemUI Platform Library)
• Some unresolved reference in Lawnchair code

Snapshot 7 (Development 4 Release 1)

Build: BS7.1711

This snapshot marks the first time Bubble Tea QPR1 is able to pass KSP build stage without any hiccups, the next 1 or 2 snapshots will be focusing on compilation stage, which should be the last stage before we can get started on pE Development 4.

This is a developer-focused change log:

• Codebase updated to Android 16-0.0_r3 (Android 16.0.0 Release 3)
• Prebuilt updated to Android 16-0.0_r3 (Android 16.0.0 Release 3)
• Platform libs updated to Android 16-0.0_r3 (Android 16.0.0 Release 3)
  • Move ViewCapture to platform lib
  • Add Displaylib
• Flags updated to Android 16-0.0_r3 (Android 16.0.0 Release 3)
• Pull concurrent, dagger (the launcher3) as module
  • TODO? We might need to migrate it to build source like compose instead
• Lots of prebuilt documentations update
• Add compose as part of launcher3 build source
  • Removed test because I hate configuration gradle
  • cc: @validcube fix me, cc: too bad

Bubble Tea [r2]

Lawnchair 16 pE Development 3 is here! Contributors are encouraged to target this branch instead of older (i.e., Lawnchair 15-dev).

Development 3 Release 3

Build: BD3.2012 (latest), BD3.1312, BD3.0812, BD3.0712

Compatibility list:

🏗️ Crash	🥞 Fully supported
Android 8.0	Android 12.0
Android 8.1	Android 12.1
Android 9	Android 13
Android 10	Android 14
	Android 15
	Android 16

Features

• [Lawnchair] Features from Lawnchair 15-dev 07122025
• [Launcher] Google Sans Flex font uses almost the exact same configuration as Pixel
• [Launcher] Enable bulk loading by default
• [Launcher] Tablet support (ish)
• [Launcher] Refreshed Material 3 Expressive
• [Lawnchair] Refreshed Material 3 Expressive
• [Launcher] Foldable support (ish)
• [Lawnchair] Warn when nightly updater is updating to next major version
• [Lawnchair/Smartspace] Add Lunar calendar option
• [Lawnchair/Smartspace] Promote smartspace calendar to stable
• [Lawnchair] Expressive redesign Phase 2
• [Lawnchair] GestureNavContract toggle in experimental features
• [Lawnchair] Set GestureNavContract on by default on Google device
• [Lawnchair] Set GestureNavContract on by default on Nothing device
• [Lawnchair] Don't show warning on known compatible device
• [Lawnchair] Swipe to dismiss announcement perform haptic on successful dismiss
• [Lawnchair] Remove Inter v3 fonts from Lawnchair entirely (to reduce apk size)
• [Lawnchair] Add Google Sans variable font as fallback to Google Sans Flex (to support the most of the world languages, yes that increases sizes)
• [Launcher] Google Sans variable normal style
• [Lawnchair] Improve Google device compatibility check
• [Lawnchair] Improve Samsung device compatibility check

Fixes

• [Launcher3] Widget preview crash for no reason at all on compatible Android version
• [Launcher] Hotseat Google provider failed to open due to Android pending intent restrictions on Android 14/15/16/16.1
• [Launcher3/DeviceProfile] Positioning of first folder during Lawnchair setup
• [Lawnchair/AllApps] Reimplement app drawer opacity
• [Lawnchair/Recents] Reimplement recents overview opacity
• [Lawnchair/Preference] Misaligned slider and text preference
• [Lawnchair/Smartspace] Allow disabling the smartspace feature
• [Lawnchair] Settings now correctly animate expand/shrink items
• [Lawnchair] Correctly display warning in experimental features (race conditions)
• [Project] Support for Android Studio 2025.2.3 Canary 5 (Bump to AGP 9.0.0-beta05)
• [Lawnchair] Offer a toggle to disable/enable suggestions instead of linking it to ASI if the device is not Google Pixel

🥞 Development 3 Release 2

Build: BD3.2211

Compatibility list:

🏗️ Crash	💫 Limited features	🥞 Fully supported
Android 8.1		Android 12.0
Android 9		Android 12.1
Android 10		Android 13
Android 11		Android 14
		Android 15
		Android 16

Features

• [Lawnchair] Updated screenshots compressions and fastlane screenshot
• [Lawnchair] Features from Lawnchair 15-dev
• [Launcher3] Widget preview crash for no reason at all on compatible Android version

Fixes

• [Lawnchair] Conflict from Lawnchair 15-dev

Development 3 Release 1

Build: BD3.1711

The biggest change log ever, this marked the end of Bubble Tea [r2] branch as future development switched to Bubble Tea [QPR1]. See you at Snapshot 7 or Development 4!

(Again) Originally going to launch D3 if most of the issue on tracker have been resolved, but hit a stability milestone instead.

This release includes 4 new features, and 33 bug fixes, Reimplemented some of Lawnchair features, better sizing of home screen, updated README.md screenshot and the inclusion of Bubble Tea project into the official Lawnchair repository as 16-dev!

This release have been tested with:

• ☁️ Pixel 6 (Android 12.0)
• 📱 Nothing (3a)-series (Android 15, Android 16.0)
• 📱 Vivo Y21 (Android 12.0)
• 📱 HTC Wildfire E3 lite (Android 12.0)
• Many more! Unfortunately I only count build from pE Open testing!

Compatibility list:

🏗️ Crash	💫 Limited features	🥞 Fully supported
Android 8.1		Android 12.0
Android 9		Android 12.1
Android 10		Android 13
Android 11		Android 14
		Android 15
		Android 16

Note

QuickSwitch compatibility have not been tested at any time during the development of Bubble Tea!

Features

• [Lawnchair] Complex Clover icon shape
• [Lawnchair] Very Sunny icon shape
• [Lawnchair/Font] Update Google Fonts listing to 25102025
• [Lawnchair/Gesture] Allow Open Quick Settings*

Fixes

• Disable OEM override on launcher settings, (reimplement ENABLE_AUTO_INSTALLS_LAYOUT | c51b2a2218)
• [Lawnchair/Iconloaderlib] Reimplement custom app name
• [Lawnchair] Reimplement Launcher3 debug page
• [Lawnchair] Reimplement Caddy and App drawer folder
• [Lawnchair] Reimplement Hotseat toggle
• [Lawnchair] Reimplement Favorite application label
• [Lawnchair] Hotseat positioning with favorite icon label enabled placed the same even if label is disabled
• [Lawnchair] Hotseat background now have a reasonably sized margin compared to D2
• [Lawnchair] Qsb sizing now correctly estimate the width based on width of the app/widget layout or DeviceProfile on device with inlined Qsb
• [Lawnchair] Reimplement Allapps opacity configuration
• [DeviceProfile] Crash from createWindowContext on less than Android 12.0
• [QuickstepLauncher] Ignore trying to set SystemUiProxy icon sizes on less than Android 12.1
• [Lawnchair/BlankActivity] Apply Material 3 Expressive button animations
• [Launcher] Disable add widget button if home screen is locked
• [Lawnchair/Iconloaderlib] Crash when trying to set null monochrome icon on less than Android 12.1
• [SystemUI/Unfold] Crash when getting configuration for foldable-specific resources
• [Lawnchair/Iconloaderlib] Don't parse monochrome drawable in Android 12.1 or less
• [Launcher3/AllApps] Allow theming of Expressive allapps
• [Lawnchair] Lawnchair can now be compiled in release mode
  • [Lawnchair] Fix crashes with WM-Shell
• [Lawnchair] Bottom sheet blur will only trigger when your device supported blur*
• [Lawnchair/Lazy] Corner radii of lazy component now matched radius of non-lazy*
• [Lawnchair/Debug] Cleanup the debug menu*
• [Lawnchair/Docs] Warn off danger using 16-dev branch*
• [Launcher3] Crash with predictive back on some device using Android 13/14
• [Launcher3] WindowInsets crash in Android 11
• [Launcher3] Widgets crash on some device using Android 12
• [Launcher3/PrivateSpace] Use custom icons of Private Space lock*
• [Launcher3/Iconloaderlib] App badges for work profile*
• [Lawnchair] Update spacing for dock search settings*
• [Launcher3] Quickstep dispatcher crash on Android 13
• [Launcher3] Crash due to missing resources for Android 8.0
• [Lawnchair/Docs] Update screenshot to 16-dev

Development 2

Originally going to launch D2 if most of the comestic bug fixes have been resolved, but hit a stability milestone instead.

This release includes 15 new features, and 20 bug fixes, Lawnchair settings now takes shape of initial material 3 expressive redesign, (but by no mean finish!) launcher should now render icons better than D1 milestone, with auto-adaptive icons feature reimplemented.

This release have been tested with:

• ☁️ Pixel 6 (Android 12.0) - Build: Ad-hoc
• ☁️ Pixel 6a (Android 12.1) - Build: Ad-hoc
• ☁️ Pixel 7 (Android 13) - Build: Ad-hoc
• ☁️ Pixel 9 (Android 15, Android 16.0) - Build: Ad-hoc
• ☁️ Pixel 9 Pro Fold (Android 14, Android 15) - Build: Ad-hoc
• ☁️ Vivo V40 (Android 15) - Build: Ad-hoc
• ☁️ Xiaomi MIX (Android 15) - Build: Ad-hoc
• 📱 Nothing (3a)-series (Android 15) - Build: pE-15102025
• 📱 Pixel 9 Pro XL (Android 16.0 QPR2 Beta 2) - Build: pE-02102025
• 📱 BLU View 5 Pro (Android 14) - Build: pE-02102025
• 📱🔥 Vivo Y21 (Android 12.0) - Build: pE-08102025

Note

QuickSwitch compatibility have not been tested at any time during the development of Bubble Tea!

Compatibility list:

🏗️ Crash	💫 Limited features	🥞 Fully supported
Android 8.1	Android 12.0	Android 12.1
Android 9		Android 13
Android 10		Android 14
Android 11		Android 15
		Android 16

Features

• Enable All Apps Blur Flags on Phone (oops, forgot about the allAppsSheetForHandheld flag)
• Make Safe Mode check more reliable
• Smartspace Battery now reports battery charging status of Fast (more than 90% of 20 W) and Slow (less than 90% of 5 W) charging
• Show pseudonym version to Settings
• Resizing workspace calculate items position more accurately
• Update Lawnchair default grid size to 4×7 (or 4×6 with smartspace widget)
• Reimplement Hotseat background customisation
• Make haptic on a locked workspace use Google MSDL vibration
• Make Launcher3 colour more accurate to upstream Android 16
• ProvideComposeSheetHandler now have expressive blur
• Lawnchair Settings now uses Material 3 Expressive
• Animate keyboard on/off state on app drawer search (Try enabling automatically show keyboard in app drawer settings and swipe up and down or directly tap “Apps list” in popup menu) -> (Backport not possible)
• Add LeakCanary check to all debug variant of the application
• [DEBUG] Launcher3 feature status diagnostic check in debug menu
• [Documentation] Add more visibility into both app certificate and SLSA verification for app authenticity check VERIFICATION.md
• [Documentation] Initial drafting of Improve documentation v6 (pave-path)
• [Launcher] Widget animations during resize
• [Iconloaderlib] Enable second hand for the clock app

Fixes

• Fix unable to access preview for icon style
• Popup's Arrow Theme now has the correct theme
• Widget should open normally after a workaround (C7evQZDJ)
• Fix (1) Search bar and Dock, (2) Folders and App Drawer settings didn't open due to init problems
• Lawnchair should hopefully remember what grid they should be using
• Most if not all of Lawnchair settings should be usable without crashes
• Correct Baseline Profile from old market to play variant, and now should calculate profile for nightly
• Fix Private Space crash when Lawnchair is set as Launcher due to flags only available on A16
• Fix crash on a device with strict export receiver requirements on A14
• Interactable widget crashing due to App Transition Manager being null (C7evQZDJ)
• Icon not responding to mouse cursor -> (Backported to Lawnchair 15)
• Rare NoSuchMethodError crash on IMS canImeRenderGesturalNavButtons
• [Lawnchair] Reimplement Bulk icons toggle
• SettingsCache crashing with SecurityException with unreadable keys (@hide) in Android 12 and newer (assume false)
• Assume flags enableMovingContentIntoPrivateSpace is false when ClassNotFoundException on Android 16 devices
• Rare NoSuchMethodError crash on SurfaceControl setEarlyWakeupStart and setEarlyWakeupEnd
• Properly align built-in smartspace in workspace
• Use WM Proxy from Lawnchair instead of System, fix Android 8.1/9/10/11/12.0/12.1 regarding SE, NSME like SystemBarUtils -> (dWkyIGw9), (reworked CllOXHJv)
  • LawnchairWindowManagerProxy have been migrated to Dagger
  • SystemWindowManagerProxy have been left unused
• [Lawnchair/Iconloaderlib] Update CustomAdaptiveIconDrawable to latest AOSP 13
• [Iconloaderlib] Reset most of the changes to favour more AOSP 16_r02 code then Lawnchair (need rewrite)
  • fix icon loaded in monochrome and always monochrome when it is not supposed to
  • fix notification dots being twice the size with notification count
• [Lawnchair/Iconloaderlib] Reimplement Lawnchair Iconloaderlib (adaptive icons, monochrome, regular icon)

Known Bugs

• Preview can't show device wallpaper -> (lIxkAYGg)
• IDP Preview doesn't refresh on settings change -> workaround is to hit apply and re-open the preview -> (ZbLX3438)
• Workspace theme doesn't refresh until restart -> (ZbLX3438) -> Fixed as part of (31lLEflf, 1MevNrzp)
• Lawnchair Colour can't handle restart causing default colour to be used instead -> Fixed? -> Properly fixed as part of (31lLEflf, 1MevNrzp)
• (Investigating) Work profile switch on widget selector may have reverted to Lawnchair 15 style
• Full lists: https://trello.com/b/8IdvO81K/pe-lawnchair

Development 1

First development milestone! Basic launcher functionality should be stable enough.

• Make Lawnchair Launcher launchable in Android 12.1, 13, 14, 15, 16
• Remove two deprecated features (Use Material U Popup, and Use dot pagination)
• Add pseudonym version in debug settings
• Adapt Lawnchair code to Launcher3 16
• Make basic features of Launcher work (App Drawer, Home Screen, Search, Folders, Widgets)
• Enable Material Expressive Flags (Try swiping through launcher page)
• Enable All Apps Blur Flags (Try opening All Apps on supported devices)
• Enable MSDL Haptics Feedback Flags (Try gliding widget or icons across the homescreen)
• Make Predictive Back Gesture work on Android 13, 14, 15, 16 (Try swiping left or right on gesture-based navigational)
• Programmatically set Safe Mode status

Known Bugs

• App Icon may sometimes render with less than 0 in height/width causing blank icon to be rendered and crashing ISE on customising icons -> (31lLEflf)
• Any Lawnchair settings using IDP will crash the launcher -> Fixed in Lawnchair 16 pE Development 2
• Icon pack isn't usable -> (DXo69Qzd)
• Dynamic icons will not be themed by launcher
• Full lists: https://trello.com/b/8IdvO81K/pe-lawnchair

Snapshot 6

This is a developer-focused change log:

This snapshot marks the first time Lawnchair 16 is able to compile and build an APK!

• Fix all issues with Java files in both lawn and src
• Make Lawnchair compilable (with instant crash)
• Move to KSP for Dagger code generation

Snapshot 5

This is a developer-focused change log:

This snapshot now able to compile all sources (Kotlin files only)

• Fix MORE MORE MORE lawn issues
• Use Gradle Version Catalog for consistent dependency version across all modules (Full implementation @ LawnchairLauncher/Lawnchair#5753)
• Magically fix ASM Instrumentation issues (I didn't do anything, it just works now)
• Fix ALL the issues in kotlin stage (compileLawnWithQuickstepNightlyDebugKotlin)
• Reintroduce some features from Lawnchair
• Add compatibility checks and workarounds for them
• Fix most issues with Java files in both lawn and src

Snapshot 4

This is a developer-focused change log:

This snapshot marks the first time Lawnchair 16 is able to compile all Launcher3 sources!

• Add MSDLLib to platform_frameworks_libs_systemui
• Add contextualeducationlib to platform_frameworks_libs_systemui
• Fix issues in both lawn and src modules
• Fix AIDL sources
• Resolve Lawnchair/LC-TODO lists
• Merge wmshell.shared res with res from wmshell
• Consistent build reproducibility by specifying dependencies in build.gradle
• Some ASM Instrumentation issues (and re-add some…)
• Update documentations

Snapshot 3

This is a developer-focused change log:

Not a lot of errors left to go!

• Finish correctly implementing all Dagger functions (?)
• Merge Lawnchair 15 Beta 1 into Bubble Tea
  • Support for 16-kb page size devices
• Repository rebased and dropped commit
  • Switch back from turbine-combined variant to javac variant for prebuilt SystemUI-core-16 because issues with LFS
    • MORE MORE fixes regarding turbine-combined to javac
• Publish platform_frameworks_libs_systemui to pe 16-dev branch
• ATLEAST check to almost every launcher3 source file
• Utils module (stripped)
• Fix Dagger duplicated classes (because of Dagger dependency ksp/kapt mixing)
• Build reproducibility improvements by specifying dependencies in build.gradle files
• Fix some of the issues in both lawn and src modules

Snapshot 2

This is a developer-focused change log:

This snapshot milestone marked the first time Lawnchair now able to compile all supplementary modules, src + lawn will be in Snapshot 5 or Development 1 milestone.

• Merge flags
• Fix some issues with launcher3 sources.
• A temporary workaround with framworks.jar not adding in anim module.
• Shared not having access to animationlib.
• Switch from javac variant to turbine-combined variant for prebuilt SystemUI-core-16.

From Initial snapshot 0 and 1

This is a developer-focused change log:

• Prebuilt updated to Android 16-0.0_r2 (Android 16.0.0 Release 2)
• Submodule have also been refreshed to A16r2
• Baklava Compatlib (QuickSwitch compatibility not guaranteed)
• Refreshed internal documentation like prebuilt, systemUI