\n This blog post explains how to switch between Window Manager and the Display Mask API, tips for migrating from the previous version, and discusses the other new features of this release.\n<\/p>\n
Jetpack Window Manager core <\/h2>\n
\n Older versions of the dual-screen libraries used the Microsoft display-mask API<\/a> to provide dual-screen awareness. With this release we now provide the option to use the Jetpack Window Manager<\/a> as the device interface, which will work with foldable devices beyond the Surface Duo.\n<\/p>\n \n Dual-screen device support is encapsulated in the ScreenManager<\/strong> component \u2013 use this gradle line to add to your app:\n<\/p>\n \n The rest of the modules all behave identically, regardless of which ScreenManager<\/strong> has been used, including:\n<\/p>\n \n The underlying Jetpack Window Manager is currently in alpha<\/a>. Being able to easily swap the implementation allows you to test both, and release with the version you feel most comfortable with. Over time, the Jetpack Window Manager implementation will be preferred as it provides support for other foldable devices, helping developers get the best return from their investments in dual-screen enhancements.\n<\/p>\n \n Existing apps built on the Display Mask API<\/a> can continue to use it. If you would like to try out the dual-screen libraries in conjunction with the Display Mask API, include the correct ScreenManager<\/strong> component with this gradle line:\n<\/p>\n \n When you add the other modules (BottomNavigation, etc), they will all work the same regardless of which ScreenManager<\/strong> is included. \n<\/p>\n \n To align with the lifecycle supported by Window Manager, the library code no longer accesses dual-screen properties in the onCreate<\/strong> method. Instead, the details are accessed after the activity onAttachToWindow<\/strong> callback. \n<\/p>\n \n Existing apps that used the display-mask API in the onCreate<\/strong> method (to lay out views, for example) should move that code later in the activity lifecycle. The new ScreenManager<\/strong> implementation compensates for this by refactoring the libraries with an event-driven architecture. This means that in onCreate<\/strong> you can add a listener for screen mode change events. \n<\/p>\n \n When you update to this version of the libraries, you should move any dual-screen specific code that was in onCreate <\/strong>to a listener so that your code can work with both core implementations.\n<\/p>\n \n Starting with this release we are publishing to the JCenter repository. JCenter is a default repository in Android Studio which means you\u2019ll no longer need to add our maven repository feed to your top-level build.gradle<\/strong> file when you include our libraries in your app.\n<\/p>\n \n Just add the implementation lines as shown above directly to your module-level build.gradle<\/strong> file (see the docs<\/a> for more info, or explore the package on bintray.com<\/a>).\n<\/p>\n \n \n There are two new layout manager classes in RecyclerView<\/strong> library: \n<\/p>\n \n This makes RecyclerView<\/strong> automatically change its behavior depending on screen mode. \n<\/p>\n \n The Kotlin samples<\/a> and app samples<\/a> repos have been updated to use Jetpack Window Manager \u2013 visit GitHub to get the latest versions.\n<\/p>\n \n The source code for the SDK<\/a> is available on GitHub if you\u2019re curious about the implementation or wish to contribute. Visit the documentation<\/a> for more information on all the features in the dual-screen library for Kotlin and Java developers.\n<\/p>\n \n Thanks to the team \u2013 Bianca Miron<\/a>, Cesar Valiente<\/a>, Cristian Verdes<\/a>, and Sorin Albu<\/a> \u2013 for their work on this release.\n<\/p>\n \n We\u2019d love to hear from you and how you plan to incorporate dual-screen enhancements into your apps. Please reach to out using the\u00a0feedback forum<\/a>\u00a0or message us @surfaceduodev<\/a> on Twitter.<\/p>\n","protected":false},"excerpt":{"rendered":" Hello Kotlin and Java developers, We\u2019re excited to announce version 1.0.0-beta1 of our dual-screen libraries for Microsoft Surface Duo, which integrates Google\u2019s Jetpack Window Manager support. We\u2019ve made the underlying device interface swappable, so you can continue to use the existing Display Mask API as long as you wish and migrate to Window Manager when […]<\/p>\n","protected":false},"author":47750,"featured_media":1117,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[31,705,706,473,45],"class_list":["post-1112","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-surface-duo-sdk","tag-dual-screen-development","tag-java","tag-jetpack-window-manager","tag-kotlin","tag-surface-duo-sdk"],"acf":[],"blog_post_summary":" Hello Kotlin and Java developers, We\u2019re excited to announce version 1.0.0-beta1 of our dual-screen libraries for Microsoft Surface Duo, which integrates Google\u2019s Jetpack Window Manager support. We\u2019ve made the underlying device interface swappable, so you can continue to use the existing Display Mask API as long as you wish and migrate to Window Manager when […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/posts\/1112","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/users\/47750"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/comments?post=1112"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/posts\/1112\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/media\/1117"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/media?parent=1112"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/categories?post=1112"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/tags?post=1112"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}implementation \"com.microsoft.device.dualscreen:screenmanager-windowmanager:1.0.0-beta1\"<\/pre>\n
\n
Display Mask core<\/h2>\n
implementation \"com.microsoft.device.dualscreen:screenmanager-displaymask:1.0.0-beta1\"<\/pre>\n
Migrating from older releases<\/h2>\n
Libraries available in JCenter<\/h2>\n
![](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/12\/word-image.jpeg\")
<\/a>\n<\/p>\nNew RecyclerView layouts<\/h2>\n
\n
Updated samples<\/h2>\n
Feedback and resources<\/h2>\n