\n
![](\"https:\/\/blogger.googleusercontent.com\/img\/b\/R29vZ2xl\/AVvXsEhvmObDTm_UvKKZP8bDM_YVpknfPh2MBo1pZun6Vc_0CTOsoxvFAq0O_tIa33owHNckOXqKEGGf35C7PccmUFU9gA9VX7djih13zWISVNwdqAHY7waJ7tcWoZJUSuCwSnrLCmhQzNCr21e61IJ_8PLUzj6eKApPrxmK-cwMHrYp-iCbQ6XPyiLxIKvRZPU\/s1600\/Jetpack%20Adaptive%20Compose%20Metadata.png\")
<\/p>\nPosted by Xiaodao Wu – Developer Relations Engineer<\/em><\/p>\n Jetpack WindowManager keeps getting better. WindowManager gives you tools to build adaptive apps that work seamlessly across all kinds of large screen devices. Version 1.4, which is stable now, introduces new features that make multi-window experiences even more powerful and flexible. While Jetpack Compose is still the best way to create app layouts for different screen sizes, 1.4 makes some big improvements to activity embedding, including activity stack spinning, pane expansion, and dialog full-screen dim. Multi-activity apps can easily take advantage of all these great features.<\/p>\n WindowManager 1.4 introduces a range of enhancements. Here are some of the highlights.<\/p>\n We\u2019ve updated the WindowSizeClass<\/a><\/span> API to support custom values. We changed the API shape to make it easy and extensible to support custom values and add new values in the future. The high level changes are as follows:<\/p>\n Here\u2019s a migration example:<\/p>\n <\/p>\n Some things to note in the new API:<\/p>\n Activity stack pinning<\/b> provides a way to keep an activity stack always on screen, no matter what else is happening in your app. This new feature lets you pin an activity stack to a specific window, so the top activity stays visible even when the user navigates to other parts of the app in a different window. This is perfect for things like live chats or video players that you want to keep on screen while users explore other content.<\/p>\n <\/p>\n The new pane expansion<\/a><\/b> feature, also known as interactive divider<\/b>, lets you create a visual separation between two activities in split-screen mode. You can make the pane divider draggable so users can resize the panes \u2013 and the activities in the panes \u2013 on the fly. This gives users control over how they want to view the app\u2019s content.<\/p>\n <\/p>\n WindowManager 1.4 gives you more control over how dialogs dim the background. With dialog full-screen dim<\/b>, you can choose to dim just the container where the dialog appears or the entire task window for a unified UI experience. The entire app window dims by default when a dialog opens (see EmbeddingConfiguration.DimAreaBehavior.ON_TASK<\/a><\/span>).To dim only the container of the activity that opened the dialog, use EmbeddingConfiguration.DimAreaBehavior.ON_ACTIVITY_STACK<\/a><\/span>. This gives you more flexibility in designing dialogs and makes for a smoother, more coherent user experience. Temu is among the first developers to integrate this feature, the full-screen dialog dim has reduced screen invalid touches by about 5%<\/b>.<\/p>\n![](\"https:\/\/blogger.googleusercontent.com\/img\/b\/R29vZ2xl\/AVvXsEiq-xjyTG_ks5AfowEaHg8NFwpTVt0EqH59N_7RExbYOHp8WESDEmFbRFPB7kc3_tP0B7XGARTbDvX6woNwZgRtwX2xH8xJI0uq4w7T3b2JFOjzB3qfU6EZC-MpYSZ537orOmLoI5VY69Fc-h9XMiJ3MRe7rk66yTMcEdDxSWlrOY71cQ04-kxG-kFalms\/s1600\/Jetpack%20Adaptive%20Compose%20%281%29.png\")
<\/a><\/p>\nWindowSizeClass<\/span><\/h2>\n
\n
\n
\n
\n
\/\/ old <\/span>\n\nval<\/span> sizeClass = WindowSizeClass.compute(widthDp, heightDp)\nwhen<\/span> (sizeClass.widthSizeClass) {\n COMPACT -> doCompact()\n MEDIUM -> doMedium()\n EXPANDED -> doExpanded()\n else<\/span> -> doDefault()\n}\n\n\/\/ new<\/span>\nval<\/span> sizeClass = WindowSizeClass.BREAKPOINTS_V1\n .computeWindowSizeClass(widthDp, heightDp)\n\nwhen<\/span> {\n sizeClass.isWidthAtLeastBreakpoint(WIDTH_DP_EXPANDED_LOWER_BOUND) -> {\n doExpanded()\n }\n sizeClass.isWidthAtLeastBreakpoint(WIDTH_DP_MEDIUM_LOWER_BOUND) -> {\n doMedium()\n }\n else<\/span> -> {\n doCompact()\n }\n}\n<\/pre>\n<\/div>\n\n
\n
Activity embedding<\/span><\/h2>\n
Activity stack pinning<\/b><\/span><\/h3>\n
private<\/span> fun<\/span> pinActivityStackExample<\/span>(taskId: Int) {\n val<\/span> splitAttributes: SplitAttributes = SplitAttributes.Builder()\n .setSplitType(SplitAttributes.SplitType.ratio(0.66f<\/span>))\n .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)\n .build()\n\n val<\/span> pinSplitRule = SplitPinRule.Builder()\n .setDefaultSplitAttributes(splitAttributes)\n .build()\n\n SplitController.getInstance(applicationContext).pinTopActivityStack(taskId, pinSplitRule)\n}\n<\/pre>\n<\/div>\nPane expansion<\/b><\/span><\/h3>\n
val<\/span> splitAttributesBuilder: SplitAttributes.Builder = SplitAttributes.Builder()\n .setSplitType(SplitAttributes.SplitType.ratio(0.33f<\/span>))\n .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)\n\nif<\/span> (WindowSdkExtensions.getInstance().extensionVersion >= 6<\/span>) {\n splitAttributesBuilder.setDividerAttributes(\n DividerAttributes.DraggableDividerAttributes.Builder()\n .setColor(getColor(context, R.color.divider_color))\n .setWidthDp(4<\/span>)\n .setDragRange(\n DividerAttributes.DragRange.DRAG_RANGE_SYSTEM_DEFAULT)\n .build()\n )\n}\nval<\/span> splitAttributes: SplitAttributes = splitAttributesBuilder.build()\n<\/pre>\n<\/div>\nDialog full-screen dim<\/b><\/span><\/h3>\n
<\/div>\nEnhanced posture support<\/span><\/h2>\n