Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.
Desktop windowing features
Stay organized with collections
Save and categorize content based on your preferences.
Android 16 introduced two desktop windowing features: customizable header
insets and app instance management. This page describes the testing
scenarios to verify browser compatibility. OEMs must verify that the feature
implementation works as intended.
The following test cases verify browser compatibility with customizable header
insets:
- UI interactivity: Verify that the browser's caption bar UI remains fully
interactive across all windowing configurations (freeform, split screen, and
fullscreen).
- System icon clearance: Confirm that the browser UI doesn't draw under
system icons.
- Foreground color application: Verify that the correct foreground colors
are applied to system icons on the app header based on the browser's theme.
This is particularly important when the browser's theme differs from the
system theme.
- Window dragging: Validate that a freeform window can be dragged by
long-pressing anywhere on an empty area of the tab strip.
- Tab visibility on resize: Test that tabs are shown or hidden based on
the window's width to maintain optimal usability.
Test cases for app instance management with draggable gesture behavior
The following test cases verify browser compatibility with app instance
management:
- New window creation: Confirm that dragging a tab from the tab strip to
an empty area creates a new browser window containing that tab.
- No new window for the last tab (single instance): If only one browser
instance is open, verify that dragging the last tab in that window doesn't
create a new window.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[null,null,["Last updated 2025-08-29 UTC."],[],[],null,["# Desktop windowing features\n\nAndroid 16 introduced two desktop windowing features: [customizable header\ninsets](https://developer.android.com/develop/ui/compose/layouts/adaptive/support-desktop-windowing#customizable_header_insets) and [app instance management](https://developer.android.com/develop/ui/compose/layouts/adaptive/support-desktop-windowing#manage_app_instances). This page describes the testing\nscenarios to verify browser compatibility. OEMs must verify that the feature\nimplementation works as intended.\n\nTest cases for customizable header insets\n-----------------------------------------\n\nThe following test cases verify browser compatibility with customizable header\ninsets:\n\n- **UI interactivity:** Verify that the browser's caption bar UI remains fully interactive across all windowing configurations (freeform, split screen, and fullscreen).\n- **System icon clearance:** Confirm that the browser UI doesn't draw under system icons.\n- **Foreground color application:** Verify that the correct foreground colors are applied to system icons on the app header based on the browser's theme. This is particularly important when the browser's theme differs from the system theme.\n- **Window dragging:** Validate that a freeform window can be dragged by long-pressing anywhere on an empty area of the tab strip.\n- **Tab visibility on resize:** Test that tabs are shown or hidden based on the window's width to maintain optimal usability.\n\nTest cases for app instance management with draggable gesture behavior\n----------------------------------------------------------------------\n\nThe following test cases verify browser compatibility with app instance\nmanagement:\n\n- **New window creation:** Confirm that dragging a tab from the tab strip to an empty area creates a new browser window containing that tab.\n- **No new window for the last tab (single instance):** If only one browser instance is open, verify that dragging the last tab in that window doesn't create a new window."]]
