171d4b289a7a934ecd16c3036b812d40db6d3a74dScott Mainpage.title=<supports-screens> 22a1b706ec11e53689a2f86cc8e558e74591b462aScott Mainparent.title=The AndroidManifest.xml File 32a1b706ec11e53689a2f86cc8e558e74591b462aScott Mainparent.link=manifest-intro.html 471d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main@jd:body 571d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 671d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dl class="xml"> 771d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 871d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>syntax:</dt> 971d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dd> 1071d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<pre class="stx"> 11db909162b2c26d12f56a7c0615977b83578c4acfScott Main<supports-screens android:<a href="#resizeable">resizeable</a>=["true"| "false"] 129a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main android:<a href="#small">smallScreens</a>=["true" | "false"] 139a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main android:<a href="#normal">normalScreens</a>=["true" | "false"] 149a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main android:<a href="#large">largeScreens</a>=["true" | "false"] 1577d6fcff7b97b53d7bf15557e117d32b95c21f63Scott Main android:<a href="#xlarge">xlargeScreens</a>=["true" | "false"] 16db909162b2c26d12f56a7c0615977b83578c4acfScott Main android:<a href="#any">anyDensity</a>=["true" | "false"] 17db909162b2c26d12f56a7c0615977b83578c4acfScott Main android:<a href="#requiresSmallest">requiresSmallestWidthDp</a>="<em>integer</em>" 18db909162b2c26d12f56a7c0615977b83578c4acfScott Main android:<a href="#compatibleWidth">compatibleWidthLimitDp</a>="<em>integer</em>" 19db909162b2c26d12f56a7c0615977b83578c4acfScott Main android:<a href="#largestWidth">largestWidthLimitDp</a>="<em>integer</em>"/> 2071d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main</pre> 2171d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main</dd> 2271d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 2371d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>contained in:</dt> 2471d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> 2571d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 2671d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>description:</dt> 273155825c256b150cfa635ad27ac7a2bab76371b0Dirk Dougherty<dd itemprop="description">Lets you specify the screen sizes your application supports and enable <a 28db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screen-compat-mode.html">screen compatibility mode</a> for screens 29db909162b2c26d12f56a7c0615977b83578c4acfScott Mainlarger than what your application supports. It's important that you always use this element in your 30db909162b2c26d12f56a7c0615977b83578c4acfScott Mainapplication to specify the screen sizes your application supports. 319a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main 329a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<p>An application "supports" a given screen size if it resizes properly to fill the entire screen. 33db909162b2c26d12f56a7c0615977b83578c4acfScott MainNormal resizing applied by the system works well for most applications and you don't have to do any 34db909162b2c26d12f56a7c0615977b83578c4acfScott Mainextra work to make your application work on screens larger than a handset device. However, it's 35db909162b2c26d12f56a7c0615977b83578c4acfScott Mainoften important that you optimize your application's UI for different screen sizes by providing <a 361b6dd05927bf381f8a912447dfb79f49b60b9d03Scott Mainhref="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">alternative 37db909162b2c26d12f56a7c0615977b83578c4acfScott Mainlayout resources</a>. For instance, you might want to modify the layout of an activity 38db909162b2c26d12f56a7c0615977b83578c4acfScott Mainwhen it is on a tablet compared to when running on a handset device.</p> 39db909162b2c26d12f56a7c0615977b83578c4acfScott Main 40db909162b2c26d12f56a7c0615977b83578c4acfScott Main<p>However, if your application does not work well when resized to fit different screen sizes, you 41db909162b2c26d12f56a7c0615977b83578c4acfScott Maincan use the attributes of the {@code <supports-screens>} element to control whether your 42db909162b2c26d12f56a7c0615977b83578c4acfScott Mainapplication should be distributed to smaller screens or have its UI scaled up ("zoomed") to fit 43db909162b2c26d12f56a7c0615977b83578c4acfScott Mainlarger screens using the system's <a 44db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screen-compat-mode.html">screen compatibility mode</a>. When you 45db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhave not designed for larger screen sizes and the normal resizing does not achieve the appropriate 46db909162b2c26d12f56a7c0615977b83578c4acfScott Mainresults, screen compatibility mode will scale your UI by emulating a <em>normal</em> size 47db909162b2c26d12f56a7c0615977b83578c4acfScott Mainscreen and medium density, then zooming in so that it fills the entire screen. Beware that this 48db909162b2c26d12f56a7c0615977b83578c4acfScott Maincauses pixelation and blurring of your UI, so it's better if you optimize your UI for large 49db909162b2c26d12f56a7c0615977b83578c4acfScott Mainscreens.</p> 50db909162b2c26d12f56a7c0615977b83578c4acfScott Main 51db909162b2c26d12f56a7c0615977b83578c4acfScott Main<p class="note"><strong>Note:</strong> Android 3.2 introduces new attributes: {@code 52db909162b2c26d12f56a7c0615977b83578c4acfScott Mainandroid:requiresSmallestWidthDp}, {@code android:compatibleWidthLimitDp}, and {@code 53db909162b2c26d12f56a7c0615977b83578c4acfScott Mainandroid:largestWidthLimitDp}. If you're developing your application for Android 3.2 and higher, 54db909162b2c26d12f56a7c0615977b83578c4acfScott Mainyou should use these attributes to declare your screen size support, instead of the attributes 55db909162b2c26d12f56a7c0615977b83578c4acfScott Mainbased on generalized screen sizes.</p> 569a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main 579a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<p>For more information about how to properly support different screen sizes so that you can avoid 58db909162b2c26d12f56a7c0615977b83578c4acfScott Mainusing screen compatibility mode with your application, read 5977d6fcff7b97b53d7bf15557e117d32b95c21f63Scott Main<a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple Screens</a>.</p> 6071d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 6171d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 6271d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>attributes:</dt> 6371d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 6471d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dd> 651b6dd05927bf381f8a912447dfb79f49b60b9d03Scott Main<dl class="attr"> 66db909162b2c26d12f56a7c0615977b83578c4acfScott Main 67db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="resizeable"></a>{@code android:resizeable}</dt> 68db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether the application is resizeable for different screen sizes. This attribute is 69db909162b2c26d12f56a7c0615977b83578c4acfScott Maintrue, by default. If set false, the system will run your application in <a 70db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screen-compat-mode.html">screen compatibility mode</a> on large 71db909162b2c26d12f56a7c0615977b83578c4acfScott Mainscreens.</p> 72db909162b2c26d12f56a7c0615977b83578c4acfScott Main 73db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p><strong>This attribute is deprecated</strong>. It was introduced to help applications 74db909162b2c26d12f56a7c0615977b83578c4acfScott Maintransition from Android 1.5 to 1.6, when support for multiple screens was first introduced. You 75db909162b2c26d12f56a7c0615977b83578c4acfScott Mainshould not use it.</p> 76db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 77db909162b2c26d12f56a7c0615977b83578c4acfScott Main 78db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="small"></a>{@code android:smallScreens}</dt> 79db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether the application supports smaller screen form-factors. 80db909162b2c26d12f56a7c0615977b83578c4acfScott Main A small screen is defined as one with a smaller aspect ratio than 81db909162b2c26d12f56a7c0615977b83578c4acfScott Main the "normal" (traditional HVGA) screen. An application that does 82db909162b2c26d12f56a7c0615977b83578c4acfScott Main not support small screens <em>will not be available</em> for 834d7bc65538c7cd9fbb1fbbcf22d1da47fcee1219Dirk Dougherty small screen devices from external services (such as Google Play), because there is little 84db909162b2c26d12f56a7c0615977b83578c4acfScott Mainthe platform can do to make such an application work on a smaller screen. This is {@code "true"} by 85db909162b2c26d12f56a7c0615977b83578c4acfScott Maindefault. 86db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 87db909162b2c26d12f56a7c0615977b83578c4acfScott Main 88db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="normal"></a>{@code android:normalScreens}</dt> 89db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether an application supports the "normal" screen 90db909162b2c26d12f56a7c0615977b83578c4acfScott Main form-factors. Traditionally this is an HVGA medium density 91db909162b2c26d12f56a7c0615977b83578c4acfScott Main screen, but WQVGA low density and WVGA high density are also 92db909162b2c26d12f56a7c0615977b83578c4acfScott Main considered to be normal. This attribute is "true" by default. 93db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 94db909162b2c26d12f56a7c0615977b83578c4acfScott Main 95db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="large"></a>{@code android:largeScreens}</dt> 96db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether the application supports larger screen form-factors. 97db909162b2c26d12f56a7c0615977b83578c4acfScott Main A large screen is defined as a screen that is significantly larger 98db909162b2c26d12f56a7c0615977b83578c4acfScott Main than a "normal" handset screen, and thus might require some special care 99db909162b2c26d12f56a7c0615977b83578c4acfScott Main on the application's part to make good use of it, though it may rely on resizing by the 100db909162b2c26d12f56a7c0615977b83578c4acfScott Mainsystem to fill the screen. 101db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p>The default value for this actually varies between some versions, so it's better if 102db909162b2c26d12f56a7c0615977b83578c4acfScott Mainyou explicitly declare this attribute at all times. Beware that setting it "false" will 103db909162b2c26d12f56a7c0615977b83578c4acfScott Maingenerally enable <a href="{@docRoot}guide/practices/screen-compat-mode.html">screen 104db909162b2c26d12f56a7c0615977b83578c4acfScott Maincompatibility mode</a>.</p> 105db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 106db909162b2c26d12f56a7c0615977b83578c4acfScott Main 107db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="xlarge"></a>{@code android:xlargeScreens}</dt> 108db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether the application supports extra large screen form-factors. 109db909162b2c26d12f56a7c0615977b83578c4acfScott Main An xlarge screen is defined as a screen that is significantly larger 110db909162b2c26d12f56a7c0615977b83578c4acfScott Main than a "large" screen, such as a tablet (or something larger) and may require special care 111db909162b2c26d12f56a7c0615977b83578c4acfScott Main on the application's part to make good use of it, though it may rely on resizing by the 112db909162b2c26d12f56a7c0615977b83578c4acfScott Mainsystem to fill the screen. 113db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p>The default value for this actually varies between some versions, so it's better if 114db909162b2c26d12f56a7c0615977b83578c4acfScott Mainyou explicitly declare this attribute at all times. Beware that setting it "false" will 115db909162b2c26d12f56a7c0615977b83578c4acfScott Maingenerally enable <a href="{@docRoot}guide/practices/screen-compat-mode.html">screen 116db909162b2c26d12f56a7c0615977b83578c4acfScott Maincompatibility mode</a>.</p> 117db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p>This attribute was introduced in API level 9.</p> 118db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 119db909162b2c26d12f56a7c0615977b83578c4acfScott Main 120db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dt><a name="any"></a>{@code android:anyDensity}</dt> 121db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>Indicates whether the application includes resources to accommodate any screen 122db909162b2c26d12f56a7c0615977b83578c4acfScott Main density. 123db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p>For applications that support Android 1.6 (API level 4) and higher, this is "true" 124db909162b2c26d12f56a7c0615977b83578c4acfScott Mainby default and <strong>you should not set it "false"</strong> unless you're absolutely certain that 125db909162b2c26d12f56a7c0615977b83578c4acfScott Mainit's necessary for your application to work. The only time it might be necessary to disable this 126db909162b2c26d12f56a7c0615977b83578c4acfScott Mainis if your app directly manipulates bitmaps (see the <a 127db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screens_support.html#DensityConsiderations">Supporting Multiple 128db909162b2c26d12f56a7c0615977b83578c4acfScott MainScreens</a> document for more information).</p> 129db909162b2c26d12f56a7c0615977b83578c4acfScott Main </dd> 1301b6dd05927bf381f8a912447dfb79f49b60b9d03Scott Main 1319a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <dt id="requiresSmallest">{@code android:requiresSmallestWidthDp}</dt> 132759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main <dd>Specifies the minimum smallestWidth required. The smallestWidth is the shortest dimension of 133759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainthe screen space (in {@code dp} units) that must be available to your application UI—that is, 134759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainthe shortest of the available screen's two dimensions. So, in order for a device to be considered 135759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Maincompatible with your application, the device's smallestWidth must be equal to or greater than this 136759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainvalue. (Usually, the value you supply for this is the "smallest width" that your layout supports, 137759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainregardless of the screen's current orientation.) 138759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main 139759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main <p>For example, a typical handset screen has a smallestWidth of 320dp, a 7" tablet has a 140759c89322548dd88b35a3f3b4b5e636c515bbc57Scott MainsmallestWidth of 600dp, and a 10" tablet has a smallestWidth of 720dp. These values are generally 141759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainthe smallestWidth because they are the shortest dimension of the screen's available space.</p> 142759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main 143759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main<p>The size against which your value is compared takes into account screen decorations and system 144759c89322548dd88b35a3f3b4b5e636c515bbc57Scott MainUI. For example, if the device has some persistent UI elements on the display, the system declares 145759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainthe device's smallestWidth as one that is smaller than the actual screen size, accounting for these 146759c89322548dd88b35a3f3b4b5e636c515bbc57Scott MainUI elements because those are screen pixels not available for your UI. Thus, the value you use 147759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainshould be the minimum width required by your layout, regardless of the screen's current 148759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainorientation.</p> 149db909162b2c26d12f56a7c0615977b83578c4acfScott Main 1509a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<p>If your application properly resizes for smaller screen sizes (down to the 1519a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<em>small</em> size or a minimum width of 320dp), you do 1529a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainnot need to use this attribute. Otherwise, you should use a value for this attribute that 1539a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainmatches the smallest value used by your application for the <a 1549a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainhref="{@docRoot}guide/topics/resources/providing-resources.html#SmallestScreenWidthQualifier"> 1559a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainsmallest screen width qualifier</a> ({@code sw<N>dp}).</p> 1569a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main 157759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main <p class="caution"><strong>Caution:</strong> The Android system does not pay attention to this 158759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainattribute, so it does not affect how your application behaves at runtime. Instead, it is used 1594d7bc65538c7cd9fbb1fbbcf22d1da47fcee1219Dirk Doughertyto enable filtering for your application on services such as Google Play. However, 1604d7bc65538c7cd9fbb1fbbcf22d1da47fcee1219Dirk Dougherty<strong>Google Play currently does not support this attribute for filtering</strong> (on Android 161759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main3.2), so you should continue using the other size attributes if your application does not support 162759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Mainsmall screens.</p> 163759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main 164759c89322548dd88b35a3f3b4b5e636c515bbc57Scott Main<!-- 1659a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<p>Beginning with Android 3.2 (API level 13), using this attribute is the preferred way to 1669a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainspecify the minimum screen size your application requires, instead of using the other attributes 1679a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainfor small, normal, large, and xlarge screens. The advantage of using this attribute is that you 1689a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainhave more control over exactly how much screen space your application needs at a minimum in order 1699a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainto properly display its UI, rather than relying on the generalized size groups.</p> 1709a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<p>This attribute has no default value. If this attribute is not specified, then any of the old 1719a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<code><a href="#small">smallScreens</a></code>, <code><a href="#normal">normalScreens</a></code>, 1729a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main<code><a href="#large">largeScreens</a></code>, or <code><a href="#xlarge">xlargeScreens</a></code> 1739a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainattributes are used instead to determine the smallest screen required.</p> 174db909162b2c26d12f56a7c0615977b83578c4acfScott Main--> 1759a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <p>This attribute was introduced in API level 13.</p> 1769a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main </dd> 1779a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main 1789a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <dt id="compatibleWidth">{@code android:compatibleWidthLimitDp}</dt> 179db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>This attribute allows you to enable <a 180db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screen-compat-mode.html">screen compatibility mode</a> as a 181db909162b2c26d12f56a7c0615977b83578c4acfScott Mainuser-optional feature by specifying the maximum "smallest screen width" for which your application 182db909162b2c26d12f56a7c0615977b83578c4acfScott Mainis designed. If the smallest side of a device's available screen is greater than your value here, 183db909162b2c26d12f56a7c0615977b83578c4acfScott Mainusers can still install your application, but are offered to run it in screen compatibility mode. By 184db909162b2c26d12f56a7c0615977b83578c4acfScott Maindefault, screen compatibility mode is disabled and your layout is resized to fit the screen as 185db909162b2c26d12f56a7c0615977b83578c4acfScott Mainusual, but a button is available in the system bar that allows the user to toggle screen 186db909162b2c26d12f56a7c0615977b83578c4acfScott Maincompatibility mode on and off. 1879a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <p>If your application is compatible with all screen sizes and its layout properly resizes, you do 1889a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainnot need to use this attribute.</p> 189db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p class="note"><strong>Note:</strong> Currently, screen compatibility mode emulates only handset 1909a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainscreens with a 320dp width, so screen compatibility mode is not applied if your value for {@code 1919a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainandroid:compatibleWidthLimitDp} is larger than 320.</p> 1929a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <p>This attribute was introduced in API level 13.</p> 1939a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main </dd> 1949a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main 1959a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <dt id="largestWidth">{@code android:largestWidthLimitDp}</dt> 196db909162b2c26d12f56a7c0615977b83578c4acfScott Main <dd>This attribute allows you to force-enable <a 197db909162b2c26d12f56a7c0615977b83578c4acfScott Mainhref="{@docRoot}guide/practices/screen-compat-mode.html">screen compatibility mode</a> by specifying 198db909162b2c26d12f56a7c0615977b83578c4acfScott Mainthe maximum "smallest screen width" for which your application is designed. If the smallest side of 199db909162b2c26d12f56a7c0615977b83578c4acfScott Maina device's available screen is greater than your value here, the application runs in screen 2009a05cfe5427a6cee988333e0d65f17b9854554a3Scott Maincompatibility mode with no way for the user to disable it. 2019a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <p>If your application is compatible with all screen sizes and its layout properly resizes, you do 2029a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainnot need to use this attribute. Otherwise, you should first consider using the <a 2039a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainhref="#compatibleWidth">{@code android:compatibleWidthLimitDp}</a> attribute. You should use the 2049a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main{@code android:largestWidthLimitDp} attribute only when your application is functionally broken when 2059a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainresized for larger screens and screen compatibility mode is the only way that users should use 2069a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainyour application.</p> 207db909162b2c26d12f56a7c0615977b83578c4acfScott Main <p class="note"><strong>Note:</strong> Currently, screen compatibility mode emulates only handset 2089a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainscreens with a 320dp width, so screen compatibility mode is not applied if your value for {@code 2099a05cfe5427a6cee988333e0d65f17b9854554a3Scott Mainandroid:largestWidthLimitDp} is larger than 320.</p> 2109a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main <p>This attribute was introduced in API level 13.</p> 2119a05cfe5427a6cee988333e0d65f17b9854554a3Scott Main </dd> 21271d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 21371d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 21471d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main</dl></dd> 21571d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 21671d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<!-- ##api level indication## --> 21771d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>introduced in:</dt> 21871d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dd>API Level 4</dd> 21971d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 22071d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dt>see also:</dt> 22171d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main<dd> 22271d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main <ul> 22377d6fcff7b97b53d7bf15557e117d32b95c21f63Scott Main <li><a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 22477d6fcff7b97b53d7bf15557e117d32b95c21f63Scott MainScreens</a></li> 22571d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main <li>{@link android.util.DisplayMetrics}</li> 22671d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main </ul> 22771d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main</dd> 22871d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main 22971d4b289a7a934ecd16c3036b812d40db6d3a74dScott Main</dl> 230