Merge "docs: add guide for optimizing tablet apps for handsets deprecate...

          </a></li>

          </a></li>

        </ul>

        </ul>

      </li>

      </li>

      <li><a href="<?cs var:toroot ?>guide/practices/optimizing-for-3.0.html">

      <li><a href="<?cs var:toroot ?>guide/practices/tablets-and-handsets.html">

            <span class="en">Optimizing Apps for Android 3.0</span>

            <span class="en">Supporting Tablets and Handsets</span>

          </a></li>

          </a> <span class="new">new!</span></li>

      <li class="toggle-list">

      <li class="toggle-list">

        <div><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/index.html">

        <div><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/index.html">

               <span class="en">UI Guidelines</span>

               <span class="en">UI Guidelines</span>

page.title=Optimizing Apps for Android 3.0

page.title=Optimizing Apps for Android 3.0

@jd:body

@jd:body

<div id="deprecatedSticker">

  <a href="#" 

     onclick="$('#naMessage').show();$('#deprecatedSticker').hide();return false">

    <strong>This doc is deprecated</strong></a>

</div>

<div id="naMessage" style="display:block">

<div><p><strong>This document has been deprecated.</strong></p>

 <p>To learn about how you can  optimize your app for both tablets and handsets, please

read the guide to <a href="tablets-and-handsets.html">Supporting Tablets and

Handsets</a>.</p>

 <input style="margin-top:1em;padding:5px" type="button"

        value="That's nice, but I still want to read this document"

onclick="$('#naMessage').hide();$('#deprecatedSticker').show()" />

</div>

</div>

<div id="qv-wrapper">

<div id="qv-wrapper">

<div id="qv">

<div id="qv">

<h2>In this document</h2>

<h2>In this document</h2>

<h2>See also</h2>

<h2>See also</h2>

<ol>

<ol>

  <li><a href="tablets-and-handsets.html">Supporting Tablets

and Handsets</a></li>

  <li><a

  <li><a

href="{@docRoot}sdk/compatibility-library.html">Compatibility Library</a></li>

href="{@docRoot}sdk/compatibility-library.html">Compatibility Library</a></li>

  <li><a href="http://code.google.com/p/iosched/">Google I/O App source code</a></li>

  <li><a href="http://code.google.com/p/iosched/">Google I/O App source code</a></li>

  <h2>In this document</h2>

  <h2>In this document</h2>

  <ol>

  <ol>

    <li><a href="#FilteringHansetApps">Filtering a Handset Application from Tablets</a></li>

    <li><a href="#FilteringHansetApps">Declaring an App is Only for Handsets</a></li>

    <li><a href="#FilteringTabletApps">Filtering a Tablet Application from Handsets</a></li>

    <li><a href="#FilteringTabletApps">Declaring an App is Only for Tablets</a></li>

    <li><a href="#MultiApks">Publishing Multiple APKs for Different Screens</a></li>

    <li><a href="#MultiApks">Publishing Multiple APKs for Different Screens</a></li>

  </ol>

  </ol>

<h2 id="FilteringHandsetApps">Filtering a Handset Application from Tablets</h2>

<h2 id="FilteringHandsetApps">Declaring an App is Only for Handsets</h2>

<p>Because the system generally scales applications to fit larger screens well, you shouldn't

<p>Because the system generally scales applications to fit larger screens well, you shouldn't

need to filter your application from larger screens. As long as you follow the <a

need to filter your application from larger screens. As long as you follow the <a

<pre>

<pre>

<manifest ... >

<manifest ... >

    ...

    <compatible-screens>

    <compatible-screens>

        <!-- all small size screens -->

        <!-- all small size screens -->

        <screen android:screenSize="small" android:screenDensity="ldpi" />

        <screen android:screenSize="small" android:screenDensity="ldpi" />

        <screen android:screenSize="normal" android:screenDensity="hdpi" />

        <screen android:screenSize="normal" android:screenDensity="hdpi" />

        <screen android:screenSize="normal" android:screenDensity="xhdpi" />

        <screen android:screenSize="normal" android:screenDensity="xhdpi" />

    </compatible-screens>

    </compatible-screens>

    ...

    <application ... >

    <application ... >

        ...

        ...

    <application>

    <application>

<h2 id="FilteringTabletApps">Filtering a Tablet Application from Handsets</h2>

<p>If your application's UI is adversely affected when the system scales your application down to

<h2 id="FilteringTabletApps">Declaring an App is Only for Tablets</h2>

smaller screens, you should add <a

href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">alternative

<p>If you don't want your app to be used on handsets (perhaps your app truly makes sense only on a

layouts</a> for smaller screens to adjust the layout for those screens. However, sometimes your

large screen) or you need time to optimize it for smaller screens, you can prevent small-screen

layout still might not fit a smaller screen or you've explicitly designed your application only for

devices from downloading your app by using the <a

tablets and other large devices. In this case, you can manage the availability of your application

to smaller screens by using the <a

href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code

href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code

&lt;supports-screens>}</a> manifest element.</p>

&lt;supports-screens>}</a> manifest element.</p>

<p>For example, if you want your application to be available only to large and extra large

<p>For example, if you want your application to be available only to tablet devices, you can declare

screens, you can declare the element in your manifest like this:</p>

the element in your manifest like this:</p>

<pre>

<pre>

<manifest ... >

<manifest ... >

    ...

    <supports-screens android:smallScreens="false"

    <supports-screens android:smallScreens="false"

                      android:normalScreens="false"

                      android:normalScreens="false"

                      android:largeScreens="true"

                      android:largeScreens="true"

                      android:xlargeScreens="true" />

                      android:xlargeScreens="true"

                      android:requiresSmallestWidthDp="600" />

    ...

    <application ... >

    <application ... >

        ...

        ...

    <application>

    </application>

</manifest>

</manifest>

</pre>

</pre>

<p>External services such as Android Market read this manifest element and use it to ensure that

<p>This describes your app's screen-size support in two different ways:</p>

your application is available only to devices with either a large or an extra large screen.</p>

<ul>

  <li>It declares that the app does <em>not</em> support the screen sizes "small" and

"normal", which are traditionally not tablets.</li>

  <li>It declares that the app requires a screen size with a minimum usable area that is at least

600dp wide.</li>

</ul>

<p>The first technique is for devices that are running Android 3.1 or older, because those devices

declare their size based on generalized screen sizes. The <a

href="{@docRoot}guide/topics/manifest/supports-screens-element.html#requiresSmallest">{@code

requiresSmallestWidthDp}</a> attribute is for devices running Android 3.2 and newer, which includes

the capability for apps to specify size requirements based on a minimum number of

density-independent pixels available.  In this example, the app declares a minimum width requirement

of 600dp, which generally implies a 7"-or-greater screen. </p>

<p>Your size choice might be different, of course, based on how well your design works on different

screen sizes; for example, if your design works well only on screens that are 9" or larger, you

might require a minimum width of 720dp.</p>

<p>The catch is that you must compile your application against Android 3.2 or higher in order to use

the <code>requiresSmallestWidthDp</code> attribute. Older versions don't understand this attribute

and will raise a compile-time error. The safest thing to do is develop your app against the platform

that matches the API level you've set for <a

href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">minSdkVersion</a

>. When you're making final preparations to build your release candidate, change the build target to

Android 3.2 and add the <code>requiresSmallestWidthDp</code> attribute. Android versions older than

3.2 simply ignore that XML attribute, so there's no risk of a runtime failure.</p>

<p>For more information about why the "smallest width" screen size is

important for supporting different screen sizes, read <a

href="http://android-developers.blogspot.com/2011/07/new-tools-for-managing-screen-sizes.html">New

Tools for Managing Screen Sizes</a>.</p>

<p class="caution"><strong>Caution:</strong> If you use the <a

<p class="caution"><strong>Caution:</strong> If you use the <a

href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code

href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code

to prevent your application from being downloaded on larger screens, use <a

to prevent your application from being downloaded on larger screens, use <a

href="{@docRoot}guide/topics/manifest/compatible-screens-element.html">{@code

href="{@docRoot}guide/topics/manifest/compatible-screens-element.html">{@code

&lt;compatible-screens>}</a>, as discussed in the previous section about <a

&lt;compatible-screens>}</a>, as discussed in the previous section about <a

href="#FilteringHandsetApps">Filtering a Handset Application from Tablets</a>.</p>

href="#FilteringHandsetApps">Declaring an App is Only for Handsets</a>.</p>

<p>Remember, you should strive to make your application available to as many devices as possible by

<p>Remember, you should strive to make your application available to as many devices as possible by

applying all necessary techniques for <a

applying all necessary techniques for <a

  <h2>See also</h2>

  <h2>See also</h2>

  <ol>

  <ol>

    <li><a

    <li><a

href="http://android-developers.blogspot.com/2011/09/thinking-like-web-designer.html">Thinking

Like a Web Designer</a></li>

    <li><a

href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">

href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">

Providing Alternative Resources</a></li>

Providing Alternative Resources</a></li>

    <li><a href="{@docRoot}guide/practices/ui_guidelines/icon_design.html">Icon Design

    <li><a href="{@docRoot}guide/practices/ui_guidelines/icon_design.html">Icon Design