1page.title=Tablet App Quality Checklist 2@jd:body 3 4<div id="qv-wrapper"><div id="qv"> 5<h2>Checklist</h2> 6<ol> 7 8<li><a href="#core-app-quality">1. Test for Basic Tablet App Quality</a></li> 9<li><a href="#optimize-layouts">2. Optimize your layouts</a></li> 10<li><a href="#use-extra-space">3. Use the extra screen area</a></li> 11<li><a href="#use-tablet-icons">4. Use assets designed for tablets</a></li> 12<li><a href="#adjust-font-sizes">5. Adjust fonts and touch targets</a></li> 13<li><a href="#adjust-widgets">6. Adjust homescreen widgets</a></li> 14<li><a href="#offer-full-feature-set">7. Offer the app's full feature set</a></li> 15<li><a href="#android-versions">8. Target Android versions properly</a></li> 16<li><a href="#hardware-requirements">9. Declare dependencies properly</a></li> 17<li><a href="#support-screens">10. Declare tablet screens support</a></li> 18<li><a href="#google-play">11. Showcase your tablet UI</a></li> 19<li><a href="#google-play-best-practices">12. Follow publishing best practices</a></li> 20 21</ol> 22<h2>Testing</h2> 23<ol> 24<li><a href="#test-environment">Setting Up a Test Environment</a></li> 25</ol> 26</div></div> 27 28<p>Before you publish an app on Google Play, it's important to make sure that 29the app meets the basic expectations of tablet users through compelling features 30and an intuitive, well-designed UI. </p> 31 32<p>Tablets are a growing part of the Android installed base that offers new 33opportunities for <a 34href="{@docRoot}distribute/googleplay/spotlight/tablets.html">user engagement 35and monetization</a>. If your app is targeting tablet users, this document helps 36you focus on key aspects of quality, feature set, and UI that can have a 37significant impact on the app's success. Each focus area is given as checklist 38item, with each one comprising several smaller tasks or best practices.</p> 39 40<p>Although the checklist tasks below are numbered for convenience, 41you can handle them in any order and address them to the extent that you feel 42is right for your app. In the interest of delivering the best possible product 43to your customers, follow the checklist recommendations 44to the greatest extent possible. </p> 45 46<p>As you move through the checklist, you'll find links to support resources 47that can help you address the topics raised in each task.</p> 48 49 50<h2 id="core-app-quality" style="margin-top:1.5em;">1. Test for basic tablet app quality</h2> 51 52<p>The first step in delivering a great tablet app experience is making sure 53that it meets the <em>core app quality criteria</em> for all of the devices 54and form factors that the app is targeting. For complete information, see the <a 55href="{@docRoot}distribute/googleplay/quality/core.html">Core App Quality Guidelines</a>. 56</p> 57 58<p> 59 Before publishing, also ensure that your app passes several basic 60 technical checks and launch criteria, such as: 61</p> 62 63<ul> 64 <li><a href="#android-versions">Targets appropriate Android versions</a></li> 65 <li><a href="#hardware-requirements">Specifies any hardware dependencies properly</a></li> 66 <li><a href="#support-screens">Declares support for appropriate screens</a></li> 67 <li><a href="#use-extra-space">Uses all of the available screen space</a></li> 68 <li><a href="#google-play">Screenshots are uploaded to Google Play</a></li> 69</ul> 70 71<p>If your app is already uploaded to the Google Play Developer Console, you 72 can see how it is doing against these checks 73 by visiting the <a href="#google-play-optimization-tips">Optimization 74 Tips page</a>.</p> 75 76 77<h2 id="optimize-layouts">2. Optimize your layouts for larger screens</h2> 78 79<p>Android makes it easy to develop an app that runs well on a wide range of 80device screen sizes and form factors. This broad compatibility works in your 81favor, since it helps you design a single app that you can distribute widely to 82all of your targeted devices. However, to give your users the best possible 83experience on each screen configuration — in particular on tablets 84— you need to optimize your layouts and other UI components for each 85targeted screen configuration. On tablets, optimizing your UI lets you take 86full advantage of the additional screen available, such as to offer new features, 87present new content, or enhance the experience in other ways to deepen user 88engagement.</p> 89 90<p>If you developed your app for handsets and now want to distribute it to 91tablets, you can start by making minor adjustments to your layouts, fonts, and 92spacing. In some cases — such as for 7-inch tablets or for a game with 93large canvas — these adjustments may be all 94you need to make your app look great. In other cases, such as for larger 95tablets, you can redesign parts of your UI to replace "stretched UI" with an 96efficient multipane UI, easier navigation, and additional content. </p> 97 98<p>Here are some suggestions:</p> 99 100<div style="width:390px;float:right;margin:1.5em;margin-top:0em;"> 101<img src="{@docRoot}images/training/app-navigation-multiple-sizes-multipane-bad.png" 102style="width:390px;padding:4px;margin-bottom:0em;"> 103<p class="image-caption" style="padding:0em .5em .5em 2em"><span 104style="font-weight:500;">Get rid of "stretched" UI</span>: On tablets, single-pane 105layouts lead to awkward whitespace and excessive line lengths. Use padding to 106reduce the width of UI elements and consider using multi-pane layouts.</p> 107</div> 108 109<ul> 110<li>Provide custom layouts as needed for <code>large</code> and 111<code>xlarge</code> screens. You can also provide layouts that are loaded based 112on the screen's <a href="{@docRoot}guide/practices/screens_support.html#NewQualifiers">shortest 113dimension</a> or the <a href="{@docRoot}guide/practices/screens_support.html#NewQualifiers">minimum 114available width and height</a>. </li> 115<li>At a minimum, customize dimensions such as font sizes, margins, spacing for 116larger screens, to improve use of space and content legibility. </li> 117<li>Adjust positioning of UI controls so that they are easily accessible to 118users when holding a tablet, such as toward the sides when in 119landscape orientation.</li> 120<li>Padding of UI elements should normally be larger on tablets than on handsets. A 121<a href="{@docRoot}design/style/metrics-grids.html#48dp-rhythm">48dp rhythm</a> (and a 16dp 122grid) is recommended.</li> 123<li>Adequately pad text content so that it is not aligned directly along screen edges. 124Use a minimum <code>16dp</code> padding around content near screen edges.</li> 125</ul> 126 127<p>In particular, make sure that your layouts do not appear "stretched" 128across the screen:</p> 129 130<ul> 131<li>Lines of text should not be excessively long — optimize for a maximum 132100 characters per line, with best results between 50 and 75.</li> 133<li>ListViews and menus should not use the full screen width.</li> 134<li>Use padding to manage the widths of onscreen elements or switch to a 135multi-pane UI for tablets (see next section).</li> 136</ul> 137 138<div class="rel-resources"> 139 <h3> 140 Related resources 141 </h3> 142 143 <ul> 144 <li> 145 <a href= 146 "{@docRoot}design/style/metrics-grids.html">Metrics 147 and Grids</a>—Android Design document that explains how to create 148 layouts based on density-independent grids. 149 </li> 150 151 <li> 152 <a href= 153 "{@docRoot}design/style/devices-displays.html">Devices 154 and Displays</a>—Android Design document that explains how to 155 design a UI that works well on different devices and 156 screen sizes. 157 </li> 158 159 <li> 160 <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 161 Screens</a>—Developer documentation that explains the details of 162 managing UI for best display on multiple screen sizes. 163 </li> 164 165 <li> 166 <a href= 167 "{@docRoot}guide/practices/screens_support.html#ConfigurationExamples"> 168 Configuration examples</a>—Examples of how to declare layouts and 169 other resources for specific screen sizes. 170 </li> 171 </ul> 172</div> 173 174 175<h2 id="use-extra-space">3. Take advantage of extra screen area available on tablets</h2> 176 177<div style="width:290px;float:right;margin:1.5em;margin-bottom:0;margin-top:0;"> 178<img src="{@docRoot}images/training/app-navigation-multiple-sizes-multipane-good.png" 179style="width:280px;padding:4px;margin-bottom:0em;"> 180<p class="image-caption" style="padding:0em .5em .5em 1.5em"><span 181style="font-weight:500;">Multi-pane layouts</span> result in a better visual 182balance on tablet screens, while offering more utility and legibility.</p> 183</div> 184 185<p>Tablet screens provide significantly more screen real estate to your app, 186especially when in landscape orientation. In particular, 10-inch tablets offer a 187greatly expanded area, but even 7-inch tablets give you more space for 188displaying content and engaging users. </p> 189 190<p>As you consider the UI of your app when running on tablets, make sure that it 191is taking full advantage of extra screen area available on tablets. Here are 192some suggestions:</p> 193 194<ul> 195<li>Look for opportunities to include additional content or use an alternative 196treatment of existing content.</li> 197<li>Use <a href="{@docRoot}design/patterns/multi-pane-layouts.html">multi-pane 198layouts</a> on tablet screens to combine single views into a compound view. This 199lets you use the additional screen area more efficiently and makes it easier for 200users to navigate your app. </li> 201<li>Plan how you want the panels of your compound views to reorganize when 202screen orientation changes.</li> 203 204<div style="width:490px;margin:1.5em auto 1.5em 0;"> 205<div style=""> 206<img src="{@docRoot}images/ui-ex-single-panes.png" 207style="width:490px;padding:4px;margin-bottom:0em;" align="middle"> 208<img src="{@docRoot}images/ui-ex-multi-pane.png" style="width:490px;padding:4px;margin-bottom:0em;"> 209<p class="image-caption" style="padding:.5em"><span 210style="font-weight:500;">Compound views</span> combine several single views from a 211handset UI <em>(above)</em> into a richer, more efficient UI for tablets 212<em>(below)</em>. </p> 213</div> 214</div> 215 216<li>While a single screen is implemented as an {@link android.app.Activity} 217subclass, consider implementing individual content panels as {@link 218android.app.Fragment} subclasses. This lets you 219maximize code reuse across different form factors and across screens that 220share content.</li> 221<li>Decide on which screen sizes you'll use a multi-pane UI, then provide the 222different layouts in the appropriate screen size buckets (such as 223<code>large</code>/<code>xlarge</code>) or minimum screen widths (such as 224<code>sw600dp</code>/<code>sw720</code>).</li> 225</ul> 226 227<div class="rel-resources"> 228 <h3> 229 Related resources 230 </h3> 231 232 <ul> 233 <li> 234 <a href="{@docRoot}design/patterns/multi-pane-layouts.html">Multi-pane 235 Layouts</a>—Android Design guide for using multi-pane UI, including 236 examples of how to flatten navigation and integrate more content into 237 your tablet UI. 238 </li> 239 240 <li> 241 <a href= 242 "{@docRoot}training/design-navigation/multiple-sizes.html">Planning for Multiple 243 Touchscreen Sizes</a>—Android Training class that walks you through 244 the essentials of planning an intuitive, effective navigation for tablets 245 and other devices. 246 </li> 247 248 <li> 249 <a href="{@docRoot}training/multiscreen/index.html">Designing for 250 Multiple Screens</a>—Android Training class that walks you through 251 the essentials of planning an intuitive, effective navigation for tablets 252 and other devices. 253 </li> 254 </ul> 255</div> 256 257 258<h2 id="use-tablet-icons">4. Use Icons and other assets that are designed 259for tablet screens</h2> 260 261<p>So that your app looks its best, make sure to use icons and other bitmap 262assets that are created specifically for the densities used by tablet screens. 263Specifically, you should create sets of alternative bitmap drawables for each 264density in the range commonly supported by tablets.</p> 265 266<p class="table-caption"><strong>Table 1</strong>. Raw asset sizes for icon types.<table> 267<tr> 268<th>Density </th> 269<th colspa>Launcher</th> 270<th>Action Bar</th> 271<th>Small/Contextual</th> 272<th>Notification</th> 273</tr> 274<tr> 275<td><code>mdpi</code></td> 276<td>48x48px</td> 277<td>32x32px</td> 278<td>16x16px</td> 279<td>24x24px</td> 280</tr> 281<tr> 282<td><code>hdpi</code></td> 283<td>72x72px</td> 284<td>48x48px</td> 285<td>24x24px</td> 286<td>36x36px</td> 287</tr> 288<tr> 289<td><code>tvdpi</code></td> 290<td><em>(use hdpi)</em></td> 291<td><em>(use hdpi)</em></td> 292<td><em>(use hdpi)</em></td> 293<td><em>(use hdpi)</em></td> 294</tr> 295<tr> 296<td><code>xhdpi</code></td> 297<td>96x96px</td> 298<td>64x64px</td> 299<td>32x32px</td> 300<td>48x48px</td> 301</tr> 302 303</table> 304 305<p>Other points to consider: </p> 306 307<ul> 308<li>Icons in the action bar, notifications, and launcher should be designed 309according to the icon design guidelines and have the same physical size on 310tablets as on phones.</li> 311<li>Use density-specific <a 312href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources"> 313resource qualifiers</a> to ensure that the proper set of alternative resources 314gets loaded.</li> 315</ul> 316 317<p style="margin-bottom:.5em;">At a minimum, your app should supply sets of 318 custom drawables and assets for common tablet screen densities, 319 tagged with these qualifiers as appropriate:</p> 320 321<ul> 322 <li><code>hdpi</code>, OR</li> 323 <li><code>xhdpi</code>, OR</li> 324 <li><code>xxhdpi</code></li> 325</ul> 326 327<div class="rel-resources"> 328 <h3> 329 Related resources 330 </h3> 331 332 <ul> 333 <li> 334 <a href="{@docRoot}design/style/iconography.html">Iconography</a>— Android 335 Design document that shows how to use various types of icons. 336 </li> 337 338 <li> 339 <a href= 340 "{@docRoot}guide/topics/resources/providing-resources.html">Providing 341 Resources</a>—Developer documentation on how to provide 342 sets of layouts and drawable resources for specific ranges of device 343 screens. 344 </li> 345 346 <li> 347 <a href="{@docRoot}guide/practices/screens_support.html">Supporting 348 Multiple Screens</a>—API Guide documentation that 349 explains the details of managing UI for best display on multiple screen 350 sizes. 351 </li> 352 353 <li> 354 <a href= 355 "{@docRoot}training/basics/supporting-devices/screens.html">Supporting Different 356 Screens</a>—Android Training class that takes you 357 through the process of optimizing the user experience for different 358 screen sizes and densities. 359 </li> 360 </ul> 361</div> 362 363 364<h2 id="adjust-font-sizes">5. Adjust font sizes and touch targets for tablet screens</h2> 365 366<p>To make sure your app is easy to use on tablets, take some time to adjust the 367font sizes and touch targets in your tablet UI, for all of the screen 368configurations you are targeting. You can adjust font sizes through <a 369href="{@docRoot}guide/topics/ui/themes.html">styleable attributes</a> or <a 370href="{@docRoot}guide/topics/resources/more-resources.html#Dimension">dimension 371resources</a>, and you can adjust touch targets through layouts and bitmap 372drawables, as discussed above. </p> 373 374<p>Here are some considerations:</p> 375<ul> 376<li>Text should not be excessively large or small on tablet screen sizes and 377densities. Make sure that labels are sized appropriately for the UI elements they 378correspond to, and ensure that there are no improper line breaks in labels, 379titles, and other elements.</li> 380<li>The recommended touch-target size for onscreen elements is 48dp (32dp 381minimum) — some adjustments may be needed in your tablet UI. Read <a 382href="{@docRoot}design/style/metrics-grids.html">Metrics and 383Grids 384</a> to learn about implementation strategies to help most of your users. To 385meet the accessibility needs of certain users, it may be appropriate to use 386larger touch targets. </li> 387<li>When possible, for smaller icons, expand the touchable area to more than 38848dp using {@link android.view.TouchDelegate} 389or just centering the icon within the transparent button.</li> 390</ul> 391 392<div class="rel-resources"> 393 <h3> 394 Related resources 395 </h3> 396 397 <ul> 398 <li> 399 <a href= 400 "{@docRoot}design/style/metrics-grids.html">Metrics 401 and Grids</a> —Android Design document that explains how to arrange 402 and size touch targets and other UI elements on the screen. 403 </li> 404 405 <li> 406 <a href="{@docRoot}design/style/typography.html">Typography</a>—Android 407 Design document that gives an overview of how to use typography in your 408 apps. 409 </li> 410 411 <li> 412 <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 413 Screens</a>—Developer documentation that explains the details of 414 managing UI for best display on multiple screen sizes. 415 </li> 416 417 <li> 418 <a href="{@docRoot}training/multiscreen/screendensities.html">Supporting 419 Different Densities</a>—Android Training class that shows you how 420 to provide sets of layouts and drawable resources for specific ranges of 421 device screens. 422 </li> 423 </ul> 424</div> 425 426 427<h2 id="adjust-widgets">6. Adjust sizes of home screen widgets for tablet screens</h2> 428 429<p>If your app includes a home screen widget, here are a few points to consider 430to ensure a great user experience on tablet screens: </p> 431 432<ul> 433<li>Make sure that the widget's default height and width are set appropriately 434for tablet screens, as well as the minimum and maximum resize height and width. 435</li> 436<li>The widget should be resizable to 420dp or more, to span 5 or more home 437screen rows (if this is a vertical or square widget) or columns (if this is a 438horizontal or square widget). </li> 439<li>Make sure that 9-patch images render correctly.</li> 440<li>Use default system margins.</li> 441<li>Set the app's <code>targetSdkVersion</code> to 14 or higher, if 442possible.</li> 443</ul> 444 445<div class="rel-resources"> 446 <h3> 447 Related resources 448 </h3> 449 450 <ul> 451 <li> 452 <a href="{@docRoot}guide/topics/appwidgets/index.html#MetaData">Adding the 453 AppWidgetProviderInfo Metadata</a> —API Guide that explains how to 454 set the height and width dimensions of a widget. 455 </li> 456 457 <li> 458 <a href="{@docRoot}guide/practices/ui_guidelines/widget_design.html">App Widget 459 Design Guidelines</a>—API Guide that provides best practices and 460 techniques for designing and managing the size of widgets. 461 </li> 462 </ul> 463</div> 464 465 466<h2 id="offer-full-feature-set">7. Offer the app's full feature set to tablet users</h2> 467 468<p>Let your tablet users experience the best features of your app. Here are 469some recommendations:</p> 470 471<ul> 472<li>Design your app to offer at least the same set of features on tablets as it does on 473handsets. </li> 474<li>In exceptional cases, your app might omit or replace certain features on 475tablets if they are not supported by the hardware or use-case of most tablets. 476For example: 477<ul> 478<li>If the handset uses telephony features but telephony is not available on the 479current tablet, you can omit or replace the related functionality.</li> 480<li>Many tablets have a GPS sensor, but most users would not normally carry 481their tablets while running. If your phone app provides functionality to let the 482user record a GPS track of their runs while carrying their phones, the app would not need to 483provide that functionality on tablets because the use-case is not 484compelling.</li> 485</ul> 486</li> 487<li>If you will omit a feature or capability from your tablet UI, make sure 488that it is not accessible to users or that it offers “graceful degradation” 489to a replacement feature (also see the section below on hardware features).</li> 490</ul> 491 492<h2 id="android-versions">8. Target Android versions properly</h2> 493 494<p>To ensure the broadest possible distribution to tablets, make sure that your 495app properly targets the Android versions that support tablets. Initial support for 496tablets was added in <a href="{@docRoot}about/versions/android-3.0">Android 3.0</a> (API level 11). Unified UI 497framework support for tablets, phones, and other devices was introduced in <a href="{@docRoot}about/versions/android-4.0">Android 4.0</a> (API level 14) and is supported in later versions. 498 499<p>You can set the app's 500range of targeted Android versions in the manifest file, in the 501<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code><uses-sdk></code></a> element. In most cases, you can target Android versions properly by setting the element's <code>targetSdkVersion</code> attribute to the highest API level available.</p> 502 503<p style="margin-bottom:.5em;">At a minimum, check the <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code><uses-sdk></code></a> 504 element to make sure that:</p> 505 506 <ol style="list-style-type:lower-alpha;margin-top:0em;"> 507 <li><code>targetSdkVersion</code> is declared with value 11 or higher (14 or higher is recommended), OR</li> 508 <li><code>minSdkVersion</code> is declared with value 11 or higher.</li> 509 <li>If a <code>maxSdkVersion</code> attribute is declared, it must have a value of 11 or higher. Note that, in general, the use of <code>maxSdkVersion</code> is <em>not recommended</em>.</li> 510</ol> 511 512<div class="rel-resources"> 513<h3> 514 Related resources 515</h3> 516 517<ul> 518 <li> 519 <a href= 520 "{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">Android API 521 Levels</a>—Introduces API levels and how they relate to compatibility. 522 A reference of available API levels is included. 523 </li> 524 <li> 525 <a href="{@docRoot}training/basics/supporting-devices/platforms.html">Supporting Different Platform Versions</a>—Training class showing how to declare support for 526 minimum and target API levels in your app. 527 </li> 528</ul> 529</div> 530 531<h2 id="hardware-requirements">9. Declare hardware feature dependencies properly</h2> 532 533<p> 534 Handsets and tablets typically offer slightly different hardware support for 535 sensors, camera, telephony, and other features. For example, many tablets are 536 available in a "Wi-Fi" configuration that does not include telephony support. 537</p> 538 539<p> 540 So that you can distribute a single APK broadly across your full customer 541 base of phones and tablets, make sure that your app doesn't declare 542 requirements for hardware features that aren't commonly available on tablets. 543 Instead, properly declare the hardware features as <em>not required</em> in the app 544 manifest, as described below. 545</p> 546 547<ul> 548<li>In your app manifest, locate any <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a> 549elements. In particular, look for hardware features that might not be 550available on some tablets, such as: 551 552<ul> 553<li><code>android.hardware.telephony</code></li> 554<li><code>android.hardware.camera</code> (refers to back camera), or</li> 555<li><code>android.hardware.camera.front</code></li> 556</ul></li> 557 558<li>Declare the <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a> 559elements as <em>not required</em> by including the <code>android:required=”false”</code> 560attribute. 561 562<p> 563 For example, here's the proper way to declare a dependency on 564 <code>android.hardware.telephony</code>, such that you can still 565 distribute the app broadly, even to devices that don't offer telephony: 566</p> 567 568<pre><uses-feature android:name="android.hardware.telephony" android:required="false" /></pre></li> 569 570<li>Similarly, check the manifest for <a href="/guide/topics/manifest/permission-element.html"><code><permission></code></a> elements that 571<a href="/guide/topics/manifest/uses-feature-element.html#permissions">imply hardware 572feature requirements</a> that not be appropriate for tablets. If you find such 573permissions, make sure to explicitly declare a corresponding 574<code><uses-feature></code> element for the features and includes the 575<code>android:required=”false”</code> attribute.</li> 576</ul> 577 578 579<p> 580 After declaring hardware features as <em>not required</em>, make sure to test 581 your app on a variety of devices. The app should function normally when the 582 hardware features it uses are not available, and it should offer "graceful 583 degradation" and alternative functionality where appropriate. 584</p> 585 586<p> 587 For example, if an app normally uses GPS to set the location but GPS is not 588 supported on the device, the app could let the user set the location manually 589 instead. The app can check for device hardware capabilities at runtime and handle 590 as needed. 591</p> 592 593<div class="rel-resources"> 594<h3> 595 Related resources 596</h3> 597 598<ul> 599 <li> 600 <a href= 601 "{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions">Permissions 602 that Imply Feature Requirements</a>—A list of permissions that may 603 cause unwanted filtering if declared in your app's manifest. 604 </li> 605 <li> 606 <a href= 607 "{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a>—Description 608 and reference documentation for the <code><uses-feature></code> 609 manifest element. 610 </li> 611 612 <li> 613 <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html#testing">Testing 614 the features required by your application</a>—Description of how to 615 determine the actual set of hardware and software requirements (explicit or 616 implied) that your app requires. 617 </li> 618</ul> 619</div> 620 621<h2 id="support-screens">10. Declare support for tablet screens</h2> 622 623<p>To ensure that you can distribute your app to a broad range of tablets, your app should 624declare support for tablet screen sizes in its manifest file, as follows:</p> 625 626<ul> 627 <li>A 628 <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html"><code><supports-screens></code></a> 629 element, if declared, must not specify <code>android:largeScreens="false"</code> 630 or <code>android:xlargeScreens="false"</code>.</li> 631 <li>For apps targeting <code>minSdkVersion</code> value less than 13, a 632 <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html"><code><supports-screens></code></a> 633 element must be declared with both <code>android:largeScreens="true"</code> and 634 <code>android:xlargeScreens="true"</code>.</li> 635</ul> 636 637<p>If the app declares a 638<a href="{@docRoot}guide/topics/manifest/compatible-screens-element.html"><code><compatible-screens></code></a> 639element in the manifest, the element should include attributes that specify 640<em>all of the size and density combinations for tablet screens</em> that the 641app supports. Note that, if possible, you should avoid using the 642<a href="{@docRoot}guide/topics/manifest/compatible-screens-element.html"><code><compatible-screens></code></a> 643element in your app.</p> 644 645<div class="rel-resources"> 646 <h3> 647 Related resources 648 </h3> 649 650 <ul> 651 <li> 652 <a href= 653 "{@docRoot}guide/practices/screens_support.html#DeclaringScreenSizeSupport">Declaring 654 Screen Size Support</a>—Developer documentation that explains the 655 details of managing UI for best display on multiple screen sizes. 656 </li> 657 </ul> 658</div> 659 660 661<h2 id="google-play">11. Showcase your tablet UI in Google Play</h2> 662 663<p> 664 After you've done the work to create an rich, optimized UI for your tablet 665 app, make sure that you let your customers know about it! Here are some key 666 ways to promote your tablet app to users on Google Play. 667</p> 668 669<h4> 670 Upload screenshots of your tablet UI 671</h4> 672 673<p> 674 Tablet users want to know what your app is like on a tablet device, not on a 675 phone. If you developed a tablet app, make sure to upload screenshots 676 of your tablet UI to the Google Play Developer Console. Here are some guidelines: 677 </p> 678 679<ul style="margin-top:0;"> 680 <li>Your screenshots should show the core functionality of your app, not a 681 startup or sign-in page. Wherever users will spend most of their time, that's 682 what you should show in your screenshots. 683 </li> 684 685 <li>Add screenshots taken on both 7-inch and 10-inch tablets. 686 </li> 687 688 <li>It's recommended that you add screenshots taken in both landscape and 689 portrait orientations, if possible. 690 </li> 691 692 <li>Use screen captures if possible. Avoid showing actual device hardware in your 693 screenshots.</li> 694 695 <li>The recommended resolution of your tablet screenshots is <strong>1280 x 720</strong> 696 or higher in each orientation. 697 </li> 698 699 <li>You can upload as many as 8 screenshots of your tablet UI for 7-inch tablets 700 and an additional 8 for 10-inch tablets. 701 </li> 702</ul> 703 704<h4> 705 Update your app description and release notes 706</h4> 707 708<ul> 709 <li>In your app description, make sure to highlight that your app offers 710 tablet-optimized UI and great features for tablet users. Consider adding some 711 detail about how your tablet UI works and why users will like it. 712 </li> 713 714 <li>Include information about tablet support in the app's release notes and 715 update information. 716 </li> 717</ul> 718 719<h4> 720 Update your promotional video 721</h4> 722 723<p> 724 Many users view an app's promotional video to get an idea of what the app is 725 like and whether they'll enjoy it. For tablet users, capitalize on this 726 interest by highlighting your app's tablet UI in your promotional video. Here 727 are some tips and guidelines: 728</p> 729 730<ul> 731 <li>Add one or more shots of your app running on a tablet. To engage with 732 tablet users most effectively, it's recommended that you promote your tablet 733 UI in approximately equal proportion to your phone UI. 734 </li> 735 736 <li>Show your tablet UI as early as possible in the video. Don't assume that 737 tablet users will wait patiently through a feature walkthrough on a phone UI. 738 Ideally, you should engage them immediately by showing the tablet UI within 739 the first 10 seconds, or at the same point that you introduce the phone UI. 740 </li> 741 742 <li>To make it clear that you are showing a tablet UI, include shots of your 743 app running on a hand-held tablet device. 744 </li> 745 746 <li>Highlight your app's tablet UI in the video's narrative or voiceover. 747 </li> 748</ul> 749 750<h4> 751 Feature your tablet UI in your promotional campaigns 752</h4> 753 754<p> 755 Make sure to let tablet users know about your tablet UI in your promotional 756 campaigns, web site, social posts, advertisements, and elsewhere. Here are 757 some suggestions: 758</p> 759 760<ul> 761 <li>Plan a marketing or advertising campaign that highlights the use of your 762 app on tablets.</li> 763 764 <li>Show your tablet app at its best in your promotional campaigns—use the <a href= 765 "{@docRoot}distribute/promote/device-art.html">Device Art Generator</a> to 766 quickly generate a high-quality promotional image of your app running on a 767 7-inch or 10-inch tablet, in the orientation of your choice, with or without 768 drop-shadow and screen glare. It's as simple as capture, drag, and drop. 769 </li> 770 771 <li>Include a Google Play badge in your online promotions to let users link 772 directly to your app's store listing. You can generate a badge in a variety 773 of languages using the <a href= 774 "{@docRoot}distribute/googleplay/promote/badges.html">Badge Generator</a>. 775 </li> 776</ul> 777 778<div class="rel-resources"> 779 <h3> 780 Related resources 781 </h3> 782 783 <ul> 784 <li> 785 <a href="{@docRoot}distribute/googleplay/publish/preparing.html">Publishing 786 Checklist</a> 787 —Recommendations on how to prepare your app for publishing, test 788 it, and launch successfully on Google Play. 789 </li> 790 791 <li> 792 <a href="https://play.google.com/apps/publish/">Google Play 793 Developer Console</a>—The tools console for publishing 794 your app to Android users. 795 </li> 796 <li> 797 <a href= 798 "{@docRoot}distribute/googleplay/promote/badges.html">Google Play 799 Badge Generator</a>—Create "Get it on Google Play" badges for your 800 app in a variety of languages with a single click. 801 </li> 802 <li> 803 <a href= 804 "{@docRoot}distribute/googleplay/promote/device-art.html">Device Art 805 Generator</a>—Drag and drop tool that lets you instantly create production- 806 ready art showing your app running on a tablet device. 807 </li> 808 </ul> 809</div> 810 811<h2 id="google-play-best-practices">12. Follow best practices for publishing in Google Play</h2> 812 813<p>Here are some best practices for delivering a successful tablet app on Google Play.</p> 814 815<h4 id="google-play-optimization-tips">Check out your app's Optimization Tips</h4> 816 817<p>The Google Play Developer Console now offers an Optimization Tips page that 818lets you quickly check how your app is doing against basic guidelines for tablet app 819distribution and quality. To visit the page, sign into the Developer Console, 820load the app from All Applications, and click Optimization Tips in 821the left navigation.</p> 822 823<div class="sidebox-wrapper"> 824<div class="sidebox"> 825<h2 style="line-height:1em;">How to send feedback</h2> 826 827<p>Please use the link below to send 828feedback or request a manual review of your Optimization Tips.</p> 829 830<p>Make sure to read the relevant sections of the Tablet App Quality 831Guidelines prior to sending feedback.</p> 832 833<p><strong><a href="https://support.google.com/googleplay/android-developer/contact/tabletq" 834target="_googleplay" style="white-space:nowrap">Designed for Tablets Contact Form »</a></strong></p> 835</div> 836</div> 837 838<p>The Developer Console creates your app's Optimization Tips page 839by running a series of checks to verify basic quality 840criteria. If it finds any issues, it alerts you to them as "To Do" 841items in the Optimization Tips page.</p> 842 843<p>If you've developed a tablet experience for your app, make sure 844to visit the Optimization Tips page to see how your app is doing 845against the basic checks. If there are any issues listed, we 846recommend addressing them in your app and uploading a new binary for 847distribution, if needed. </p> 848 849<p>If the Optimization Tips page lists "To Do" issues that you feel don't 850apply to your app or affect its quality on tablets, please notify us 851using the <a href="https://support.google.com/googleplay/android-developer/contact/tabletq" 852target="_googleplay" style="white-space:nowrap">Designed for Tablets Contact Form »</a>. We 853will review your app and update your Optimization Tips page as 854appropriate.</p> 855 856 857<h4>Confirm the app's filtering</h4> 858 859<p>After you've uploaded the app to the <a href="https://play.google.com/apps/publish/">Developer Console</a>, check the APK's Supported Devices list to make sure that the app is not filtered from tablet devices that you want to target.</p> 860 861<h4>Distribute as a single APK</h4> 862 863<p> 864 It's recommended that you publish your app as a single APK for all screen 865 sizes (phones and tablets), with a single Google Play listing. This approach 866 has several important advantages. 867</p> 868 869<ul style="margin-top:.25em;"> 870 <li>Easier for users to find your app from search, browsing, or promotions 871 </li> 872 873 <li>Easier for users to restore your app automatically if they get a new 874 device. 875 </li> 876 877 <li>Your ratings and download stats are consolidated across all devices. 878 </li> 879 880 <li>Publishing a tablet app in a second listing can dilute ratings for your 881 brand. 882 </li> 883</ul> 884 885<p> 886 If necessary, you can alternatively choose to deliver your app using <a href= 887 "{@docRoot}google/play/publishing/multiple-apks.html">Multiple APK Support</a>, 888 although in most cases using a single APK to reach all devices is strongly 889 recommended. 890</p> 891 892<div class="rel-resources"> 893<h3>Related resources</h3> 894<ul> 895<li><a href="{@docRoot}distribute/googleplay/publish/preparing.html">Publishing 896 Checklist</a>— 897 Recommendations on how to prepare your app for publishing, test it, and launch 898 successfully on Google Play.</li> 899<li><a href="https://play.google.com/apps/publish/">Google Play Developer 900 Console</a>—The tools console for publishing your app to Android users.</li> 901</ul> 902</div> 903 904 905<h2 id="test-environment">Setting Up a Test Environment for Tablets</h2> 906 907<p>To assess the quality of your app on tablets — both for core app quality 908and tablet app quality — you need to set up a suitable 909hardware or emulator environment for testing. </p> 910 911<p>The ideal test environment would 912include a small number of actual hardware devices that represent key form 913factors and hardware/software combinations currently available to consumers. 914It's not necessary to test on <em>every</em> device that's on the market — 915rather, you should focus on a small number of representative devices, even using 916one or two devices per form factor. The table below provides an overview of 917devices you could use for testing.</p> 918 919<p>If you are not able to obtain actual hardware devices for testing, you should 920<a href="{@docRoot}tools/devices/index.html">set up emulated devices (AVDs)</a> 921to represent the most common form factors and 922hardware/software combinations. See the table below for suggestions on the emulator 923configurations to use. </p> 924 925<p>To go beyond basic testing, you can add more devices, more form factors, or 926new hardware/software combinations to your test environment. For example, you 927could include mid-size tablets, tablets with more or fewer hardware/software 928features, and so on. You can also increase the number or complexity of tests 929and quality criteria. </p> 930 931<p class="table-caption"><strong>Table 1</strong>. A typical tablet test environment might 932include one or two devices from each row in the table below, with one of the 933listed platform versions, screen configurations, and hardware feature configurations.</p> 934 935<table> 936<tr> 937<th>Type</th> 938<th>Size</th> 939<th>Density</th> 940<th>Version</th> 941<th>AVD Skin</th> 942</tr> 943 944<tr> 945<td>7-inch tablet</td> 946<td><span style="white-space:nowrap"><code>large</code> or</span><br /><code>-sw600</code></td> 947<td><code>hdpi</code>,<br /><code>tvdpi</code></td> 948<td>Android 4.0+ (API level 14 and higher)</td> 949<td>WXGA800-7in</td> 950</tr> 951<tr> 952<td><span style="white-space:nowrap">10-inch</span> tablet</td> 953<td><span style="white-space:nowrap"><code>xlarge</code> or</span><br /><code>-sw800</code></td> 954<td><code>mdpi</code>,<br /><code>hdpi</code>,<br /><code>xhdpi</code></td> 955<td>Android 3.2+ (API level 13 and higher)</td> 956<td>WXGA800</td> 957</tr> 958</table>