![](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/03\/word-image.png\")
<\/p>\n
Figure 1: Steps to bring your app to Microsoft Surface Duo<\/span><\/p>\n Last week, Hakon from our awesome PM team provided more detail on step 1 and how to test your app<\/a>.<\/p>\n This week, I want to share some details on Step 2 \u2013 things you can do TODAY to get your app working better on a dual screen device.<\/p>\n The items listed below are some of the Android features you can add to light up your app on a dual screen device. None of these are specific to Surface Duo, but your app will benefit from them on other form factors such as foldables as well:<\/p>\n Follow the guidance below and take a look at our Java<\/a> and Kotlin samples<\/a> in GitHub.<\/p>\n App Resizing and Orientation<\/strong><\/p>\n Your app should not lock to a specific size and layout and should consider many form factors and aspect ratios. While Surface Duo uses standard aspect ratios, be sure to follow the Google Android guidance on supporting Multi Windows<\/a>.<\/p>\n The Surface Duo will be used in various postures, so allow your user to utilize those and don\u2019t lock the app to a specific orientation or layout.<\/p>\n Figure 2: Surface Duo Device Postures<\/span><\/p>\n Drag and Drop <\/strong><\/p>\n Supporting drag and drop is very simple.<\/p>\n You can support drag and drop within regions in the app, or support dragging content out from your app to another app, or support dropping dragged content from another app into your app.<\/p>\n Our Drag and Drop sample below, can help with your code snippet<\/p>\n Figure 3: Drag and Drop sample on the left screen<\/span><\/p>\n In order to support drag and drop, make sure you follow the Google Android Drag-and-Drop guidance<\/a>.<\/p>\n In particular, make sure to add these to your code:<\/p>\n Launch Intents in the adjacent screen<\/strong><\/p>\n Many Android apps use intents to launch activities in their flows.<\/p>\n A small trick you can apply with just a few lines of code is to utilize both screens and add value to your existing apps starting today.<\/p>\n An example I like to use is a messaging app that supports group chats with a threaded view and a reply.<\/p>\n Figure 4: Group chat sample app<\/span><\/p>\n Typically, when a user wants to write a reply to the group chat, the app is architected in way that it will launch a new Reply activity.<\/p>\n Starting that activity will take over portions of the screen or even the whole screen, resulting in users losing their flow and the context of all other replies in the group chat.<\/p>\n Your users will often bounce back and forth between the threaded view and the reply.<\/p>\n However, with a few easy steps, you can launch the reply intent in the adjacent screen and keep the user in their flow.<\/p>\n Let\u2019s see this in the code:<\/p>\n When I add the below two flags to the intent parameters and start the activity, it will now utilize the adjacent screen.<\/p>\n <\/p>\n The cool thing here is that it will only do it if the adjacent screen is free. If you have another app running there, it will launch the activity on the same screen. It is that easy; just two lines of code.<\/p>\n Multi Instance:<\/strong><\/p>\n Does it make sense for your app to support running multiple instances of activities?<\/p>\n For example, comparing two web pages side-by-side in Edge browser.<\/p>\n You can achieve this functionality by adding a secondary action to your app and enable users to launch them via a long press on your app icon, and click the secondary action shortcut.<\/p>\n Figure 5: Multi Instance app<\/span><\/p>\n Follow the Google Android guidance for App Shortcuts<\/a> and Handling the tasks stack<\/a>, and take a look at our code snippet below:<\/p>\n <\/p>\n Widgets<\/strong><\/p>\n You might already be supporting widgets today. If you aren\u2019t, now might be a good time to add it as widgets can allow more user engagement when on dual-screen devices.<\/p>\n In single screen phones, users typically unlock their device and perform a task such as launching an app or responding to a notification. In this flow, users are not spending too much time on the \u201chome screen\u201d engaging with widgets.<\/p>\n However, with dual-screen devices, when users unlock their device and launch an app, the other screen is still free and will show home screen content such as widgets.<\/p>\n To get started with widgets, follow the Google Android Guidance<\/a>.<\/p>\n Feedback?<\/strong><\/p>\n We would LOVE to hear from you about your experiences using the SDK, emulator, and your first thoughts on how you can utilize these in YOUR app.<\/p>\n Please reach out using our feedback forum<\/a> or direct message me on Twitter<\/a> or GitHub<\/a>.<\/p>\n Thank you,<\/p>\n Guy Merin, Development Manager, Surface Duo Developer Experience Team<\/p>\n","protected":false},"excerpt":{"rendered":" This blogpost details Step 2 in the journey to bring your app to Surface Duo. This blogpost details Step 2 in the journey to bring your app to Surface Duo.\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/03\/postures.jpg\")
<\/span><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/03\/DragAndDrop-1.gif\")
<\/p>\n\n
![\"Launch](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/03\/LaunchIntentAdjacent.gif\")
<\/p>\nIntent intent = new Intent(this, SecondActivity.class);\r\n\/\/ Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT is required to launch a second activity on a second display while still keeping the first activity on the first display(not pausing\/stopping it)\r\n\r\n\r\nintent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT | Intent.FLAG_ACTIVITY_NEW_TASK);\r\nstartActivity(intent);<\/pre>\n
![](\"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-content\/uploads\/sites\/53\/2020\/03\/word-image-3.png\")
<\/p>\n\/\/Add this code to your onCreate() method:\r\n\r\nIntent intent = new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, MainActivity.class);\r\nintent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);\r\n\r\nIntent intent2 = new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, SecondActivity.class);\r\nintent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);\r\n\r\n\r\nShortcutManager shortcutManager = getSystemService(ShortcutManager.class);\r\n\r\nShortcutInfo shortcut = new ShortcutInfo.Builder(this, \"id1\")\r\n.setShortLabel(\"New Instance\")\r\n.setLongLabel(\"New Instance\")\r\n.setIntent(intent)\r\n.build();\r\n\r\nShortcutInfo shortcut2 = new ShortcutInfo.Builder(this, \"id2\")\r\n.setShortLabel(\"Second Activity\")\r\n.setLongLabel(\"Second Activity\")\r\n.setIntent(intent2)\r\n.build();\r\n\r\nif (shortcutManager != null) {\r\nshortcutManager.setDynamicShortcuts(Arrays.asList(shortcut, shortcut2));\r\n}<\/pre>\n
\nThese will cover App resizing, Drag and drop support, how to launch intents in the adjacent screen, Multi instance\/Activities support, Widgets and Pen support<\/p>\n","protected":false},"author":17398,"featured_media":131,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[31,45,29,30],"class_list":["post-128","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-surface-duo-sdk","tag-dual-screen-development","tag-surface-duo-sdk","tag-surfaceduo","tag-surfaceduo-sdk"],"acf":[],"blog_post_summary":"
\nThese will cover App resizing, Drag and drop support, how to launch intents in the adjacent screen, Multi instance\/Activities support, Widgets and Pen support<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/posts\/128","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\/17398"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/comments?post=128"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/posts\/128\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/media\/131"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/media?parent=128"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/categories?post=128"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/surface-duo\/wp-json\/wp\/v2\/tags?post=128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}